Windowsでのインストール方法

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

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

  2. Installing SVN and Downloading the Repository

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

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

Installing SVN and Downloading the Repository

In this guide, we will use TortoiseSVN though any Subversion client will do.

  1. Download TortoiseSVN for Windows.

  2. Install TortoiseSVN with the installation wizard. When choosing which features will be installed, it is recommended that you enable command line client tools to give you access to SVN from the command line (there is no harm in doing this, and it may be helpful if you ever run into any trouble).

  3. Once the installation has finished, create a new folder that will contain everything related to the Blender Manual. In this guide, we will use C:\blender_docs.

  4. Open the new folder, right-click and choose SVN Checkout... from the context menu.

  5. In the URL of repository field, enter: https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs.

  6. In the Checkout directory field, enter: C:\blender_docs.

  7. Click OK -- the repository will now be downloaded which may take a few minutes depending on your internet connection.

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

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

  • Enter the blender_docs folder which was just added by the SVN checkout:

    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