Installation i Windows

Den här guiden omfattar följande ämnen:

  1. Installing Python (används för att ”konvertera” källfilerna till HTML)

  2. Installera Git och hämta ner förrådet

  3. Konfigurera byggmiljön

Installera Python

  1. Ladda ner installationspaketet för Python för Windows. I den här guiden används version 3.9.x.

  2. Installera Python med hjälp av installationsguiden. Se till att du aktiverar alternativet ”Lägg till Python i PATH”:

    ../../../../_images/about_contribute_install_windows_installer.png

    Alternativet måste vara aktiverat för att du ska kunna bygga manualen med make-skriptet.

    Alla andra inställningar kan förbli som standardinställningar.

Installera Git och ladda ner repository

I den här guiden kommer vi att använda den officiella Git-klienten, men vilken Git-klient som helst fungerar.

  1. Hämta och installera Git för Windows.

  2. Kolla bara in Blender Manuals förråd med hjälp av:

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

  3. Repository kommer nu att laddas ner, vilket kan ta några minuter beroende på din internetuppkoppling.

Observera

Denna process kan slutföras med hjälp av en grafisk Git-klient, i så fall använder du bara förrådets adress i URL-fältet som tillhandahålls av din klient:

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

Konfigurera byggmiljön

  • Öppna ett Terminal-fönster.

  • Ange mappen blender-manual som just har lagts till av git clone:

    cd C:\blender-manual

  • Installera beroenden:

    make setup

  • Om allt går bra bör du se följande meddelande när det är klart:

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

Under installationen kan vissa varningar visas, men oroa dig inte för dem. Om några fel uppstår kan de dock orsaka vissa problem.

Observera

Då och då måste du köra det här kommandot igen för att se till att beroendena är uppdaterade.

Tips

make setup skapar automatiskt en virtuell miljö med hjälp av dessa kommandon:

python -m venv .venv
.venv/Scripts/pip install -r requirements.txt

Detta undviker att störa systemets Python-installation, i enlighet med PEP 668

Sphinx-kommandot finns tillgängligt på:

.venv/Scripts/sphinx-build