2011-12-08 34 views
10

Utilizziamo Sphinx per la documentazione all'interno del nostro ambiente Python Linux/OSX, ma abbiamo qualcuno su Windows che vorrebbe essere in grado di ottenere un ambiente in cui poter modificare e compilare la documentazione Sphinx.Installare un ambiente Python/Sfinge su Windows?

È possibile impostare la Sfinge su Windows? Immagino che la parte difficile sia l'installazione di un ambiente python e tutte le dipendenze, ma ho 0 esperienze con python su Windows, quindi qualcuno potrebbe essere in grado di indicarmi un modo semplice per procedere.

risposta

0

È possibile utilizzare pip-win ora per impostare facilmente sfinge in un virtualenv su Windows.

Per prima cosa, scaricare e installare Python. Se si desidera utilizzare il builder latexpdf, sarà necessario installare anche TeX Live o MiKTeX per Windows.

Successivamente, eseguire pip-win.exe. Automaticamente attiverà gli strumenti di setup richiesti e installerà pip e virtualenv sul sistema. Una volta caricato, verrà estratto il Python appena installato, ma se lo hai installato in una posizione diversa dalla directory predefinita, puoi facilmente inserire il percorso assoluto o cercarlo.

successiva, nel Comando: linea è possibile creare un nuovo virtualenv inputing:

venv -c C:\foo\sphinx-venv 

Si aprirà un prompt dei comandi con voi all'interno del vostro virtualenv. A seguito di questo è possibile installare sfinge con il comando pip:

<sphinx-venv> C:\foo\> pip install sphinx 

Ora sfinge è installato sulla vostra macchina Windows in un ambiente virtuale. Puoi usare disattivare per sfuggire al tuo nuovo ambiente.

Quando mai si desidera inserire nuovamente il virtualenv per costruire progetti più sfinge è possibile aprire pip-win ed eseguire:

venv C:\foo\sphinx-venv 

Oppure è possibile creare un file python personalizzato per attivare l'ambiente di sfinge e costruire il file sfinge come ad esempio:

import os 
os.system("cmd /c \"CALL C:\\foo\\sphinx-venv\\Scripts\\activate.bat && make html\"") 
1

Per l'installazione di pitone su windows scaricare Python. Esegui l'eseguibile e sei pronto.

Se hai pip installato quindi è possibile aprire prompt dei comandi e digitate

pip install -U Sphinx 

Se non si dispone di pip installato, allora è necessario prima di installarlo utilizzando la seguente al prompt dei comandi

python -m pip install -U pip 
+0

Piccolo aggiornamento per questo: le versioni più recenti installano tutti i pip automaticamente, quindi non è necessario preoccuparsene. – Saelyth

0

di gran lunga il modo più semplice per usare Python su Windows è WinPython, che è una distribuzione portatile che è semplice da usare come qualsiasi altro app portatile. Ti fornirà un'icona per un prompt dei comandi di WinPython da cui puoi utilizzare pip, ecc., Come in qualsiasi altro sistema (ad esempio Linux), oppure puoi scaricare pacchetti e installarli utilizzando il pannello di controllo di WinPython.