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 スクリプトでマニュアルを生成するために、必ず有効にしてください。

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

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