DocutilsIntro

Docutils

リンク

docutils とは..?

構造化ドキュメントを変換する
定義はPEP-258
入力は reStructuredText という独自形式
出力はいろいろ

HTML
LaTeX2e
XML (独自形式)
S5 (XHTML + CSS + Javascriptなプレゼン)

標準付属ツール

rst2html

1ファイルのHTMLに変換

rst2latex

ちょっと微妙なlatexソースを吐いてくれる
reST -> latex ( -> dvi -> ps -> pdf )

rst2xml

開発やハマった時に便利
これが吐くXMLからdocbookっぽいものに変換するXSLTが公開されていたり

pep2html

pepのhtml作るのに使われてるやつです

rst-mode.el

emacs用reStructuredText編集モード

その他のツール

docutils の svn treeから拾ってくる

rst2s5
rst2ht -> ht2html に渡す

よそから拾ってくる

rest2web http://www.voidspace.org.uk/python/rest2web/index.html

docutils を使っているもの

moinmoin (妙に高機能なwiki)

wikiページをreSTで書けます
attachment との動作も1.3系からはいいかんじ

trac (wiki + tracker + svn viewer)

wikiページをreSTで書けます
imageのとりこみなどの統合はいまいち

zope

よくしりません。スマソ

reSTで書いてみる

タイトル
=======

ふつうの文章は普通にかきます。

一行あけると別の
段落になります。

1. 箇条書き
2. 先頭の数字は人手で書きます。

  + 入れ子にする時はインデントします
  + 先頭文字が+*-o だと適宜「・」とかになります。

3. 自動で番号を振る拡張が0.3.9で追加されました

こんなかんじっす。

reSTの拡張子は .txt
くわしくはこのへん読んでジックリと。

実際に使って気になった制限

制限はいろいろありますが、気になったのは。。

章番号のない章をつけられない

reSTには章番号の概念がないので「はじめに」や「付録」のように番号のない章、という扱いができない。

表の項目中でアラインメントがない

rst2latex

 -i 入力漢字コード
 -o 出力漢字コード
 --use-latex-toc 目次をlatexのマクロで書く
 --use-latex-docinfo latexのmaketitleで著者や日付を処理する

rst2latex -i euc-jp -o euc-jp \
 --use-latex-toc --use-latex-docinfo < infile > outfile

謎sed

rst2latex は英語環境なlatexソースを吐いてくれるので、以下のようなsedで変換してます

s!\\documentclass\[10pt,a4paper,english\]{report}!\\documentclass{jreport}!
s/\\usepackage\[DIV12\]{typearea}//
s/\\usepackage\[.*\]{inputenc}//
s/\\usepackage{babel}//
s/\\usepackage{ae}//
s/\\usepackage{color}//
s/\\usepackage{amsmath}//
s/png/eps/

Docutils

リンク

docutils とは..?

標準付属ツール

その他のツール

docutils を使っているもの

reSTで書いてみる

実際に使って気になった制限

rst2latex

謎sed

最近とこれから