Installation on Windows

このガイドでは次のトピックを紹介します:

  1. Pythonのインストール (ソースファイルをHTMLページに変換するのに必要)
  2. SVNのインストールとリポジトリのダウンロード
  3. ビルド環境のセットアップ

Pythonのインストール

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

  2. ウィザードを通してインストールしてください。必ずPATHにPythonを追加してください。(画像参照):

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

    makeスクリプトでマニュアルを生成するためにはこのオプションが必須条件です。

    他の設定は初期設定のままでいいです。

SVNのインストールとリポジトリのダウンロード

このガイドではTortoiseSVNというソフトを使いますが、どのSVNクライエントでも大丈夫です。

  1. Download TortoiseSVN for Windows.
  2. ウィザードを通してインストールしてください。インストールされる機能を選択している時では「コマンドラインツール」を有効にすることをお勧めします。そうすることによってコマンドラインからでもSVNを実行できるようになります。
  3. インストール後、Blenderマニュアルのための新しいフォルダーを作ってください。このガイドでは C:\blender_docs を使います。
  4. 新しいフォルダーを開いて、右クリックしてコンテキストメニューの SVN Checkout... を選んでください。
  5. URL of repository フィールドで https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs と記入してください。
  6. Checkout directory フィールドで C:\blender_docs と記入してください。
  7. OK をクリックしたらリポジトリがダウンロードされます。ネット回線によって数分かかる場合があります。

ビルド環境のセットアップ

  • Open a Command Prompt. (Run as Administrator)

  • blender_docs フォルダーに移行してください:

    cd C:\blender_docs
    
  • そのフォルダーの中には requirements.txt というテキストファイルがあり、内容はデペンデンシーのリストになっています。デペンデンシーをPythonの pip コマンドを使ってインストールしてください:

    pip install -r requirements.txt
    
  • 問題なく完了したらこのようなメッセージが出ます:

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

セットアップの途中では警告が出るかもしれませんが、構わないでください。ただし、エラーが出たら問題と成り得ます。

注釈

時々デペンデンシーを最新版にした方がいいでしょう。最新版にするには:

pip install -r requirements.txt --upgrade

Continue with the next step: Building.