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

>>51
つまり そうです。
>>36-38 のリンクからXMLものを御覧になると良いと思います。

できればサンプルコード使って説明して欲しいんですが、
と言ってみるテスト。

>>41
想像でしかないんだけどPDFは（OSSな）開発者の規模自体が小さい気がします。
前にxslfoprocというプロジェクトを見かけて休止中だったから名前つながりで
Gnomeあたりが拾ってくれないかなーとか思って調べたら
http://opensource.bureau-cornavin.com/xsl-fo/
復活してる！Dandyに改名。なぜかC#版を作りはじめてる？使ったことないけど
PDFライブラリを自前で持ってるみたいです。

>>49
説明が足りないですね、すいません。つまりプリアンブルを足してまともな
出力を得たいならXSLでプリアンブルを書かないといけないんです。もちろん
TeXにしてから付け足してもいいけどスマートじゃないですよね？で、そこまで
するなら最初からLaTeX書くよ、と言いたかったんです。あとdb2latexは
XSLT変換なのでSGMLではなくてXML形式で書きます（そんなに差はないけど）。

しかも、MathML以外で数式をまともに表示させたかったら結局はTeXを経由
しないといけないので
http://www.sagehill.net/docbookxsl/TexMath.html
マークアップの面倒さで比べたらまだまだTeX陣営の方が上かな、と。

連カキですいませんが、XML形式でBibTeXが作れるBibTeXMLっていうのが
http://www.authopilot.com/xml/home.htm
http://xml.coverpages.org/bibteXML.html
あって、これとdb2latexを組み合わせればDocBookでまともな論文が書けますね。

>>48
>日本でDocBookのきちんとしたコミュニティができれば
>いいのに。
日本だと日本語の扱いのせいもあってSmartDocの方が人気がある気が。

むちゃくちゃな提案してみます。

全タグリファレンスつくらない？日本語で。
一人じゃ厳しいので何人かで。

>>56
wikiでやるとかね。

>>57 いいねーー！

最終的にはせっかくDocBookについてやってるわけだし
DocBook用XMLに仕上げてもいいね。

wiki2db or wiki2xml or wiki2sgml 希望

DocBook仕様のwikiとか。

Debianのインストールマニュアルを訳したことがあるけど、
これがDocBook/SGMLだったよ。
わけも分からず訳したけど、もっと便利に使えそうだった。
漏れももっと勉強したひ。

>>56
参加きぼん。何もないとこからやるの大変そうだからDefinitive Guide
の翻訳にしません？GNUライセンスで公開されてるし。なんで日本語版ないんだろう
と思ってたところ。

>>58のDocBook仕様Wikiというと
C-Arbreという
http://www.c-arbre.net/
WikiとDocBookをあわせたCMSがあるけどこんな感じ？仕組みはよくわからんけど。

http://groups.yahoo.co.jp/group/docbook/

日本語のMLハケーン。でも休止状態。全部読んでないけどここでも
TDGの翻訳話があったみたい。ライセンスがどうのって言ってるけど
GFDLだと翻訳はしてもいいんですよね？
http://www.opensource.jp/fdl/fdl.ja.html

個人的には、definitive guideの日本語化きぼんぬ。

YahooのMLを一通り読んでみたけど、やっぱり翻訳してもいいみたい。
http://groups.yahoo.co.jp/group/docbook/message/149

