Installation on Windows

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

  1. 파이썬(python) 설치하기
  2. SVN을 설치하고 서버 저장소 파일 다운로드하기
  3. 빌드(build) 환경 구축하기

파이썬(python) 설치하기

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

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

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

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

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

SVN을 설치하고 서버 저장소 파일 다운로드하기

이 설명에서는 TortoiseSVN을 사용하지만, 아무 Subversion client나 써도 괜찮아요.

  1. Download TortoiseSVN for Windows.
  2. TortoiseSVN을 설치하세요. 설치할 기능을 선택할 때 *command line client tools*을 체크해서 나중에 명령어(command line)로 SVN에 접근할 수 있게 하는 걸 권장해요(이걸 한다고 생기는 위험은 없어요. 나중에 도움이 될 일이 많을 거예요).
  3. 설치가 끝나면 C:\blender_docs 에 새 폴더를 만드세요. 이 폴더에는 블렌더 사용설명서와 관련된 모든 파일이 담길 거예요. 폴더 위치는 꼭 C: 가 아니어도 되지만, 그렇게 하는 게 이 사용설명서를 따라하기 편할 거예요.
  4. blender_docs 폴더에서 빈 곳에 Shift-RMB 클릭하고 하고 우클릭 메뉴에서 SVN Checkout... 을 누르세요.
  5. URL of repository 텍스트상자에 https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs 를 입력하세요.
  6. Checkout directory 텍스트상자에는 C:\blender_docs 를 입력하세요.
  7. OK 를 누르면 서버 저장소 파일들이 그 폴더로 다운로드될 거예요. 인터넷 속도가 느리면 몇 분까지 걸릴 수도 있어요.

빌드(build) 환경 구축하기

  • Open a Command Prompt. (Run as Administrator)

  • blender_docs``를 입력해서 방금 SVN checkout했던 ``blender_docs 폴더를 찾아가세요.

    cd C:\blender_docs

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

    pip install -r requirements.txt

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

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

이 과정에서 몇 개의 경고가 뜨겠지만 걱정하지는 마세요.

주석

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

pip install -r requirements.txt --upgrade

다음 단계는 빌드(build)하기 에 있어요.