Установка на Windows

Это руководство покрывает следующие темы:

  1. Установка Python (используется для «преобразования» исходных файлов в HTML)

  2. Installing SVN and Downloading the Repository

  3. Установка окружения сборки

Установка Python

  1. Загрузите пакет установки Python для Windows. В этом руководстве используется версия 3.9.x.

  2. Установите Python с помощью мастера установки. Пожалуйста, убедитесь, что вы включили опцию «Add Python to PATH»:

    ../../_images/about_contribute_install_windows_installer.png

    Опция должна быть включена, чтобы вы могли создать руководство с помощью скрипта.

    Все остальные настройки можно оставить по умолчанию.

Installing SVN and Downloading the Repository

In this guide, we will use TortoiseSVN though any Subversion client will do.

  1. Download TortoiseSVN for Windows.

  2. Install TortoiseSVN with the installation wizard. When choosing which features will be installed, it is recommended that you enable command line client tools to give you access to SVN from the command line (there is no harm in doing this, and it may be helpful if you ever run into any trouble).

  3. Once the installation has finished, create a new folder that will contain everything related to the Blender Manual. In this guide, we will use C:\blender_docs.

  4. Open the new folder, right-click and choose SVN Checkout… from the context menu.

  5. In the URL of repository field, enter: https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.

  6. In the Checkout directory field, enter: C:\blender_docs.

  7. Click OK – the repository will now be downloaded which may take a few minutes depending on your internet connection.

Установка окружения сборки

  • Откройте командную строку. (Запустите от имени администратора)

  • Enter the blender_docs folder which was just added by the SVN checkout:

    cd C:\blender_docs

  • Внутри этой папки находится файл requirements.txt, который содержит список всех необходимых нам зависимостей. Установите все зависимости с помощью команды Python pip:

    pip install -r requirements.txt

  • Если всё прошло хорошо, вы увидите следующее сообщение по завершению операции:

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

Во время установки могут показываться некоторые предупреждения, не следует о них беспокоиться. Однако, если возникнут ошибки, они могут вызвать проблемы.

Примечание

Теперь, каждый раз, если вы захотите убедиться, что ваши зависимости актуальны, вам следует выполнять команду:

pip install -r requirements.txt --upgrade