Sphinxをインストール¶

テキストエディタ¶

原稿となるファイルはテキストファイルなのですが、文字コードの制約があってWindowsのメモ帳が使えません。 UTF-8という文字コードが扱えるテキストエディタ（たとえば TeraPad ）をインストールしてください。

PythonとSphinxのインストール¶

Sphinxのユーザー会のサイト を参考にして、PythonとSphinxをインストールします。

PanDocのインストール¶

MarkdownとreStructuredTextを書き分けるのは結構大変です。 MarkdownとreStructuredTextの変換用のアプリとしてPandocというものがあります。

PanDocのサイト からWindows用のインストーラをダウンロードしてインストールします。

インストーラが環境変数PATHにインストール先のディレクトリを追加してくれるので、環境変数の変更を有効にするためにインストーラを終了したら再起動します。

コマンドプロンプトで、下記を実行するとreStructuredTextに変換されます。

> pandoc -f markdown -t rst test.md -o test.rst

test.mdがインプット用のMarkdownのファイルで、test.rstが出力先のファイルです。

入力用のファイルの文字コードはBOM無しのUTF-8（UTF-8N）にしてください。Windowsで一般的なSJISだと変換時にエラーになります。改行コードはCR+LFでも大丈夫なようですが、どうせ文字コードをUTF-8にするのですから改行コードもLinuxに合わせてLFにします。 Winodwsのメモ帳では編集できませんので、TeraPadなどのテキストエディタが必要です。