Installation sous Windows

Ce guide couvre les sujets suivants :

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

  2. Installation de SVN 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.

Avertissement

Python 3.10 n’est pas encore pris en charge, il est recommandé d’utiliser Python 3.9 ou une version antérieure.

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

Dans ce guide, nous utiliserons TortoiseSVN, bien que n’importe quel client Subversion convienne.

  1. Téléchargez TortoiseSVN pour Windows.

  2. Installez TortoiseSVN avec l’assistant d’installation. Pour le choix des fonctionnalités à installer, il est recommandé que vous activiez les outils clients de la ligne de commande pour vous donner l’accès à SVN depuis la ligne de commande (il n’y a pas de danger à faire cela, et il peut être utile si jamais vous rencontrez un problème).

  3. Une fois l’installation finie, créez un nouveau dossier qui contiendra tout ce qui est en relation avec le manuel de Blender. Dans ce guide, nous utiliserons C:\blender_docs.

  4. Ouvrez le nouveau dossier, cliquez droit et choisissez SVN Checkout… du menu contextuel.

  5. Dans le champ URL of repository, entrez : https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.

  6. Dans le champ Checkout directory, entrez : C:\blender_docs.

  7. Cliquez sur OK – le dépôt va maintenant être téléchargé, ce qui peut prendre quelques minutes selon votre connexion Internet.

Préparation de l’environnement de construction

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

  • Entrez dans le dossier blender_docs qui vient d’être ajouté par la commande SVN checkout

    cd C:\blender_docs

  • 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