DocBook総合

SGMLやXMLを用いてドキュメントを作成するためのタグセットです。
ひとつのソースをもとに、HTML/PDF/PS/DVI 等、複数のメディア
タイプに変換できます。


公式 http://www.docbook.org/
実用 DocBook 入門 http://www.linux.or.jp/JF/JFdocs/docbook-intro/
DocBook Documentation
http://kaepapa.dip.jp/document/docbook/docbook-doc.html

>>90
問題が再現する最小の文書例を作ってみたらどうでしょう。
それをここにうpすれば何か分かるかも。

>>96
GNOMEのヘルプの処理に必要な分しか揃えてないので、
db2dvi とかはきちんと動かないと思うけどね。


DocBookな文章書くだけなら、DTD見たり、GNOMEの
ヘルプのソース見たりすればどうにかなるけど、
環境作るための情報ってまじでなかったですよ。

RedHatのSRPMSとかだけじゃいまいちダメで、結局
openjade のソースとか、dsssl スタイルシートとかも
解析しまくったよ…
# しかも、もうわすれてしまったし…

サイト落ちてるよ…｡･ﾟ･(ﾉД`)･ﾟ･｡
FTPは通じるからhttpdが逝ってるんだと思う。
ただほど高いモノはないでつね。

>>98
dviはjadetexっていうTeXのマクロセット入れないとダメだけどその他はスキー
マとスタイルシートそろえれば大丈夫ですよ。

ってそういう情報がないってことですね…

>>100
> dviはjadetexっていうTeXのマクロセット入れないとダメだけど

これはすぐわかったんですが、さすがにこっちまで手が出ないというか w

> その他はスキーマとスタイルシートそろえれば大丈夫ですよ。
> ってそういう情報がないってことですね…

ですね。まぁ、このあたりは oasis.org を掘れば、情報はイマイチ
まとまってないけど、とりあえず全部ものを落としてくれば必要な
ものはそろう、という意味ではまぁとりあえずはOKかな。

問題は、GNOMEのヘルプを整形するのに、どのスタイルシートが
必要なのか、ってことになると、これがどこにも情報がないんですわ。

さらに、なんとか該当するスタイルシートを探し出しても、なぜか
絵が出ないとかですね。どうも、同じ名前の別もののスタイルシート
があるのか、あるいはバージョン違いなのか、どっちにしても微妙に
仕様が食い違ってるとか。

ようするに、きちんと動かそうと追いかけると、あちこち細かいところで
引っかかるんです。このへんを追いかけてるうちに、DocBook処理系の
構造とかがおおまかに見えてきてしまったり。

コミュニティの立ち上げを陰でも表でも応援させていただきまーす

コミュニティを作るにあたって、wikiってありなのかな
思ったより管理されてないwikiをたくさんみてきてるから
廃れちゃうだけの気がするんだけど、どうおもう？

だとしたら、このスレッドで匿名で好き勝手に質疑応答とかして、
コミュニティとしてはメーリングリストみたいな形がよくない？

でコミュニティサイトにはMLとこのスレのログためてnamazuで
検索させたり、オリジナル文書つくったのをコミットさせるような
そんなふうがいいと思うんだけど、みんなどうおもう？

＞コミュニティサイト
このスレだけで十分な希ガス
分割しなければならないほどたくさんの情報があるとは思えない
（と言ってみるテスト）

>>104

でもドキュメント作成を主幹におくプロジェクトだし、
発表の場が必要では？
２ch以外からくる人もいるだろうし。
(と言ってみるテスト)

よし私は環境構築の手引きを1から作ってみる。
といっても全環境は無理だから、自分のつかってるFedoraCore1の時と
windows。
これを作って、他の人たちからそれぞれの環境での構築のポイントを
教えてもらってまとめてみようかな。

あKnoppixもあるから、それも付け加えられるかも。

連続カキコ大変申し訳ありませんが、
http://www.linux.or.jp/JF/workshop/JF-in-Progress.html
ここを見ますと結構ためになりそうな文書の翻訳予約が入って
います。

でも進んでないみたいですが。
LDP文書を翻訳するとなると、JFと競合してしまいますな。

鯖が復旧しそうにもないのでいきなり引っ越そうかとか考えてます。

>>105
何をコミュニティとするかにもよりますが、たしかにDocBookって結局のとこ
ろはXML/SGMLの実装の一つでしかないのでDocBookだけの話題ってそんなには
ないんじゃないかと。だからコミュニティサイトとかユーザーグループという
よりはやりたい人がドキュメント作って質問したり答えたりできる場が提供で
きればそれで足りるんじゃないかな、と思います。ん、それってコミュニティ
じゃん。

ただ規模がそんなに大きくなるとは思えないので最初から構えてよっしゃグルー
プだ、みんなついてこーいとか言うよりはまったり情報サイトを目指した方が
いいんじゃないのかなと思ってます。何言いたいのかよく分かんないですね。

って一番盛り上がってるのは自分なんですが。脳内で。

>って一番盛り上がってるのは自分なんですが。脳内で。
漏れもすごく興味あるよ。
でも環境を整えようとして玉砕。(⊃д`)ﾅﾆｦ ｲﾚﾃ ﾄﾞｳ ｾｯﾃｲ ｽﾚﾊﾞ ｲｲﾉﾔﾗ
だからこのスレは期待してる。

