Installation on macOS

This guide covers the following topics:

  1. Installing Dependencies

  2. Downloading the Repository

  3. Setting up the Build Environment

Note

This guide relies heavily on command-line tools. It assumes you are the least familiar with the macOS Terminal application.

Installing Dependencies

Install those packages or make sure you have them in your system.

Warning

Python 3.10 is not yet support, it is recommended to use Python 3.9 or earlier.

Downloading the Repository

Simply check out the Blender Manual's repository using:

cd ~
svn checkout https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs

The repository will now be downloaded which may take a few minutes depending on your internet connection.

Setting up the Build Environment

  • Open a Terminal window.

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

    cd ~/blender_docs

  • Inside that folder is a file called requirements.txt which contains a list of all the dependencies we need. To install these dependencies, we can use the pip command:

    sudo pip install -r requirements.txt

Note

Every now and then you may want to make sure your dependencies are up to date using:

sudo pip install -r requirements.txt --upgrade