DocumentSystems

1. ドキュメント作成を楽に！！
1. 問題
2. 目標
3. 妥協案
4. 入力側
1. DocBook
2. Plain2
3. POD,RD
4. reStructuredText
5. wiki markup
5. 出力側
1. LaTeX
2. Word
3. OOo Writer
4. PDF
6. そりゅーしょん
1. 変換

ドキュメント作成を楽に！！

この文章常にかきかけです。

問題

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

• diffとれない。。

• CVSとかで管理してもめんどくさい。。

• grep とかで串刺し検索できない。。

• とりあえず起動するのに待つのが嫌。

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

目標

というわけでまずは目標の世界
しかしこれはむずかしい。

なぜ難しいか:

• フリーの自動組版で皆が満足できているものが存在しない！

• というわけでレイアウトに妥協できない人は修正を求める

• 一人や、スタイルに拘らないグループなら可能。ハードルがさがりまくるので。

妥協案

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



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

• 利点 デザイン修正はわーぷろのテンプレを作ればいいので外注可能かもしれない。

• 欠点 細かい修正の自動化はつらい。自動化できないのでめんどくさい。そもそも超細かいことはできない。

• 妥協案その2 latex経由



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

• 利点 floatを使わなければ細かい修正をかなり減らせる。

texの神がいれば単にコンパイルするだけでOKなくらいになるかも。

• 欠点 デザイン修正と細かい修正に大量の勉強が必要

で、これにマッチするシステムをいろいろ漁ってみました。。

入力側

DocBook

• DocBook は

• ちゃんと標準化されてる

• 表現能力がむやみに高い

• いろんな所で使われてる。

• でも書くのが大変

• 専用エディタをみたことないです。。XML支援ツールでしこしこ頑張れ的。

• タグでいっぱいのテキストは読みにくい。特に表なんて書いてらんねー。でかくて複雑な表を1個書いただけでもうやる気萎えました。

というわけで、人間様が直接使う入力としてはつかえず。 中間形式としてはヨイかもしれません。

• 変換先

• HTML -- OK

• LaTeX -- ちょっとあやしいけどだいたいOK

• OOo -- OOo の方で読み込むプラグインがあるのですが私の手元ではうまく動いていません。。

• 変換元

• OOo -- 同じプラグインで対応してくれるはず。。

• reST -- docbook writerは使えないディレクティブが多いのでreSTのXMLtreeからxsltで変換する方がおすすめ。

Plain2

• Plan2 はこれ系の元祖でしょう。

• Plain2形式を食うwikiがあるといいですね。

• 他のものからPlain2への変換はあるのだろうか。。

• 変換先

• latex -- これがそもそもなのでうまくいきます☆

• HTML -- まあそれなりに

• nroff -- つかったことありません

• 変換元

• なんとか2plain2って寡聞にして知りませんがあるんでしょうか?

POD,RD

• POD, RD はまあまあ。

• RDはHiki RD+拡張があるので編集するのが楽かも。

• PODはPerl, RDはrubyのドキュメントに利用されているのでそれぞれのコミュニティでは手厚くサポートされてるようです。

• 逆に言うならそれ以外ではマイナーです。

reStructuredText

• reSTはpythonのdocutilsで処理する形式。アスキーアートで頑張ったテキストからdom treeに変換して以下略。

• reSTはtrac, moinmoin, PyDSなど で普通にサポートされてるので共同編集はうまくいく。

• restweb

• 日本語が入っているテーブルをさくっと利用するためのノウハウが流通してない。

• Matsumoto,Tadashi さんがパッチを配布しています。

• エンコード指定のオプション一発(--input-encoding=euc-jp)でそれなりに通るようになります

• EUCならまあOK。その内Unicodeのeast asian width属性を使ってきっちり食えるようになる予定。

• これもPythonの一部のドキュメントに利用されているのでPOD,RDと同様の問題と利点が。

• XML文書のDOM treeみたいな中間表現を作って処理するので割と変換が自由

• 変換先

• LaTeX -- latexはquoteの中のverbができなかったりするので95%くらい.

• HTML -- ほぼ完璧

• OOo -- 実装が微妙です。複数あったり。

• DocBook -- 直接吐くwriterは微妙。reST独自のXMLからxsltで変換する方がまともそう。。

wiki markup

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

• 流儀が多すぎて関係者全員が混乱する

• lesser HTMLに甘んじているので文書用に弱い

• 目次

• クロスリファレンス

• 図キャプション、表キャプションがあるのなんて見たことない

出力側

LaTeX

• ロハで使えるものとしては最強に強まったレンダリングノウハウのかたまり。

• ただし見た目をいろいろいじったりできる人はtexnicianと呼ばれる希少生物 :-P

• 工夫しないと「いかにもtex」なかんじになってしまう。

• 「いかにもtex」で妥協する

• 勉強してtexnicianになる

• texnicianを雇う

• 変換先

• HTML -- 部分的に画像を使ったりして頑張って変換してくれます。ほぼ完璧

• PS, PDF -- PDF bookmarkあたりの細かい動きを除けばほぼ完璧

Word

• 世界一売れてるわーぷろらしい

• windows, mac でしか動かないらしい

• バージョンがかわると形式がかわるらしい

• いじる方法

• win32comで継いでがんばる

• HTMLのタグに独自属性をびしびしつけて、wordで読み込ませる

• リッチテキストあたりの別書式を作って、wordで読み込ませる

• Doc Diff という差分とりツールが5万円くらいで売ってるらしい。

• 変換先

• wordもってれば HTML, 素のテキスト(マークアップ消えます)、リッチテキストその他もろもろのワープロ形式で保存できます。

• wv でHTMLに変換できたり。

OOo Writer

• OpenOfficeOrg の一部

• zip で固めたXMLファイル群。

• OOo 2.0 でフォーマットがOpenDocumentに変わる。

• XMLサポート機能があるので頑張るとDocBookなどを読み書きできるはず。。。(成功してません

PDF

• Adobeの作った規格

• 普及しまくったのでどこでも読める/印刷できる。 ていうかできない方が文句言われるらしい。

• 変換先

• 素のテキスト

• 変換元

• OOo

• LaTeX

• PostScript

そりゅーしょん

かきかけです。。。

変換

• 上のグラフに含めた以外にもいろいろ変換パスはあります。html2latexとか。

• 変換して作ったソースはほとんどの場合見るに耐えません。

• 同じ文書を複数形式で管理するのは大変なので、1つのソースを作って他の形式は変換して作るだけになりがち。

• というわけで 使いたい入力→欲しい出力 へのパスを探す

• 印刷用

• latex

• OOo, Word

• web用

• HTML

• reST, RD (wikiで。)

MoinMoin Powered

Immutable page (last edited 2005-05-16 18:14:30 by ::ffff:218)

Or try one of these actions: AddComment, AttachFile, DeletePage, LikePages, LocalSiteMap, SpellCheck