Knoppixて！あ、でも環境そろえたのを持ち歩けばどこでも変換できますね。
以外と便利かも。

LDPのInstall mini-HOWTOあたりですか？でも2002年でまだドラフトってこと
はもう進んでない気が。この際パッケージを一切使わないで環境作れるような
ドキュメントにするとか。

関係ないですがこんな記事を見つけました
Take My Advice: Don't Learn XML
http://xml.oreilly.com/news/dontlearn_0701.html
要約すると、文章書きたいの？XML？ダメダメ。あれややこし過ぎ。DocBookが
あるじゃん。てな感じです。

あとこのスレの遅さなら言える。亀レスにもならないけど
>>101Gnomeの文章はGnomeが配ってるスタイルシート使わないとだめなのでは？
http://developer.gnome.org/projects/gdp/handbook/gdp-handbook/
とりあえずパッケージされてるやつを入れてみるとか。

>>109
> やりたい人がドキュメント作って質問したり答えたりできる場が提供できれば
> それで足りるんじゃないかな、と思います。ん、それってコミュニティじゃん。

同意。でもってこのスレがそういう場（の出発点）になるのではないかと。
サイト作ったりするのはこのスレが手狭になってからでも遅くない希ガス。
もし活動が廃れてもこのスレは放置すればいいだけだし。

>>105
> でもドキュメント作成を主幹におくプロジェクトだし、発表の場が必要では？

各自が自サイトで公開してこのスレにURLを集めるというアプローチもあると思われ。

>>106，>>110
環境構築って何するの？
漏れ、赤帽7.3使ってるんだけど、DocBook/SGML に必要な道具は
何もしなくても全部インスコされてた希ガス。
>>80のログ（漏れのカキコ）で自前でインスコしたのはdvipdfmだけ。
他のプラットフォームではいろいろしなきゃいけなかったりする？

確かにこのスレでは手狭に感じたらですね。
了解。

しかしアメリカではDocBookコンサルティングがいるのね。
商業価値って日本ではどうなるかな。

DocBookの環境構築については、dssslの場所とかdocbook-toolsが
依存している他のアプリケーションの兼ね合いとか、そのあたりだと思う。

リナ板で言うのは申し訳ないんだけど、Winユーザにも使ってもらいたいから
そのあたりのドキュメントなんて皆無(言い過ぎかな)だし、そこらへんもやりたい。
あと昔どっかで見た気がするんだけどdb2winhelpみたいのなかったっけ？

>>108
「翻訳進んでないならこっちでやっちゃいますー」って
JF に投げたら?

サバ復活。お知らせも何もなし。なんだったんだ。
yendot（むアンテナ）に捕獲されてた。

>>116
しかしあれやね、ページきれい。
見やすい。

emacs練習しなきゃ・・・おいら。

>>116
翻訳ドキュメント　マルチページ出力希望しちゃったり。

環境構築というよりちょっとカスタマイズしただけでうまくいかなくなっちゃっ
たりファイルの依存関係の定義の仕方がよくわかんねぇ、教えて、って人の方
がいるんじゃない？ただそのへんはSGML/XML一般の話だからここで話していい
のか分かりませんが。このスレを長生きさせるとすればカスタマイズの方に話
題をもってった方がいいのかな。

今sagehillのxsl本よんでるけどなかなかおもしろいよ。

>>117
見た目はemacs先生に全部お任せしてます。

>>119

なるほど、でもあんまり派手なカスタマイズとかしたことないし
もうちょい勉強してみる。

あそうそう、TDGの付録のCDあったけど(内容古いけど・・・)
必要なのあったらいってください。

>>111

