Installation sous Windows

Ce guide couvre les sujets suivants :

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

  2. Installing Git and Downloading the Repository

  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.

Installing Git and Downloading the Repository

In this guide, we will use the official Git client, though any Git client will do.

  1. Download and install Git for 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

This process can be completed using a graphical Git client, in that case you will just use the repository address in the URL field provided by your client:

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

Préparation de l’environnement de construction

  • Ouvrez une invite de commande (lancez en tant qu’Administrateur).

  • Enter the blender-manual folder which was just added by the SVN checkout:

    cd C:\blender-manual
    
  • Dans ce dossier, il y a un fichier nommé requirements.txt qui contient une liste de toutes les dépendances dont nous avons besoin. Installez toutes les dépendances en utilisant la commande pip de Python

    pip install -r requirements.txt
    
  • 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 alarmes peuvent être affichées, mais ne vous en souciez pas. Cependant, si une erreur survient, elle peut causer des problèmes.

Note

À tout moment vous pouvez vous assurer que les dépendances de bibliothèques sont à jour avec la commande

pip install -r requirements.txt --upgrade