Installation sous Windows

Ce guide couvre les sujets suivants :

  1. Installation de Python (utilisé pour “convertir” les fichiers source en HTML)

  2. Installation de Git et téléchargement du Dépôt

  3. Préparation de l’environnement de construction

Installation de Python

  1. Téléchargez Python installation package pour Windows. Dans ce guide la version 3.6.x est utilisée.

  2. Installez Python avec l’assistant d’installation. Veuillez vous assurer que l’option “Add Python to Path” est activée :

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

    L’option doit être activée pour que vous puissiez construire le manuel avec le script make.

    Tous les autres réglages peuvent demeurer à leur valeur par défaut.

Installation de Git et téléchargement du Dépôt

Dans ce guide, nous utiliserons le client Git officiel, bien que n’importe quel client Git convienne.

  1. Téléchargez et installez Git pour Windows.

  2. Récupérer simplement le dépôt du manuel de Blender avec la commande :

    cd ~
    git lfs install
    git clone https://projects.blender.org/blender/blender-manual.git
    
  3. À présent le dépôt va être téléchargé, ce qui pourrait prendre quelques minutes selon votre connexion Internet.

Note

Ce processus peut être complété en utilisant un client Git, dans ce cas vous utliserez simplement l’adresse du dépôt dans le champ URL fourni par votre client :

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

Préparation de l’environnement de construction

  • Ouvrez une fenêtre Terminal.

  • Entrez dans le dossier blender-manual qui vient d’être ajouté par la commande git clone :

    cd C:\blender-manual
    
  • Installation des dépendances:

    make setup
    
  • Si tout se passe bien, vous devrez voir à la fin le message suivant :

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

Pendant l’installation, des avertissements peuvent être affichés, mais ne vous inquiétez pas. Cependant, si une erreur survient, elle peut causer des problèmes.

Note

De temps en temps, vous devez réécrire cette commande, pour vous assurer que les dépendances sont à jour.

Astuce

make setup crée automatiquement un environnement virtuel en utilisant ces commandes :

python -m venv .venv
.venv/Scripts/pip install -r requirements.txt

Cela évite d’interférer avec l’installation du système Python, suivant PEP 668

La commande Sphinx est disponible sur :

.venv/Scripts/sphinx-build