> あとこのスレの遅さなら言える。亀レスにもならないけど
> >>101Gnomeの文章はGnomeが配ってるスタイルシート使わないとだめなのでは？
> http://developer.gnome.org/projects/gdp/handbook/gdp-handbook/

そうらしいですね。このへんは RHL の SRPMS が参考になりますた。

> とりあえずパッケージされてるやつを入れてみるとか。

てか、そのパッケージを作ってる人だったもので :-)

>>110
UNIX系だと、SRPMS は慣れないとわかりにくいけど。PlamoとかGentooとかみたいに、
パッケージをスクリプトで作ってるやつのものを見ると結構わかりやすいかも。

ミソは >>114 にある通りで、パスまわりの整合性と、あとはカタログまわりですか。
特に、SGML系のカタログは簡単なんだけど、XML系のカタログの登録がめんどい。

参考リンク追加

DocBook/SGML や DocBook/XML で文書を書く
http://www.netfort.gr.jp/~dancer/column/writing-sgml.html.ja

XMLとSGMLの公開DTD集
http://www.antenna.co.jp/XML/dtdlist.htm

30億回検索してやっとでたこのトリップ。
私は1=123です。

しかし一昨年の段階でOASIS docbook TC で5.0に盛り込む新機能が
リストアップされてたのね。
いつなんだろう。。。バージョンアップ。

>>121
>てか、そのパッケージを作ってる人だったもので :-)
Σ(ﾟ∀ﾟ)!!!
失礼しました。

確かに＜パス＆カタログ。しかも一度設定したらあんまり弄る必要ないから身
につかない。時間経って必要な時に何したかすっかり忘れてたり。

>>118
こんなんでどうしょう。
http://www.freepgs.com/docbook-ja/tdg/chunk/ch02.html
CSSつけたら表示がおもしろいことになっちゃったのでやめました。

本全体の変換をしようとおもってるのですがMakefile一式がsourceforge専
用になってて手入れしないとだめだった。一つにまとめるとこまではいったん
だけど。6メガとか訳の分からんサイズのファイルができた。

>>123
こんなこと言ったら怒られそうだけど、とりあえずライバルはSmartDocですね。
省庁も独自のDTD使ってるんですね。白書DTDって…

>>124
すげえ。執念ですね。

5.0はほぼxmlに移行するそうで。画像まわりで使えなくなるタグがあるっぽい
が。relax版やらxmlschema版も正式になるんですかね。仕様に書いてある6.0
の予定だとbibliographyがもうちょっと書き易くなるとか。なんだ、やること
いっぱいあるじゃん（あれ？

>>126
苦労した割に、docbookって読みにくい・・・・

DocBook/XMLを使ってます。

docbook-xsl/html/docbook.xsl を使ってHTMLに変換しようすると、
DOCTYPE宣言すらない（いきなり<html>から始まる）HTMLもどきができちゃうんですけど、
ちゃんとしたHTMLを出すにはどうすればいいんでしょうか？

あと、「<div></div>」みたいな空要素を出力しないようにするにはどうすればいいんでしょうか？

>>128
特に間違いではなく仕様です、と言えばそれまでですが html/docbook.xsl の
代わりに xhtml/docbook.xsl をつかってみてください。

自分用のXSLファイルを使ってるときは xsl:output のmethod属性をxmlにしな
いとダメです。DOCTYPE宣言が入ればそれでいいなら xsl:output の
doctype-public属性をセットしてみてください。

よけいな要素が入ってしまうのはある程度仕方ないです。デフォルトの変換メ
ソッドの癖に合わせるか、自分でテンプレートを定義し直すかしかないと思いま
す。めんどくさかったら出来上がったhtmlをxmllintにかけてもいいかも。

あ、つけたし。xmllintよりtidyのほうがいいですね。

>>129-130
なるほど、ありがとう。
今ﾌﾟﾛﾊﾞ解約に伴って、Webサイトを全てDocBookに置き換えています。
小難しいところがC++に似てて結構楽しいですね。（皮肉でなく本心。C++大好き）

>>129
ちなみにDOCTYPE宣言がないと確かHTML2.0になるんですけど、
出力はHTML2.0に見えない希ガス・・・。
ちゃんと調べてないけど、それでも間違いではない、と？

ちょっとAnother HTML Lint Gatewayでチェックしてみた。
＞246個のエラーがありました。このHTMLは -434点です。タグが 32種類 200組使われています。文字コードは UTF-8 のようです。
どえらい点数叩き出してしもうた(;´Д｀)そもそもHTML2.0では日本語使えないはずだしな。
DOCTYPEでHTML4.01Transitional付けてもエラーばっかだったから、xhtml/docbook.xslを使うことにします。

