Installation sous Windows¶
Ce guide couvre les sujets suivants :
Installation de Python (utilisé pour “convertir” les fichiers source en HTML)
Installation de Python¶
Téléchargez Python installation package pour Windows. Dans ce guide la version 3.6.x est utilisée.
Installez Python avec l’assistant d’installation. Veuillez vous assurer que l’option “Add Python to Path” est activée :
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.
Téléchargez et installez Git pour Windows.
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
À 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 commandegit 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