macOS에서 준비하기

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

  1. 설치 환경

  2. 서버 저장소 파일 다운로드하기

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

참고

이 설명들은 command-line을 많이 활용해요. macOS Terminal application을 어느정도 쓸 줄 알아야 해요.

설치 환경

먼저 시스템에 이 패키지(package)들이 있는지 확인하고, 없다면 설치하세요.

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

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

서버 저장소 파일 다운로드하기

Simply check out the Blender Manual’s repository using:

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

그러면 저장소 파일들이 다운로드될 거예요. 인터넷이 느리면 몇 분이 걸릴 수도 있어요.

빌드(build) 환경 구축하기

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.

  • 터미널 창을 여세요.

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

    cd ~/blender-manual
    
  • 그럼 폴더 안에 requirements.txt 가 있을 거예요. 이 텍스트 파일에는 필요한 것(dependency)들이 적혀 있어요. 그것들을 설치하려면, pip 명령어를 쓰면 돼요.

    pip install -r requirements.txt
    

참고

이 명령어로 항상 환경(dependency)을 최신 버전으로 유지하세요.

pip install -r requirements.txt --upgrade