>>131-133
>小難しいところがC++に似てて結構楽しいですね。（皮肉でなく本心。C++大
>好き）
便利だけど機能大杉なところも似てますか？（皮肉ですごめんなさい）
XSLTは一種のプログラミング言語なので凝りだすと深みにはまる恐れが。

間違いないっていうのはあのXSLファイルを使って変換される予定のものが予
定どおり出力されてますって意味だったんです。すいません。どこで読んだか
忘れたけど、どんなDocBookファイルでもLintで「良くできました」になるよ
うなXSLなんて作れねえよヽ(`Д´)ﾉ とNorman Walshも言っていたので、ある
程度以上は自分のソース向けにカスタマイズしたXSLファイルを作るのはquirk
じゃなくて正しいやり方なのかも。

てかlintの点数ってマイナスがあるんですね。減点式とはいえ…

あ、補足ですが、html/以下のXSLファイルの標準の出力エンコーディングって
ISO-8859-1なんですよ。変換したファイルの文字は何も指定しないとエンティ
ティに変換されちゃう覚えが。HTML2.0ってあながち間違いじゃなかったりし
て。それにしちゃいろんなタグが使えたりしますが。

>>125 マルチ出力GJ 見やすい見やすい。
私も真似してemacs-wikiいれました。にしてもあんなにきれいに
作れない。。。

それとトリップ検索８０億越えた・・・

http://www.freepgs.com/docbook-ja/tdg/src/TDG.ch02.chm

なんとなく勢いでhtmlhelp版も作ってみますた。ソースに手入れしないででき
る最大まで分割してみたけど、この形式だとこのぐらいが読みやすいかな。

htmlhelpって今どのプラットフォームでも読めるし（逆汗の賜物ですが）、圧
縮されてるからファイルサイズ小さいし、何より一つにまとまってるところな
んかがｶﾅｰﾘ気に入ってます、とかこの板で言ったら叩かれますか？

>>135
emacs-wikiはlisp埋め込んでナンボですよ。てか自分も見た目まわりはあんま
り弄ってません(´･ω･`)

>それとトリップ検索８０億越えた・・・
わらい。人類補完できますね。これ以上何を探してるんですか！

Pod::DocBook - Convert Pod data to DocBook SGML
http://search.cpan.org/dist/Pod-DocBook/

翻訳ちょっとずつ進めてますが日本語用のロケールファイルの訳があんまり良
くないんじゃないかと思ってます。
http://www.freepgs.com/docbook-ja/src/locale.ja.html
オリジナル↓
http://docbook.sourceforge.net/release/xsl/current/common/ja.xml
本なのにサイドバーってどうよ？ここで直してパッチ送りません？

- リンク追加
DocBook で文書を書こう！
http://members.at.infoseek.co.jp/zzyyb/docbook/index.html
読めば書き方が一通りわかるかと。スタイルシートの書き方も少しある。

カンサーンとしてますね。

wt2db
http://www.tldp.org/downloads/

wikiっぽい書き方のテキストをDocBookに変換してくれる。試しに入れてみた
けどおもしろい。

=Title|id=
paragraph
[[link:id]]

これが

<sect1 id='id'><title id='id-title'>Title</title>
<para>paragraph
<xref linkend='id' endterm='id-title'/>
</para>
</sect1>

こうなる。引数指定でdoctype宣言も付けてくれる。気になるのは日本語のタ
イトルだととんでもないidになるぐらい。LDPの人はこんなん使ってたのね…

改行大杉って言われた…だめなのか

>>139のつづき

いまやってる翻訳のドラフトとか他の文章を普段emacsでoutline+fill+vcモー
ドで書いてたんだけどこれのためにoutline-modeの見出しを = にかえてもい
いな。emacs-wiki-modeをdocbook書き出しに対応させればいいんだけど。
Qemacs使えばいいのか。

どうやって別のフォーマットに変換するかも大切だけど、どうやって入力する
かも考えないとめんどくさくて使うのをためらっちゃう人っているんじゃない？
texi（>>39）javaコード（>>47）pod（>>137）と探せば結構ありますね。あと
はrdがdocbookに対応すればなぁ…smartdocにはできるんだけど。

>>140
なんてGoodなもの教えてくれるんだいっ

早速いれねば。もう最高。

Definitive Guideの第２章の訳を更新しました。あともうちょっとで終わりま
す。今回訳した箇所にDocBookで使う要素の一覧が種類別に載っているので参
考にしてください、と自分で書いたわけでもないのに偉そうに言ってみます。

