Melhorias na Documentação do Guia de Raspadores

[trevineju]

Antes, no README.md do repositório querido-diario havia uma seção "Gerar múltiplos raspadores a partir de um template", com o seguinte texto:

### Gerar múltiplos raspadores a partir de um template

Você pode se deparar com um cenário em que há diferentes cidades utilizando a mesma base para o raspador, como em `FecamGazetteSpider`. Para não ter que criar os arquivos de raspadores manualmente, você pode utilizar um script para casos em que temos alguns raspadores que não são complexos e usam a mesma base.

Os templates de raspadores ficam na pasta `scripts/`. Aqui está um exemplo de um raspador gerado: 

from datetime import date
from gazette.spiders.base import ImprensaOficialSpider
class BaGentioDoOuroSpider(ImprensaOficialSpider):
    name = "ba_gentio_do_ouro"
    allowed_domains = ["pmGENTIODOOUROBA.imprensaoficial.org"]
    start_date = date(2017, 2, 1)
    url_base = "http://pmGENTIODOOUROBA.imprensaoficial.org"
    TERRITORY_ID = "2911303"

Para rodar o script, você precisa apenas de um arquivo .CSV seguindo a estrutura a seguir: 

url,city,state,territory_id,start_day,start_month,start_year,base_class
http://pmXIQUEXIQUEBA.imprensaoficial.org,Xique-Xique,BA,2933604,1,1,2017,ImprensaOficialSpider
http://pmWENCESLAUGUIMARAESBA.imprensaoficial.org,Wenceslau Guimarães,BA,2933505,1,1,2017,ImprensaOficialSpider
http://pmVERACRUZBA.imprensaoficial.org,Vera Cruz,BA,2933208,1,4,2017,ImprensaOficialSpider


Depois de obter o arquivo .CSV, rode o comando: 


cd scripts/
python generate_spiders.py new-spiders.csv


É isso. O novo raspador estará na pasta `data_collection/gazette/spiders/`.

Este conteúdo poderia ser adaptado para integrar o texto de "escrevendo um novo spider" do read the docs.

[cnfranco]

Olá, @trevineju. Estou trabalhando nessa issue.

[robokbr]

Traduzindo para inglês | Translating to english

---

Hi @trevineju. I'm working on this issue.