Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Disponibilizar documentação do Python em PDF

Đang mở
#325 1 bình luận 1 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
45/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Đình trệ
Công nghệ
python
Lĩnh vực
documentation

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

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

Ngôn ngữ chính
Python
Star
178
Fork
168
Merge trung bình
30 phút
Pull request đã merge (30 ngày)
2

Chuẩn bị môi trường

  • Có Dockerfile hoặc tệp Docker Compose
  • Không có mẫu pull request
  • Không có hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của pythonbrasil/wiki

Tất cả issue của pythonbrasil/wiki

Issue tương tự

Thêm issue về Python

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.