DocBook総合

age

>>40
Sun謹製のxmlroffというのもある。要PangoPDF。
http://xmlroff.sourceforge.net/
http://pangopdf.sourceforge.net/

ただ、このPangoPDFが厄介で、PDFの生成にPDFLibかgnome-printを
使うんだけど、前者はDFSG的にnon-freeだし、後者だと依存関係が
循環してしまう。つうか、PDF方面はfreeなものが少なすぎ。

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

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

どうでもいいですw

>>45
SGMLはマークアップ言語で、DocBookはその上のスキーマ。

>>45の質問は、
「GTK+って初めて触ったんだけど、GTK+とC言語って何が違うの？」
という質問と同じような感じになる。

文書自体のカテゴリを入れたいんですけど、どのタグを使えばいいんでしょうか?

>>119

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

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

DocBookでルビを表現する方法ってありますか？
XSLはわかるので適当なタグを追加することは出来るのですが、
DocBookの仕様の中にあるのならそっちを使いたいので…。

>>45
SGML は文法（syntax）、DocBook は語彙（vocabulary）。
ちなみに DTD は語彙を定義するもので、言うなれば辞書だね。

DocBook と同列のものに HTML がある。
どちらも SGML の文法に従って文書を構成するための単語集というわけ。
よって各々を定義している SGML 用の DTD が存在する。

SGML と同列のものに XML がある。
XML の文法に従って文書を構成するための語彙に XHTML と DocBook がある。
つまりそれぞれの語彙を定義する XML 用 DTD というものがある。

The DocBook Doclet (dbdoclet)
http://www.dbdoclet.org/

まとめてみた。

●公式(英語)
http://www.docbook.org/
DocBook Open Repository (英文)
http://docbook.sourceforge.net/
OASIS DocBook TC (英文)
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=docbook

続く

このスレみてDocBook初めて触ったんだけど、
SGMLとDocBookって何が違うの？
たぶんレイアが違うんだと思うけど、
どこまでがSGMLでどこからがDocBookだかわからん。

>>20
うーん、参考になりそう。

酔っ払った勢いで書いためちゃくちゃな文書をうpしてみました。
文字コードはEUC-JPです。
http://wkpxcoeavn.hp.infoseek.co.jp/mahboh.html
http://wkpxcoeavn.hp.infoseek.co.jp/sgml/mahboh.sgml

悲しいかな、今のところなんの知識も盛りこまれてません。。。

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

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

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

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

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

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

こんにちは。以前Definitive Guideの翻訳をしてた人です。
ほったらかしにしてたサイトを覗いたら、データが飛んでる上にFTPにも入れなく
なってましたとさ。復旧すべきかどうか。

V5.0への移行ガイドがあったのでその訳です
http://yoshihiro.toda.name/docbook/docs/howto/
howto.xmlを付けるとxmlファイルが見れます。

これ自体がV5.0でできてるので、ソースを見ても参考になりますよ。
ぱっと見ると、すっきりしたのと、web標準を取り込んで「正しく」発展してる
感じがします。

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

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

>>199

FOPの国際化については、たとえばjpfopの石神さんは、
ttp://www2.xml.gr.jp/log.html?MLID=xmlusers&N=7907
に書いている通り、 FOP1.0待ちと考えているそうな。
そしてたぶん、まだもうしばらくは、この状況は動かないのかな、と。

もう何ヵ月も前のことだけど、FOPのCVS版を落として使ってみたところ、
当然日本語は表示できないし、普通の機能も穴だらけで、全く実用に
ならない状態だったけど、感覚的には半分以下ぐらいに処理が軽く
速くなっていて、スゲェ！と思ったことがありますた。
でも、その後も、FOP1.0はなかなか出てこない…最近でも、
ttp://marc.theaimsgroup.com/?l=fop-user&m=109298968728209&w=2
なーんてやってるように(分かりきった質疑。つまんない)、のんびりペース。
ちょっと調べてみると、この返事をしているChirsがFOPのcomitterになったのは
ttp://xml.apache.org/fop/news.html によれば今年の1月。
内部的には、わりと動いているのかもしれない。けど、外からではよくわからない。

今の仕事に余裕が出来たら、何か手伝えることがあるかなぁと思ってるんだけど。

DocBookとはあんまり関係い長文でスマソ．

> 197

世間でよくあるような、サーバ側でのPDF変換にすると、
メモリ食いのFOPを使う場合にはキツイんですよ。
今回、JavaWebStartのインフラで、FOP、userconfig.xml、
さざなみフォントを配布する、という、ちょっと思いきったことを
やってみました。いろいろ問題あったけど、けっこうイケます。
オープンソースだからこそ！の方法ですな（・∀・）