あとこのMLで`Get Going With DocBook'というDocBookの紹介文が
翻訳されてました。が、未完成。
http://nis-www.lanl.gov/~rosalia/mydocs/docbook-intro.html
Definitive Guide は手つかず。ML自体放置プレイ状態。

英語のリンク集は本家のWikiにあるから日本語の情報だけを集めた
リンク集がほしいかも。

>>61
> GFDLだと翻訳はしてもいいんですよね？
できるけど、いろいろ制限あってけっこうめんどうだよ。

xineでaviみてて 調子二のって 降る画面にしたら


もどしかたわかんない；；

おしえてください

激しく誤爆・・・

失礼。

>>60 インスコしてみた。C-Arbre
これ実はすんごい気がする。日本語非対応だから苦しいけど。

ほんとにDocBook / XHtml / XML / Wiki 対応してるよ〜

>>67=1 ですが、i18nを意識してあるが、やはりいろいろめんどくさいので
pukiwikiたてようかと。

翻訳プロジェクトだけにせず、DocBookを日本で誰にでも使ってもらえる
ような啓蒙活動ができるコミュニティになればいいですよね。
どうでしょう・・・

>>64
そーなんですか？なんかひとり張り切ってちょっとだけだけど始めちゃったよ。
でもあの本なしでリファレンス作るって大変そう。DTD直読み？

>>67-68
C-Arbre内部データどうなってますか？Wikiで入力して生データで保存したのを
好きな形式で取り出せる、ってイメージなんだけど。自分でも入れてみよかな。

サイトはとくにDocBookにこだわらずにPukiWikiでいいとおもいます。メンテ
楽だし。どこかサーバのあてありますか？少しなら支援できますが。都合良く
xreraが新規募集してくれれば…

啓蒙は確かに必要だと思います。導入ガイドや入門記事、日本語の扱い方の情
報なんかをまとめて提供できればユーザも増えるんじゃないかと。ただ、これ
がどこまで盛り上がるかですね。半年後にはショボーンだったら萎えますな。
YahooのMLにいた人たちは今どうしてるんだろう…

>>69
そう萎えが恐い。
一応いろいろやりたいし、ddnsだけど鯖は建てたばかりのがあります。
ただlinuxはじめたばっかで、攻撃されたらキョワイんだけど。。

ちなみにあの本は持っていますが、まったく同じ内容のサイトがあります。
それをみて翻訳でも良いかと。
翻訳ができない人(実は自分も英語苦手)もいると思うので、リファレンスは
オリジナルの言葉でもいいかもしれませんね。

皆様のやる気に水を差すつもりは毛頭ありませんが、
あまり盛り上がること（啓蒙）を前提にしない方がよろしいかと。(^^;

異論はあるでしょうが、DocBook はマイナーな道具だと思います。
DocBook に特化したコミュニティが盛り上がらないのも無理からぬことです。
個人的には DocBook の用途はマニュアル執筆に限られている気がしていて、
他の目的に使おうとすると面倒なことが多いと思っています。
マニュアルを書く立場にある人は恐らく少数派でしょう。
この推測が、漏れの DocBook のマイナー感の根っこにあります。

漏れは以前 Yahoo! の ML にも入っていました。
この ML は理想はともかくコアメンバーだけが楽しんでいるという実情でした。
それが良いとか悪いとかではなく、そういうものなんだと思います。
Definitive Guide の和訳ができなかったのも人的リソースの不足と
和訳が必要な利用者層の薄さが原因でしょう。

必要としている者同士が、自らの必要に応じて作業を共有するのがよいと思います。

http://nwalsh.com/ にDocBookの本と同内容のリファレンスが
あったはずなのに、サイト落ちてる感じ。

さて71>>さん
一理あると思います。
ただ、ムーブメントを起こしたいわけではなく、興味がある人に対して
十分な情報を提供できればいいと、そういう環境を共有できればいいな
と思っています。啓蒙についてのとらえかたですね。

まあ自分はまだまだ未熟者なので、大風呂敷を広げるわけにもいかない
ので、まずは小さくても行動をしようと思っています。
１０００行の解説文の中で、一行でも誰かの役にたてたら目標達成した
ともいえますし。存在異義はまあまああるかなと。

あ 付け足し。

今現在、日本語による完全なDocBookタグリファレンスが、書籍・WEBともに
存在していないですので、それが提供できたとしたら、それだけでも十分誰か
の役にたちますよね。

まずはそれをオリジナル解説でも、翻訳でもなんでもいいので作りたいです。

むーん。ここのスレに出入りしてる人もそんなにいないみたいだし、とりあえ
ずはマニュアル作りしてみてそれからやれること考えた方がいいみたいですね。

>>71さんの
>この ML は理想はともかくコアメンバーだけが楽しんでいるという実情でした。
>それが良いとか悪いとかではなく、そういうものなんだと思います。
>Definitive Guide の和訳ができなかったのも人的リソースの不足と
>和訳が必要な利用者層の薄さが原因でしょう。

ってのはつまりユーザ層が薄くて、コア層にとってあの本はリファレンスとして
はありがたいけど特に和訳が必要な訳じゃないってことですよね。

でもその結果が、なんとなく使ってみたいなーと思ってる人は日本語の情報が
少ないからTeXやら他の手段に逃げてしまう→DocBook流行らずじまい、だった
らちょっともったいないかなと。

>>72
http://www.docbook.org/tdg/en/
いまはここで公開されてます。元のDocBook形式のファイルもSorceForgeのCVS
から手に入るのでこれ自体がいいお手本ですね。てか自分リアルの本は持って
ません。罰当たりですいません。

あとご存じかもしれませんが本家のWikiです。かなりお役立ちです。
http://www.docbook.org/wiki/moin.cgi/

ひとり脳内で勝手に盛り上がってます。前述の `Get Going With DocBook' の
全訳がオープンラボのCVSに納められてました。

