Come creare documentazione PDF con Sfinge in Windows

Question

Sto usando Sphinx per creare documentazione per il mio progetto Python in Windows. Devo generare documentazione PDF. Ho trovato molte spiegazioni su come farlo in Linux, ma nessuna spiegazione valida su come farlo in Windows. Per quanto ho capito, ho bisogno di creare il formato Latex con Sphinx e di usare Texworks per convertire Latex in PDF. Qualcuno può fornire una spiegazione passo passo come posso fare questo, assumendo che ho creato la documentazione in formato Latex e installato Texworks?

Answer 1

Installare la pienatex live distribuzione, installerà latex, backend PDF e texworks. Sì, è molto, sì, sarà dl e installare per un'ora di grasso a seconda della pipa. Ma sarà sub totale, e al giorno d'oggi i dischi rigidi sono grandi.

Da quello che vedo, TeXworks è solo un editor LaTeX semplice, con alcune funzionalità di generazione e la sintassi lattice evidenziazione. Non è realmente necessario solo per la compilazione (si potrebbe usare notepad)

allora dovrebbe essere una questione di semplicemente mettendo il tex directory binaria dal vivo i il percorso e fare

pdflatex <yourlatexdocument.tex> 

sulla cmdline, almeno questo è quello che faccio con l'uscita lattice del nostro strumento di generazione di documentazione

Answer 2

Installa MiKTeX (< 200mb)

wget -nv -N http://mirrors.ctan.org/systems/win32/miktex/setup/miktex-portable-2.9.4757.exe 
7z.exe x -y miktex-portable-2.9.4757.exe -o"miktex" 

Aggiungere ° e bin directory al tuo percorso

SET Path=%Path%;%CD%\miktex\miktex\bin 

Eseguire "make.bat" della Sfinge per generare il file .tex.

SET SPHINXOPTS=-W -E 
make.bat latex 

pdflatex di Invoke MiKTeX:

cd build/latex 
pdflatex.exe YOUR_PROJECT_NAME.tex 

Il PDF risultante sarà nella vostra directory di compilazione/lattice