burlesco/README.md

69 lines
2.3 KiB
Markdown
Raw Normal View History

<p align="center">
<a href="https://burles.co">
<img width="533" src="cover.png">
</a>
</p>
2016-04-24 21:06:35 -07:00
2017-11-07 09:07:52 -08:00
[![Gitter](https://img.shields.io/gitter/room/nwjs/nw.js.svg)](https://gitter.im/rodorgas/burlesco)
[![GitHub release](https://img.shields.io/github/release/burlesco/burlesco.svg)](https://github.com/burlesco/burlesco/releases/latest/)
2018-10-10 05:49:33 -07:00
[![Build Status](https://travis-ci.org/burlesco/burlesco.svg?branch=master)](https://travis-ci.org/burlesco/burlesco)
2016-04-24 21:06:35 -07:00
Extensão e userscript para navegadores que remove o paywall poroso de diversos sites de notícia. Funciona no Opera, Firefox e Chrome (e em qualquer navegador compatível com WebExtension).
Para instalar no seu navegador e para mais informações sobre o projeto, visite https://burles.co
# Desenvolvimento
## Extensão
O código-fonte da extensão possui basicamente três arquivos, na pasta `webext/`:
- `manifest.json`: descreve a extensão para os navegadores e define as permissões;
- `background.js`: bloqueia/manipula pedidos responsáveis pelo paywall;
- `content*.js`: injeta scripts para impedir a ativação do paywall ou revertê-lo.
Há um Makefile para auxiliar no desenvolvimento:
2018-10-21 06:42:06 -07:00
- `make lint`: verifica erros de sintaxe ou de estilo no código. Requer o [`es-lint`](https://github.com/eslint/eslint) que pode instalado com `npm install -g eslint`;
- `make`: executa todas as etapas incluindo o lint e gera extensões empacotadas para cada navegador.
## Userscript
O código-fonte do userscript está em `userscript/burlesco.user.js`. Ele funciona bloqueando pedidos responsáveis pelo paywall e injetando scripts para impedir sua ativação.
Esse userscript funciona apenas com o Tampermonkey, porque é o único com suporte a API @webRequest.
----
2017-11-07 09:07:52 -08:00
Se você tiver alguma dúvida ou ideia para burlar um site novo, abra uma issue ou nos [encontre no Gitter](https://gitter.im/rodorgas/burlesco).
# Publicações suportadas
O Burlesco funciona com os seguintes sites de notícia:
2018-10-07 04:25:09 -07:00
- BR18
- Correio Popular
- Diário Catarinense
2018-12-21 13:58:34 -08:00
- Diário da Região
2018-09-11 13:41:01 -07:00
- Diário Popular
2018-11-21 17:05:10 -08:00
- Diarinho
- Exame
- Folha de Londrina
- Folha de S.Paulo
- Gazeta do Povo
2018-09-11 13:41:01 -07:00
- Gazeta Online
- GaúchaZH
- JOTA
- Jornal de Santa Catarina
2018-06-11 22:41:45 -07:00
- Jornal NH
- Jornal Pioneiro
2018-09-11 13:41:01 -07:00
- Jornal VS
- Nexo
- O Estado de S. Paulo
- O Globo
2018-01-16 15:54:33 -08:00
- Quatro Rodas
- Superinteressante
- UOL
- Veja