Norm氏のウェブログサイトを（今さら？）ハケーンしたんですが
http://norman.walsh.name/
DocBookのカスタム版で作ってるんですって。

何となく思いつきですがウチのとこにWiki立てたら使いますか？別に注目もさ
れてないので特に必要ないですけどここにでてきたリンクまとめたりするのに
便利かなー。とか思って。

んで誰も使わないから結局自分で更新することになる罠。

もう誰も見てない？1=Qf4doCbOok氏もいないし…
とりあえず第２章の訳が一通り終わりました。読む機会があったら間違い訂正
とかしてくれるとうれしいです。

http://www.freepgs.com/docbook-ja/

つぎは環境のセットアップのあたりをやろうかな、でも本はSGML中心なんだよ
ね…とか書いてもなんか独り言いってるみたいだ…(⊃д`)

えーいアゲてしまえ。更新したときぐらいいいだろ。

ちゃんと見てますよん。
乙 >>144

漏れもこのスレ毎日チェキしてるよー。
翻訳乙彼。「翻訳メモ」見たけど苦心の跡がうかがえまつね。ご苦労さまです。

真の良スレは、住人が少ないように見えるけど、気にせずがんがってください >>144

bookmaker
ttp://blog.bulknews.net/mt/archives/000878.html

>>145-147ありがと。でもスレがいまいち盛り上がらないのは実際需要が少ないから
なのかな…

>>148
ラッパーというよりはMakefileメーカーって感じですね。でもDocBookって書
くのもさることながら変換も面倒だから便利かも。
てかSimonさんパスから察するにマカーだ。メルアドでわかるけど自分もマカー
です。板違いですいません。(･∀･)ｶｴﾚ!と言われたら泣きながら帰ります。

さっき本全体を変換してみたけどウチのマシンじゃ3時間もかかったよ…これ
からどうしよう。ずっとバラバラのままで公開するのも何だしね。

今話題の（？）subversionのマニュアルはDocBookLiteで書いてるんだって。

Version Control with Subversion
http://svnbook.red-bean.com/
XMLソース
http://svn.collab.net/repos/svn/trunk/doc/book/
和訳
http://subversion.bluegate.org/

<para>
DocBook のソース見たけど、かなり記述量多くないですか?
使ってる方の心地はどうです?
</para>

>>150
メタな情報を残そうとすればするほどタグは増えてくよ。でもHTMLにするのが
目的ならよく使うタグはそんなに多くないような。

wt2dbかなりべんり。とりあえずwiki形式で書く→wt2db→手直し→xsltだとマー
クアップもそんなに面倒じゃないよ。

>>150
たくさん書いときゃあれこれの用途に使い回せるというノリだからねえ。
そういうものだと思うしかない。

そういうのが portable ってことでしょ。
漏れは好きだな。

ドキュメント訳すのに、訳者情報入れるの悩んでるけど。

>>153
author と editor 以外に othercredit っていうのがあるから入れるとしたら
そこじゃない？子要素の contrib に何したか書き込めるの。
ってそういう問題じゃない？

>>154
そういう問題なんだけど……っつうかothercreditで書くしかないと思って使ってる。

悩みどころはいつ訳したかという情報をどう入れるかなんです。
year使えばよさげなんだけど、うまく反映されないし……

contribにyear入れてみりゃいいのかな?
そういうのあり? ＜わかってない OTL

>>155
contribにyearは入らないです…

http://www.sagehill.net/livedtd/docbookxml42/
ここを漁ってみたんですが、簡単に済ませたいならcontribに年まで直接書い
てもいいような気がします。フォーマット決めておけばexsltの正規表現で必
要なところ切り出せるし。

もう少し厳密にするんだったらothercreditのclass属性でtranslatorを選んで、
それとは別にrevhistoryにrevision一つ足して詳しいことはそこに書くとか。

んでothercreditとrevisionに同じID振って、変換する時にそこを含むか除外
するか変形させるか選べるようにするっていうのはどうですか？

でもそうするとrevnumberどうすんだって話になりますね。revhistoryを翻訳
専用にもう一つ作るしかないのかな…

あれ、同じIDって付けられないじゃん。Roleとかかな。

すいません。スレ違い気味なんですが、xsltproc使ってる方で、
XSL/XSLT
http://pc2.2ch.net/test/read.cgi/php/999654569/258-
を教えていただける方いませんか？お願いします。

>>144
ごめーーーーん
トリップ無くしてたのと、板更新してなくて 書き込みないのかと
おもてた・・・・

ごめん

>>159
わーい帰ってキター。

あと>>156に自己レスですが、LDPのソース見たら156で書いたみたいなことし
てて、revhistoryはオリジナルと共有で"バージョン.j-1"って区別してました。

>158のWebProg板はヒサンなことになってますね…

相変わらずのスタレっぷりでなによりです。

appendixAというページを訳しました。カタログの設置の仕方なんかがのって
ます。参考にどうぞ。でもsgmlカタログについてだけだからxmlな人にはあん
まり役に立たないかも。おまけに情報古い。

これを読む人自体少ないとは思いますが、その中でsgml/xml比ってどのぐらい
ですか？xmlカタログの作り方って日本語で見たことないし、ツールもほとん
どなし。Libxmlに付いてくるxmlcatalogは基本的にdtd専用で、bsdのパッケー
ジ用（？）のxmlcatmgrも機能がいまいち。しかも文法ミスハケーン。
http://xmlcatmgr.sourceforge.net/

日本語の情報って必要？パッケージ職人以外あんまり必要ないのかな。うまく
使うといろいろと楽ができるんだけど。dtdの指定とか。

翻訳サイトのホストがDoSアタックくらって閉鎖かもです。

こんなものが！
DocBook Live CD
http://trieloff.net/docbook/archive/000530.html
でもライセンスの関係で配布できないみたい。

本家WikiがWikiスパムにやられて停止状態みたいです。何が面白くてこんなこ
とするのか…

さっきCVSのぞいたらV4.3がアップされてました。正式リリースのアナウンス
がもうすぐあると思います。definitive guideのリファレンスに"4.3" と付い
てるやつが追加されたタグです。
xslにはすでにあったHTML風のテーブルタグが追加されて使いやすくなってま
す。

あとDocBook専用のMIMEタイプ"application/docbook+xml"というのが登録
されたようです。

4.3がでましたよ。特に興味なしですか。
emacs-wikiの吐くコードがいまいちなので一人用wikiでも入れようかと思って
たんですが、ためしにWebsiteで作ってみました。Websiteっていう文書型です。
紛らわしいですね。

http://www.freepgs.com/docbook-ja/website/index.html

基本的にSmallDocBookにサイト用のナビゲーション機能が付いた感じです。
website-full.dtd というDTDを使うと無駄にDocBookのタグが全部使えるよう
になります。

>>20 のリンク先に簡単な作り方がのってます。それ以外は（特に日本語は）
Website用のドキュメントがほとんどないから取っ付きにくいけど、自動で目
次作ってくれたりXBELからリンク集作れたりとなかなか面白いです。
まだ全然できてないので参考にもなりませんけど"html"を"xml"にするとソー
スが見れるのでよかったらどうぞ。

漏れも身に覚えがあるんだけど、道具が目的化しちゃってる？
道具を手段と見ている人には DocBook は選択肢の一つでしかないのに対して、
道具が目的になってる人はあれこれ使い道を探そうとする。
いいか悪いかは別として、発想が逆なんだよね。
手段派の立場から目的派を見ると何やってんだ？って感じになる。
あまりやっきにならずにﾏﾀｰﾘやるのがよいと思われ。余計なお世話ｽﾏｿ

>>167
でも、一部の「発送が逆な人」が頑張ってくれた結果として、
使うためのノウハウが溜ったり、使いやすくなったりする、
という側面も否めないわけで。

>>168
うん、その側面は否定しない。情報の共有はとてもありがたい。感謝々々。

> 漏れも身に覚えがあるんだけど、道具が目的化しちゃってる？
コンピュータに詳しい人ってほとんどこの範疇に入るよな。

発想が逆な人です…
ドキュメントを一元管理したくてDocBookに目を付けたけど、逆に道具に使わ
れてる気がしないでもないな。マターリやってくことにします。
サイトをDocBookで作ったのはデモ代わりになればいいかと思ったんですけど。

DocBook TDG 日本語翻訳版
今、docbook-xml で文書を書いてて、非常に助かります。

協力できればいいんですが、ちょっとその時間がとれないので……
申し訳ない。

申し訳ないついでに、
出力エンコードをEUC-JPにしてもらえるとありがたかったり……

DocBook Wiki
http://doc-book.sourceforge.net/homepage/

>>172
意味の分からない訳があったら指摘していただけるだけでも十分助かります。
エンコードは今度変えておきますね。Unicodeの読めない環境の方もいるでしょ
うし。

>>173
ドキュメントがイタリア＋アルバニア語（？）一冊の本に少しずつページを足していくよ
うな感じでおもしろいです。インターフェイスがちょっと。
編集画面でtxt(wiki)⇔DocBook⇔HTML⇔Latex⇔Texiと行き来できるのが
いいかも。将来データベースを使うような事も書いてありますね。

何日か前に第３章の訳を上げました。文書のパースとエラーの対処の仕方がのっ
てます。あとDocBookのgentextという機能の簡単な使い方を書きました。

http://www.freepgs.com/docbook-ja/JapaneseAndXsl.html

これから１ヶ月ほど他にやることがあってあんまり更新できないとおもいます…

The tbook system for XML Authoring
http://tbookdtd.sourceforge.net/
DocBookダメ論
http://tbookdtd.sourceforge.net/db-diss.html

作者がLaTeX出身っぽいしロジックより見た目重視なのかな。パーサ＆プロセッ
サに独自のものを使うのは細かいところを弄れる利点もあるけど、全部てめえ
でメンテしないといけないという欠点があると思うんだけどどうでしょ。後発
の関連技術使うにも自分で実装しないといけないし。

でもこのSmartDocみたいなテーブルの書き方はちょっとうらやましいかも…

>>172
エンコードeuc-jpにしました。遅くなってしまってすみません。

大学のレポートをDocBookで書いてみました。TeXは一切使わずにFOPで出力し
たけどなかなかうまくいきました。でも参考文献のフォーマットはほとんど一
から作らないといけなかったからこれが大変だった…
bibTeXの.bstみたいなスタイルファイルがあれば楽なんだけどな。

いそがしくて翻訳する時間とれてないです。ごめんなさい。

>>176
乙です。
未だにメインのwebブラウザがlynxな人なので助かります。

lynxがutf-8の日本語をちゃんと出してくれればなぁ……

翻訳者氏、お疲れ。
めったに書き込まないけど、ずっと見守ってるよ。気長にね。

>>175
面白いね。
もっとも日本人としては、書きやすさよりも国際化の状況
とかのほうが気になっちゃうけど。

>>178
ありがとう。ヒマ見つけてちょっとずつやってるよ。
DocBookの国際化はほとんどプロセッサ任せだからSGML/XMLが使われてる限り
は大丈夫かな、と思います。SmartDocみたいに１ファイルに多言語埋め込みも
プロファイル使えばできるようになってるし。

あんまりネタがないのもなんなので第２章をPDFにしてみました。
http://www.freepgs.com/docbook-ja/tdg/src/TDG.ch02-fo.pdf
http://www.freepgs.com/docbook-ja/tdg/src/TDG.ch02-latex.pdf

-fo は FOP+kochi-subst で、-latex は db2latex+ヒラギノを使いました。
スタイルシートを弄ればもっときれいにできるはず。foは字詰め・禁則処理が
アレでかなりヒサンだけど、レイアウトをHTMLだとか他のフォーマットと統一
できるのが利点かな。FOPのこれからに期待。
ただ今のところ日本語の組版はdb2latexを使った方がよさそう。otfフォント
を使えるのは結構うれしい。あとはSGMLでjadeptexを使うか。

ROBODoc
ttp://www.xs4all.nl/~rfsber/Robo/

C, C++, Fortran...etc のソースからHTML, DocBook, troff, LaTeX...形式の
ドキュメントに変換。javaだけならdbdocletのほうがいいかな。

dbdocletにはhtml2dbというプログラムが付いてて、ある程度正規化したhtml
だったら割ときれいなDocBookに変換してくれますよ。

PRIME作ってる人のところより。

DocBook + OpenJadeでw3c準拠のHTML作成を目指す
http://taiyaki.org/docbook/dbw3c/

gcc-3.3.2 で openjade-1.3.1 のコンパイルが通らないんですが…

In file included from Recognizer.h:15, from parser_inst.cxx:61:
../include/Owner.cxx: In destructor `Owner<T>::~Owner() [with T = BlankTrie]':
../include/CopyOwner.h:16: instantiated from `CopyOwner<T>::CopyOwner() [with T = BlankTrie]'
Trie.h:22: instantiated from here

他にもヘッダファイルまわりでワーニング吐きまくってますね。

OpenSP-1.5(+openjade-1.3.2) も同様。

CVS先端から持ってこいってオチ?

Fedora Core 1 の SRPMS を掘ってみると、OpenSP に gcc-3.3 対応パッチを当ててた。
これで通るようになった。あいかわらずワーニングは激しいけど。

ていうか、OpenSP-1.5.1+openjade-1.3.2 が出てますな。
openjade.sf.net しか見てなかったので気が付かなかったけど。

こっちは問題なく通る模様です。お騒がせしますた。

>>183
openjadeは1.3.3-pre1というのが１年程前にでてそれっきりですね。メンテモー
ドに入ってるのかな（develは1.4もあるんですけど）。DocBookのDSSSLスタイ
ルシートも最近動きがないみたい。時勢でいうとXMLなんでしょうけど>>181の
人みたいにまだまだ使えるし使ってるんですよね。DSSSLってXSLより書きやす
いし。

話が変わりますがDocBook活用例を２つ。

Making TeX Work
ttp://makingtexwork.sourceforge.net/mtw/
"DocBook TDG"のNorm氏の本。GFDLで公開中。TeXとDocBookの両方のソースを
見れるので参考になるかも。

XForms Essentials
ttp://xformsinstitute.com/essentials/
こっちもDocBookのソースを配付しています。

Borges
ttp://www.linux-mandrake.com/en/doc/project/Borges/

ドキュメントに特化したCVS+αのシステム。セクションごとに管理、校正、翻
訳の担当者を割りあてたり、進歩状況をオンラインで確認したりできる。他に
もhtml/pdfに変換してくれたりOMFを作ってくれたりとなかなか便利。
現在改良中みたい。
ttp://qa.mandrakesoft.com/twiki/bin/view/Main/BorgesCMS
Mandrakeのドキュメントはこれで管理してるっぽいけど他でも使ってるんでしょ
うか。

やっと時間がとれるようになってDefinitive Guideの翻訳に復帰できそうです。
CVS覗いたらアップデートされてるし。書籍はいつ改訂版がでるんだろう。

こんにちは。Dat落ちってなかなかしないもんですね。

>>139のwt2dbをPHPに移植してみました。
http://www.freepgs.com/docbook-ja/WtToDb.html

PHPらしくウェブアプリっぽいこともできます。
http://www.freepgs.com/docbook-ja/wt2db/
がんばればWikiになるかな。

DocBookDTDは4.4b1が出て要素数がさらに増えそうな気配です。
あと翻訳の第4章とどうでもいい序章をアップしました。

こんちは。
TDG の日本語翻訳版を見つけて、その辺から流れてきますた。
>>186 翻訳した人、本当、お疲れ様。

DocBook/XMLをお試し中なんすが、日本語が通る処理系ってなると、
SGMLに比べて情報少なくて苦労してます。

あ、ageてた… スマソ

>>187
それはXML全般のことでしょうか？>処理系。日本語を扱うとなると印刷がまだ
まだなので、文書作成にTeXやら他のワープロやらから移行する人が少ない→
ノウハウがでてこない、っていうのが現状な気がします。DocBookも含めて文
書をオンラインで使う分には十分実用的ですけど。

…で、DocBookを日本語で使うときに、文中で改行すると変なスペースが入っ
てしまって格好わるい/でも改行なしに1行でダラダラ書くのはウザったい。と
いうジレンマを解消するためにスタイルシートを作りました。

http://www.freepgs.com/docbook-ja/JapaneseAndXsl.html#unfill

インポートするだけです。簡単に調整できるXMLのディレクティブがあるかな、
と思って探したけどなさそうだったので。自分が知らないだけ？

>>177
2.8.6dev.4から、configure に --enable-japanese-utf8 を
つけると、割とまともに UTF-8 の日本語を表示してくれる
ようになりました。

>>189 のスタイルシートだとインライン要素があるときにうまく対処できてな
かったので作り直しました。英文でもクオートの周りを整形したりするので
ちょっとは効果があります。これでXMLでも改行しまくりですよ。

保守ずさーーーーーー

保守ずさーーーーーー

海外では使われてるのにね。

Apache FOPはいつになったらちゃんと国際化された
次期バージョンが出るんだろか

> 195
同意。

いま、JavaWebStartで、Webブラウザ上でクリック一発で
FOP環境をダウンロード・インストールして、クライアントローカルで
XML→XSLT→PDF変換処理をするしくみを作ったとこ。
TTFReaderとかuserconfig.xmlとか、面倒くさいのは一切ナシの方針で．
https://sourceforge.jp/projects/sqs-xml/

なので、PureJavaの、少しでもちゃんとした日本語組版ができるFOエンジン、
再配布自由の高品質なフォントが、欲しくてたまらんのです…。