Namestitev na macOS-u#

Ta vodič se osredotoča na naslednje teme:

  1. Nameščanje odvisnih paketov (ang. *dependencies*)

  2. Prenašanje repozitorija

  3. Nastavljanje okolja za gradnjo priročnika

Opomba

Ta vodič se močno opira na orodja ukazne vrstice. Predvideno je, da ste vsaj približno seznanjeni z macOS-ovim Terminalom.

Nameščanje odvisnih paketov (ang. dependencies)#

Namestite te pakete ali se prepričajte, da jih imate v sistemu.

When using Homebrew, run the following commands in the terminal:

python3 -m ensurepip
brew install git git-lfs
git lfs install

Prenašanje repozitorija#

Preprosto odjavite (ang. check out) repozitorij z ukazom:

cd ~
git clone https://projects.blender.org/blender/blender-manual.git

Repozitorij se bo začel prenašati, kar utegne trajati nekaj minut, odvisno od vaše internetne povezave.

Nastavljanje okolja za gradnjo priročnika#

Nasvet

It is recommended to setup and activate a virtual Python environment where dependencies will be installed:

python3 -m venv .venv
source .venv/bin/activate

Repeat the source .venv/bin/activate command to re-activate the virtual environment, whenever you open a new terminal to build the documentation.

  • Odprite okno Terminala.

  • Enter the blender-manual folder which was just added by git clone:

    cd ~/blender-manual
    
  • V tej mapi je datoteka, imenovana requirements.txt, ki vsebuje seznam vseh odvisnih paketov, ki jih potrebujete. Namestite jih lahko z ukazom pip:

    pip install -r requirements.txt
    

Opomba

Od časa do časa se prepričajte, da imate najnovejše odvisne pakete:

pip install -r requirements.txt --upgrade