cvs -d:pserver:[email protected]:/circus/cvsroot co doc-ja/archive/docbook-intro/ja

HTMLに変換するには(open)jadeが必要です。オリジナルが未完成でSGML版が対
象ですがDocBookの基礎が一通りわかると思います。

$ cvs -d:pserver:[email protected]:/circus/cvsroot co doc-ja/archive/docbook-intro/ja
cvs checkout: authorization failed: server openlab.ring.gr.jp rejected access to

$ cvs -d:pserver:[email protected]:/circus/cvsroot co doc-ja/archive/docbook-intro/ja
cvs checkout: authorization failed: server openlab.ring.gr.jp rejected access to /circus/cvsroot for user guest
cvs checkout: used empty password; try "cvs login" with a real password

と言われてとりだせません。
パスワードがいるみたいなんだけどどうすればいい?

エラーメッセージ読まないで何やってるんだろうな・・。
答えそのものが書いてあるのに。(;´Д｀)

>>77
$ cvs -d:pserver:[email protected]:/circus/cvsroot login
Logging in to :pserver:[email protected]:2401/circus/cvsroot
CVS password: ←ここで guest と入力。
$ cvs -d:pserver:[email protected]:/circus/cvsroot co doc-ja/archive/docbook-intro/ja
　：
$ cvs -d:pserver:[email protected]:/circus/cvsroot logout

>>75
qkc コマンドが無かったので Makefile を参考に手作業で HTML 化しますた。

$ jade -d article.dsl -t sgml -ilang.ja -ioutput.html -Vhtml-manifest book.sgml
$ for f in `cat HTML.manifest` ; do
> mv $f $f.orig
> nkf $f.orig > $f
> rm $f.orig
> done

TeX 化して PDF ファイルにもしてみますた。意外ときれいな出力になりますね。
目次から各ページへのリンクも機能するし、表組みもちゃんと出てました。

$ jade -d article.dsl -t tex -ilang.ja -ioutput.print book.sgml
(book.texができる)
$ ptex -ini "&platex" -fmt jadeptex jadetex.ini
(jadeptex.fmtができる)
$ ptex "&jadeptex" book
$ ptex "&jadeptex" book
$ ptex "&jadeptex" book
$ dvipdfm book
(book.pdfができる)

このスレは参考になるのでsage保守しまつ。

ぐぐいっと。

わーんアゲたりサゲたりして弄ばれてるー。

>>4さんみたいなVIM使い向けにDocBook用.vimrcを見つけてきました
http://www.lodestar2.com/software/docbook/vimrc
あと用語集めたdictファイルでも作れば入力楽になりますね。

