- 追加された行はこの色です。
- 削除された行はこの色です。
[[Docutils:http://docutils.sourceforge.net/]] はPythonで書かれたテキスト処理ツール群です。
reStructuredTextという簡単な構文で構造化されたテキストファイルを、
HTML、XMLやLaTeXなどのフォーマットに変換することができます。
#contents
* ダウンロード・インストール [#a51034a6]
Docutilsを使えるようにするには、 [[Quiq-Start:http://docutils.sourceforge.net/README.html#quick-start]] にある説明に従って操作すれば良いです。
** ダウンロード [#c969a947]
Docutilsサイトの [[Download:http://docutils.sourceforge.net/#download]] から、最新パッケージのdocutils-0.4.tgzを入手します(2006年1月16日現在)。
** インストール [#j90abe78]
ダウンロードしたパッケージを解凍して、出てきたディレクトリに移動して、ルートになって ./install.py を実行します。
ダウンロードしたパッケージを解凍して、出てきたディレクトリに移動して、ルートになって setup.py を実行します。
$ tar zxvf docutils-0.4.tgz
$ cd docutils-0.4
$ su
(enter admin password)
# ./install.py
* lang設定 [#d461ce2c]
デフォルトでは,lang=en なので,これを lang=ja にしたい.
$ cd docutils-0.3.7/docutils/language/
$ cp en.py ja.py
そして,インストールスクリプトを再実行.
Password:
# python setup.py install
$ rst2html -lja foo.rst foo.html
これで上手く行かない場合、pythonがインストールされているかを確認してみてください(とくに、Vine Linuxなら "apt-get install python-devel" してみてください)。
* 実行 [#wc461af7]
** 基本 [#t708b73d]
$ rst2html foo.txt foo.html
** ソースファイルへのリンク,タイムスタンプを含める [#a787e2b3]
$ rst2html -stg foo.txt foo.html
** スタイルシートを指定 [#t1a6f49e]
$ rst2html --stylesheet my.css foo.txt foo.html
** 自分のため [#t5f0eff9]
$ rst2html.py -stg --stylesheet css/default.css index.txt index.html
* リンク [#cc53ccd3]
- http://docutils.sourceforge.net/
- http://docutils.sourceforge.net/docs/user/tools.html
- http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html
- http://docutils.sourceforge.net/FAQ.html