Docutils のバックアップソース(No.3)

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• バックアップ を表示
• Docutils へ行く。
  • 1 (2005-11-14 01:43:41 (月))
  • 2 (2006-01-16 13:00:24 (月))
  • 3 (2006-01-24 01:03:44 (火))

[[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 を実行します。

 $ tar zxvf docutils-0.4.tgz
 $ cd docutils-0.4
 $ su
 Password:
 # ./install.py


* lang設定 [#d461ce2c]

デフォルトでは，lang=en なので，これを lang=ja にしたい．

 $ cd docutils-0.3.7/docutils/language/
 $ cp en.py ja.py

そして，インストールスクリプトを再実行．

 # python setup.py install

 $ rst2html -lja foo.rst foo.html


* 実行 [#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