Instalación en Windows

Esta guía cubre los siguientes temas:

  1. Instalación de Python (usado para «convertir» los archivos fuente en archivos HTML)

  2. Instalación de Git y descarga del repositorio

  3. Configuración del entorno de compilación

Instalación de Python

  1. Descargar el Paquete de instalación de Python para Windows. En esta guía se usa la versión 3.9.x.

  2. Instalar Python con el asistente de instalación. Por favor, asegurarse de que la opción «Agregar Python al PATH» se encuentre habilitada:

    ../../../../_images/about_contribute_install_windows_installer.png

    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á.

  1. Descargar e instalar Git para Windows.

  2. Simplemente obtener el Manual de Blender desde el repositorio, usando:

    cd ~
    git lfs install
    git clone https://projects.blender.org/blender/blender-manual.git
    
  3. 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 agregar git 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