さざなみフォントには、とても感謝してます。でも、満足はしてません。
客に使わせる前には、言い訳が必要な状態です。
浮気して、みかちゃんフォントを使う…ではなくて、
クライアントローカルなフォントを選択して，TTFReaderをかけられる
ようにする機能を作ってしまおうかなぁとか悩んでます。

この、XMLからPDFへの変換部分は、ほかの用途で再利用できるように
考えています。GUI上でXSLTファイル(のリスト)を指定できるようにとか。

IPAのフォントは、ほしい。IPA版の配布をできるように、
そのためだけにIPAに応募してみようかとすら思っています。

FOPの禁則処理は、
http://www2.xml.gr.jp/log.html?MLID=xmlusers&N=7905
を真似して、XSLTの前処理でごまかしています。
でもやっぱり、もうちょっとちゃんとした処理がしたい。

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

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

SGML Tips for JF
http://www.linux.or.jp/JF/JFdocs/sgmlnote.html

JF Workshop Guidance: SGML 文書作成
http://www.linux.or.jp/JF/workshop/guidance-sgml.html

SGML 参考リンク集
http://www.linux.or.jp/JF/workshop/guidance-sgml.html#sgml-links

( おすすめ ) DocBookの概要
http://www-6.ibm.com/jp/developerworks/linux/010209/j_l-docbk.html

>>111

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

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

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

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

アンケートシステムの一部として作られてるのね。意欲的だなあ。
XMLからPDFへの変換は、ほかの用途でも需要がありそうだね。

フォントはIPAのが期待できるかも。あとはFOプロセッサか。
FOPにも一時期は日本語ローカライズパッチがあったんだけどな。

FOPが国際化されたら、めちゃくちゃうれしいんだけどな。
とりあえず社内文書を安心して電子化できそう。

>>10
XML DocBookならJames Clarkが最近つくったnXML-modeが
あるし、Definitive Guideを参照できるdocbk-menu-modeなんかも
使えて便利ですよ。

http://www.xmlhack.com/read.php?item=2061
http://www.logopoeia.com/docbook/docbook-menu.html

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

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

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

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

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

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

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

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

ごめん

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

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

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

がんばろう！

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

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

おしえてください

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

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

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

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

>>247
thx
なるほど。そういう使い方もできるんですね。

>>246
少し面倒ですが
<phrase annotation=”ヨミ” role=”ruby”>単語</phrase>
としておけば、XSLで変換できそうです

>>56
wikiでやるとかね。

linuxを使ってみたが、windowsの法が何倍も使い勝手がいい。後10年はwindowsだろうな。
金を払って買うOSではない。

とりあえず応援age。
板的に微妙だし、話題もどの程度広がるか分かりませんが。

とりあえず SGML で書いて、SGMLtools-lite で HTML 等に変換してます。
調べもせずに適当に書いたらエラーが出るわ出るわ。。。
ちゃんとこういうところ、まとめて読まないとダメですね。

DocBook: The Definitive Guide
http://www.docbook.org/tdg/en/html/docbook.html

メーリングリストにXMLソースを直接表示できるCSSがポストされてました。

ttp://www.badgers-in-foil.co.uk/projects/docbook-css/

スレ完全終了

>>254
で、LFSスレの回答でよかったんかな

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

>>40
どもども。1=36=38 なもので、それなりに保守がんばってます。

わたしはまだsgmlでしか書いた事がないので、今後はXMLにしていこうと
おもいます。

なにせlinuxもはじめたばかりなので、環境作りに追われています。

もう XML 言語を開発するな
http://po3a.blogspot.com/2006/01/xml.html

DocBook は 5 大主力言語のひとつ。XHTML も。

話の割り込みすいません。ひさーしぶりに翻訳を追加しました。始めた当初と
環境が変わってなかなか時間が割けない状況ですがノロノロやってます。

>>196
クライアントは何も用意しなくていいってのがいいですね。
やっぱりFOPの国際化はXSL-FOをサポートし終わってからになるんでしょうか。

Linuxでdocbookのcatalogインスコするにはどうすれば良い？
ローカルでdtdを保持する必要があるといわれたのだが。
（別スレ（LFS）に質問出したが、英文資料が見つからない以上望み薄いので）

>>21
GJ!! 一回目の惨敗っぷりにワロタ。

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

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

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

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

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