Instalación en Windows¶
Esta guía cubre los siguientes temas:
Instalación de Python (usado para «convertir» los archivos fuente en archivos HTML)
Instalación de Python¶
Descargar el Paquete de instalación de Python para Windows. En esta guía se usa la versión 3.9.x.
Instalar Python con el asistente de instalación. Por favor, asegurarse de que la opción «Agregar Python al PATH» se encuentre habilitada:
La opción deberá estar activada para que sea posible compilar el manual con el script make.¶
El resto de opciones podrán quedar como se encuentren de forma predefinida.
Instalación de Git y descarga del repositorio¶
En esta guía, se usará el cliente oficial de Git, aunque cualquier cliente de Git servirá.
Descargar e instalar Git para Windows.
Simplemente obtener el Manual de Blender desde el repositorio, usando:
cd ~ git lfs install git clone https://projects.blender.org/blender/blender-manual.git
El repositorio será descargado, lo que podrá tomar unos minutos, dependiendo de la conexión disponible a Internet.
Nota
Este proceso podrá ser completado utilizando un cliente Git gráfico, en ese caso, sólo se usará la dirección del repositorio en el campo URL proporcionado por el cliente:
https://projects.blender.org/blender/blender-manual.git
Configuración del entorno de compilación¶
Abrir una ventana de terminal.
Ingresar a la carpeta
blender-manual
que acaba de agregargit clone
:cd C:\blender-manual
Instalación de dependencias:
make setup
Si todo va bien, se debería mostrar el siguiente mensaje cuando haya terminado:
Successfully installed Jinja2 MarkupSafe Pygments Sphinx docutils sphinx-rtd-theme Cleaning up...
During setup, some warnings may be shown, but do not worry about them. However, if any errors occur, they may cause some problems.
Nota
Cada tanto, será necesario volver a ejecutar este comando, para asegurarse de que las dependencias se encuentren actualizadas.
Truco
make setup
automatically creates a virtual environment using these commands:
python -m venv .venv
.venv/Scripts/pip install -r requirements.txt
This avoids interfering with the system Python installation, following PEP 668
The Sphinx command is available at:
.venv/Scripts/sphinx-build