Disponibilizar documentação do Python em PDF

Aperta
#325 1 commento 1 reazione 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
3/5
Tempo stimato
1-2 giorni
Idoneità per principianti
45/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
python
Ambito
documentation

Direzione di ricerca

Start by reviewing how the "Inicie-se" menu is defined in the Python Brasil wiki and inspect issue #271 about generating the translated PDFs. The work is complete when the new Documentation item links to the official online documentation and lists downloadable PDFs by section, including a complete documentation PDF.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

As pessoas no núcleo do desenvolvimento do Python decidiram não fornecer mais a documentação em formato PDF.

Sugiro que façamos isso. Penso que para o Brasil isso é bem relevante, e podemos fazer algo até melhor.

A ideia inicial é criar um novo item no menu Inicie-se: Documentação.

Nele, vai ter o link para a documentação oficial on-line, mas também serão listados os PDFs para download. Atualmente, isso é disponibilizado no docs.python.org em um zip com mais de 30 arquivos PDF dentro. Acredito que listar diretamente os arquivos PDF seja mais prático, pois a pessoa pode abrir diretamente no navegador.

Penso que seja interessante um arquivo por seção da documentação:

  • Tutorial
  • Referencia da biblioteca
  • Referencia da linguagem
  • Configurações e uso do Python
  • Guias de como fazer (Python HOWTOS)
  • ...
  • FAQs
  • ....

Howtos atualmente são arquivos separados, acredito que possa ser um único arquivo com todos eles.

Além de um com a "Documentação Completa".

Foi aberta uma issue para que essa geração dos PDFs seja feita no ambito da tradução da documentação

cc @rffontenelle

Lingua principale
Python
Stelle
178
Fork
168
Merge medio
30m
PR unite (30g)
2

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di pythonbrasil/wiki

Tutte le issue di pythonbrasil/wiki

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.