Instal·lació en Windows

Aquesta guia cobreix els temes següents:

  1. Instal·lar Python (s’utlitza per «convertir» els documents font a HTML)

  2. Instal·lar Git i descarregar el repositori

  3. Configuració de l’entorn de compilació

Instal·lar Python

  1. Descarregar el paquet d’instalació de Python per Windows. En aquesta guia s’utilitza la versió 3.9.x.

  2. Instal·lar el Python amb l’assistent d’instal·lació. Assegurerar-se que l’opció «Afegeix Python a PATH» esta activada:

    ../../_images/about_contribute_install_windows_installer.png

    L’opció ha d’estar activada per a que es pugui compilar el manual utilitzant el protocol make.

    La resta de configuracions es poden deixar en els seus valors per defecte.

Instal·lar Git i descarregar el repositori

En aquesta guia s’utilitza el client Git oficial, per bé que qualsevol client Git funcionarà.

  1. Descarregar i instal·lar Git per Windows.

  2. Obtenir el manual del Blender des del repositori utilitzant:

    cd ~
git lfs install
git clone https://projects.blender.org/blender/blender-manual.git

  3. El repositori es descarregarà, el que pot suposar uns quants minuts en funció de la velocitat de la conexió a internet.

Nota

Aquest procés es pot completar utilitzant un client Git gràfic; en aquest cas només utilitzareu l’adreça del repositori en el camp URL proporcionat pel vostre client:

https://projects.blender.org/blender/blender-manual.git

Preparar l’entorn de compilació

Truc

Es recomana configurar i activar un entorn virtual de Python on s’instal·laran les dependències:

python3 -m venv .venv
.venv/Scripts/activate

Repetiu l’ordre .venv/Scripts/activate per a reactivar l’entorn virtual sempre que obriu un nou terminal nou per a confegir la documentació.

  • Obriu la línea d’ordres (Excutar com Administrador)

  • Entreu a la carpeta blender-manual que acaba de crear git clone:

    cd C:\blender-manual

  • Dins d’aquesta carpeta hi un document anomenat requirements.txt que conte una llista de totes les dependencies que es necessiten. instal·lar-les utilitzat la instrucció pip del Python:

    pip install -r requirements.txt

  • Si tot va bé, haurieu de veure el següent missatge quan s’hagi acabat:

    Successfully installed Jinja2 MarkupSafe Pygments Sphinx docutils sphinx-rtd-theme Cleaning up...

Durant la configuració es poden mostrar alguns avisos, però no us preocupeu. Tanmateix, si es produeixen errors, poden causar alguns problemes.

Nota

De tant en tant, podeu assegurar-vos que les vostres dependències estiguin actualitzades mitjançant:

pip install -r requirements.txt --upgrade