Instalar un entorno python/sphinx en Windows?

Question

Usamos Sphinx para documentación dentro de nuestro entorno Linux/OSX python, pero tenemos a alguien en Windows que le gustaría poder obtener un entorno en el que pueda editar y compilar la documentación de Sphinx.

¿Es posible configurar Sphinx en Windows? Supongo que lo difícil es instalar un entorno python y todas las dependencias, pero tengo 0 experiencia con python en Windows para que alguien pueda indicarme una forma directa de proceder.

Answer 1

Puede usar pip-win ahora para configurar fácilmente sphinx virtualenv en Windows.

Primero, descargue e instale Python. Si desea utilizar el constructor latexpdf también necesitará instalar TeX Live o MiKTeX para Windows.

A continuación, ejecute pip-win.exe. Automáticamente extraerá las herramientas de configuración requeridas e instalará pip y virtualenv en su sistema. Cuando se cargue, arrancará el Python que acaba de instalar, pero si lo instaló en una ubicación distinta al directorio predeterminado, puede ingresar fácilmente la ruta absoluta o buscarla.

A continuación, en el Comando: línea que puede crear un nuevo virtualenv inputing:

venv -c C:\foo\sphinx-venv 

Esto abrirá una ventana de comandos con usted dentro de su virtualenv. Después de esto se puede instalar esfinge con el comando pip:

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

Ahora esfinge está instalado en su máquina Windows en un entorno virtual. Puede usar desactivar para escapar de su nuevo entorno.

Cuando cada vez que desea introducir su virtualenv de nuevo para construir proyectos más esfinge puede ya sea abierta pip-ganar y ejecutar:

venv C:\foo\sphinx-venv 

O puede crear un archivo de Python personalizada para activar el entorno de la esfinge y construir el archivo de la esfinge, tales como:

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

Answer 2

Para instalar el pitón en ventanas descarga Python. Ejecute el ejecutable y ya está todo listo.

Si tiene pip instalado entonces se puede abrir el símbolo del sistema y sólo tiene que escribir

pip install -U Sphinx 

Si usted no tiene pip que instalar primero tiene que instalarlo mediante el uso de lo siguiente en el símbolo del sistema

python -m pip install -U pip 

Answer 3

con mucho, la forma más sencilla de utilizar Python en Windows es WinPython, que es una distribución portátil que es tan fácil de usar como cualquier otra aplicación portátil. Le dará un icono para un símbolo del sistema de WinPython desde el que puede usar pip, etc., como en cualquier otro sistema (por ejemplo, linux), o puede descargar paquetes e instalarlos usando el panel de control de WinPython.