Windowsでのインストール方法

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

  1. Pythonのインストール (ソースファイルをHTMLページへ変換するために必要)

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

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

Pythonのインストール

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

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

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

    このオプションは make スクリプトでマニュアルを生成するために、必ず有効にしてください。

    他の設定は初期設定のままで構いません。

警告

Python 3.10 is not yet support, it is recommended to use Python 3.9 or earlier.

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

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

  1. Windows用の TortoiseSVN をダウンロードしてください。

  2. ウィザードを通してインストールしてください。インストールされる機能を選択する際に command line client tools を有効にすることをお勧めします。そうすることによってコマンドラインからでも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 をクリックするとリポジトリがダウンロードされます。ネット回線によって数分かかる場合があります。

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

  • コマンドプロンプトを開きます。(「管理者として実行」で開いてください)

  • SVN のチェックアウトによって追加された 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