バージョンごとのドキュメント一覧

J.1. DocBook #

The documentation sources are written in <firstterm>DocBook</firstterm>, which is a markup language defined in <acronym>XML</acronym>. In what follows, the terms DocBook and <acronym>XML</acronym> are both used, but technically they are not interchangeable. 文書のソースは、XMLで定義されたマークアップ言語であるDocBookで作成されています。 ここからは、DocBookとXML両方の用語が使用されますが、技術的に相互の互換性はありません。

<productname>DocBook</productname> allows an author to specify the structure and content of a technical document without worrying about presentation details. A document style defines how that content is rendered into one of several final forms. DocBook is maintained by the <ulink url="https://www.oasis-open.org"> OASIS group</ulink>. The <ulink url="https://www.oasis-open.org/docbook/"> official DocBook site</ulink> has good introductory and reference documentation and a complete O'Reilly book for your online reading pleasure. The <ulink url="http://newbiedoc.sourceforge.net/metadoc/docbook-guide.html"> NewbieDoc Docbook Guide</ulink> is very helpful for beginners. The <ulink url="https://www.freebsd.org/docproj/"> FreeBSD Documentation Project</ulink> also uses DocBook and has some good information, including a number of style guidelines that might be worth considering. DocBookを使用して作成することで、最終的な見栄えがどうなるかに気を遣わずに技術文書の構造と内容を指定できます。 ドキュメントスタイルは、いくつかの最終的な形のいずれかにコンテンツをレンダリングする方法を定義します。 DocBookはOASISグループにより保守されています。 公式DocBookサイトでは役に立つ入門用と参照用の文書、そしてO'Reilly社の本の完全版をオンラインで読むことができます。 NewbieDoc Docbook Guideは初心者にとりとても役に立ちます。 FreeBSDドキュメントプロジェクトでも同様にDocBookを使用していて注目すべき数多くのスタイルに関する指針を含め、役立つ情報があります。