ドキュメント変換システムどうよ

Author: Kazuo Moriwaka

概要

• 問題
• 目標
• 妥協案
• 入力フォーマット
• 出力フォーマット
• 変換

問題

ドキュメント作成をワープロソフトでやったりした日には

• diffとれない。。
• CVSとかで管理してもめんどくさい。。
• grep とかで串刺し検索できない。。
• とりあえず起動するのに待つのが嫌。

など、特にUNIX worldに住んでいる我々にとっては生産性が落ちまくり。

目標

というわけでまずは目標の世界

しかしこれはむずかしい。

なぜ難しいか

• フリーの自動組版で皆が満足できているものが存在しない！
• というわけでレイアウトに妥協できない人は修正を求める
• 一人や、スタイルに拘らないグループなら可能。ハードルがさがりまくるので。

妥協案

こだわる人は最終直前に細かい手作業をいれることになる。

修正をどうやっていれるかで主に2つにわかれる。

元文書のバージョンがあがると細かい修正はやりなおし

妥協案その1 わーぷろ経由

これはワープロ形式に変換して、その後手で微妙に改行とかを直す。

• 利点 デザイン修正は外注可能かも
• 欠点 自動化めんどくさー

妥協案その2 latex経由

これはlatex形式に変換して、その後がんばる

• 利点 クラスファイルで頑張ると修正をかなり減らせる。 diff+patchが使えるので変更の再適用がある程度できる。
• 欠点 デザイン修正と細かい修正に大量の勉強が必要

入力フォーマット

• DocBook
• Plain2
• POD,RD
• reStructuredText
• wiki markup

DocBook

DocBook は

• ちゃんと標準化されてる。
• 表現能力がむやみに高い。
• いろんな所で使われてる。
• でも書くのが大変
• タグでいっぱいのテキストは読みにくい。特に表。

人間様が直接使う入力としては×

中間形式としてはヨイかも

Plain2

Plain2 はこれ系の元祖

• HTML,LaTeX,nroffに変換できます。
• Plain2形式を食うwikiはなさそうです。
• 他のものからPlain2への変換もなさげ。

POD,RD

POD, RD はperl,rubyのソースコードに埋め込むドキュメント向け。

• RDは Hiki RD+拡張 があるので共同編集が楽かも。
• PODはPerlのドキュメントに利用
• RDはrubyのドキュメントに利用
• それぞれの言語ワールド以外ではマイナー

reStructuredText

reST はpythonのdocutilsで処理する形式。

• アスキーアート的マークアップ。
• docutils APIを使ってtrac, moinmoin, PyDSなど でサポートされてる!
• やはりPythonワールド以外ではマイナー気味

wiki markup

• 世間にはびこるwiki markupsのほとんどは

• 流儀が多すぎて関係者全員が混乱する
• HTML以外に出力できるものがほとんどない

出力フォーマット

• LaTeX
• MS Word
• OOo Writer
• PDF

LaTeX

• ロハで使えるものでは最強のレンダリングノウハウ
• 見た目をいじれるのはtexnicianと呼ばれる希少生物 :-P
• 工夫しないと「いかにもtex」なかんじに。
  • 「いかにもtex」で妥協する
  • 勉強してtexnicianになる
  • texnicianを雇う
  • 自分だけで使うなら直接書くのもOK

MS Word

• 世界一売れてるわーぷろらしい
• windows, mac でしか動かないらしい
• バージョンがかわると形式がかわるらしい
• いじる方法
  • 手
  • win32com
• DocDiff という差分とりツールが5万円くらいで売ってるらしい。アホかと。

OOo Writer

• OpenOfficeOrg の一部。
• zip で固めたXMLファイル群。
• OOo 2.0 でフォーマットがOpenDocumentに変わる。
• XMLサポート機能があるので頑張るとDocBookなどを読み書きできるはず。。。

• 手元では成功してません

PDF

• Adobeの作った規格
• 普及しまくり
• むしろ読めない方が文句言われる

というわけで出力するならPDF。

変換

そしてオレオレソリューションへ

• オレtexnician
• オレPythonista
• reST->latex->PDF (゜Д゜)ウマー!