Installation on Windows

이 도움말은 이런 주제들에 대해서 다뤄요.

  1. 파이썬(python) 설치하기

  2. Installing Git and Downloading the Repository

  3. 빌드(build) 환경 구축하기

파이썬(python) 설치하기

  1. Download the Python installation package for Windows. In this guide version 3.9.x is used.

  2. 설치를 끝내면 창을 닫기 전에 꼭 “Add Python to PATH” 옵션을 체크하세요.

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

    이 옵션이 체크되어야 make 스크립트로 사용설명서를 빌드해볼 수 있어요.

    다른 설정들은 그냥 놔두면 돼요.

Installing Git and Downloading the Repository

In this guide, we will use the official Git client, though any Git client will do.

  1. Download and install Git for Windows.

  2. Simply check out the Blender Manual’s repository using:

    cd ~
    git lfs install
    git clone https://projects.blender.org/blender/blender-manual.git
    
  3. 그러면 저장소 파일들이 다운로드될 거예요. 인터넷이 느리면 몇 분이 걸릴 수도 있어요.

참고

This process can be completed using a graphical Git client, in that case you will just use the repository address in the URL field provided by your client:

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

빌드(build) 환경 구축하기

  • 터미널 창을 여세요.

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

    cd C:\blender-manual
    
  • Install dependencies:

    make setup
    
  • 잘 진행됐다면 끝났을 때 이런 메시지가 나와요.

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

During setup, some warnings may be shown, but do not worry about them. However, if any errors occur, they may cause some problems.

참고

Every now and then you need to re-run this command, to make sure dependencies are up to date.

make setup automatically creates a virtual environment using these commands:

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

This avoids interfering with the system Python installation, following PEP 668

The Sphinx command is available at:

.venv/Scripts/sphinx-build