Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Enhancement: Big obvious download button for https://www.python.org/ftp/python/doc/3.14.0/

Aperta
  • Qualcosa non va?
#2,982 4 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

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

Direzione di ricerca

Inizia esaminando la pagina delle release dei download di Python e il percorso della documentazione FTP collegato nell’issue, quindi verifica come viene attualmente resa disponibile la documentazione scaricabile su python.org. Il lavoro è completato quando i principianti possono trovare un accesso ben visibile alla documentazione offline in un formato appropriato e la destinazione e i formati supportati sono stati verificati chiaramente.

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

Descrizione

enhancement
Is your feature request related to a problem? Please describe.

I spent ages trying to figure out

  • if Python had an easy way to download docs (didn't find it)
  • which repo contained the files of Python's docs (looked through whole https://github.com/python, and it turned out it was none of them)

I eventually figured out https://www.python.org/downloads/release/python-3144/ would be the simplest route (too bad it's not a git repo though, don't understand the reason why - or is there a Mercurial repo of this somewhere (which is also hidden)?

I extracted the zip, navigated into Doc directory, ran make venv && make html as instructed, and this got me a static HTML tree without any problems (phew).

make latexpdf instead was failing, so first ran make latex then used for i in $(find -name '*.tex'); do xelatex "$i"; done inside build/latex directory: there was an error, but it still built all 37 PDFs I was expecting, so good.

After attempting to release these in a public repo to help future users like me, looking back at the link I used to download Python's source code I decided to navigate to the root (https://www.python.org/ftp/python) to see if there was anything useful, as there's tonnes of stuff in there with no links on the actual site - and I did!

Describe the solution you'd like

Give beginners an easy way to read up about Python offline and in their preferred format!

This is official documentation which is free and will always be the most authoritative source on Python (not to disregard the quality of Python books, which can ease the learning process).

Basic Example

No response

Describe alternatives you've considered

No response

Drawbacks and Impact

This is one of the first things people need to see on the site, these humble docs are gonna accompany them for the whole of their Python journey!

Additional context

No response

Lingua principale
Python
Stelle
1.7k
Fork
700
Merge medio
1g 23h
PR unite (30g)
14

Preparare l'ambiente

Non abbiamo ancora controllato i file di configurazione di questo progetto. Parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

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 python/pythondotorg

Tutte le issue di python/pythondotorg

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.