今大きめの文章書いてて参考文献をbibtexじゃなくてbibtexmlにしてみようか
な、と入力してみたけどこれめんどくさいよママン…｡･ﾟ･(ﾉД`)･ﾟ･｡
あんまり時間もないし結局TeXで書くことになるのかな…

板違いなのかあんまり人こないですね。自分ばっかり書き込んでる気が。
DefinitiveGuideを訳してみました。ちょこっとだけね。そこまではいいんだ
けどGDFLのライセンス読んだら>>64さんのいうとおりでした。めんどくさいに
も程がある。でもせっかく訳したんだし周りに見せたいな、ということで適当
に変換したのを適当に選んだサバにでっちあげてみました。

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

サーバの選択が適当過ぎて一旦許可が下りるまでは転送量が5Mとか冗談程度し
かないのでお早めにどうぞ。だめだったら許可が下りるまで待っててね。

だってネタないじゃんよ。

でも、情報源としては結構貴重かもしれん。

某所でﾊﾟｹｼﾞ屋やってる身としては、環境構築が凄く面倒(つーか情報がない)なのが
アレなんですが、一般人は、RHLなりDebianなりのパッケージがあればそれでOKなのかな…

>>85 激しくGJ！

この２・３日でけりが付く仕事が死ぬ程いま忙しいので、
それが終り次第俺も合流します。
英語苦手だから違う角度からオリジナルドキュメントみたいの
作るかも。

待っていて！！

本格的なコミュニティになることを希望。
DocBook User's Group ・・・ ベタだね・・
日陰のプロジェクトかもしれないけど、需要はある！！


がんばろう！

すいません。流れを読まずに質問させてもらってもいいですか?
日本語(euc-jp)で DocBook/SGML 文書を作成して openjade で HTML 化したいのですが、複数の文書で同じエラーを
吐かれ、原因が特定できていない状態です。
エラーメッセージはこんな具合です。

/usr/bin/openjade:<OSFD>0:216:3:E: end tag for "PARA" omitted, but OMITTAG NO was specified

この後、"SECT4" "SECT3" ... "ARTICLE" "CHAPTER" "PART" "BOOK" と親要素全部に同じ文句を言われ、
出来上がった HTML ファイルは、エラーの当該箇所でぷっつりと途絶えてしまいます。つまり、当該箇所以降
の文書が無かったことにされているような感じなのです。その当該箇所にはもちろんタグなど入れていないので
理由が分かりません。エラーが出る以前の文書と何らも変わりはないように思えるのですが。
このエラーの原因に関して御存じの方おられたら、教えて下さい。

こっそり応援しています。がんがれ

さっき許可が下りて月の転送料が4.5Gまで上がりました。よっぽどの事がない
限りこれで大丈夫だと思います。あとPHPにMySQLも使えるようになったしここ
でWiki立ててもよさそう。

>>90
エラーを読めば分かりますが、OMITTAG NO というのはそのタグは明示的に閉
じなければいけないということです。タグを開きっぱなしで閉じ忘れているか
typoしてませんか？

>>92
レスありがとうございます。
エラーを出された時点では、確かにタグを閉じていないんです。
その後しばらく日本語の文章をだらだらと続けて、区切りたいところできっちりそれぞれの
タグを閉じているんですが、、。
勝手にそのエラー箇所で、文書が途切れてると判断されてる感じなんです。

重ねがさねすいません。分かりにくくなってしまったのでちょっと訂正。

>>93の最後の行、「文書が途切れてる」というより「ファイルが終了している」です。

>>94=90
うーん。実際に見ないと何が原因かわかりません。エラー箇所でインライン要
素じゃないタグを使ったりしてませんか？onsgmlsでチェックするかospamに
タグ補完させたらうまくいくかも？

PlamoLinuxにもDocBookのパッケージが用意されていたんだね。

>>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だとマー
クアップもそんなに面倒じゃないよ。