DocBookを試してみようと思っても、いろいろ導入するものがたくさんあって大変ですよね。
Windowsな場合、なおさら大変です。
Eclipse Keplerを導入
Eclipseはポータブルな構造をしているので、用途ごとにEclipseを構築するとあとで楽だと思います。
Eclipse Standardを拾ってきましょう。
私は32-bit版のWindows8.1を使っているので、Windows 32 Bitを選択しました。
展開先は今回デスクトップにしました。
workspaceの名前を変える
他のプロジェクトとカブるとたくさん出てきて邪魔臭いことがあるので、workspaceの場所を変えました。
Eclipseを起動すると、最初にワークスペースの場所を聞いてきますが、これを適当な場所に変更します。
私はC:\Users\takehiro\workspaceとなっていましたので、これをC:\Users\takehiro\docbook-workspaceに変更しました。
皆様に於かれましてはご自由に設定ください。
ワークスペースが新規作成されてWelcomeが開かれますので、これを閉じます。
DEP4Eを導入する
DEP4E、正式名称をDocbook Editing and Processing for Eclipseというそうです。
DEP4EはDocBookの編集環境と変換処理環境を一気に構築してくれます(名前のまま)。これ一発で整うので非常に楽ちんですね。XalanやSaxon, スキーマとかを拾ってきてPATHを通して、とやらなくてもいいんです。
インストールは下のアイコンをEclipseのワークスペースにドラッグ＆ドロップするだけです。
もしくは公式サイト http://dep4e.sourceforge.net/ を御覧ください。
途中、署名がないという警告がでますが、インストールするためには承諾するしかありません。
DocBook5.0プロジェクトを作成
早速DocBook5.0のプロジェクトを作成してみましょう。
File→New→Other...の順でクリックすると開くダイアログの中にDocBookが増えています。
DocBook5.0 Projectを選んでNextをクリックします。
あとはプロジェクトに適当な名前をつけてFinishです。
ワークスペース全景
ワークスペースは下の図のようになっています。見慣れた構成ですね。
左下にAntのViewが居ます。Antのツリーを展開すると、EPUB3やHTML5、PDFといった項目が並んでいます。
DocBookを変換するフォーマットのことで、これをダブルクリックするとビルドできます(PDFに変換しようとしたらヒープが足りないと言われてしまいました...)。
初期設定
初期設定を行っていきます。
設定はDEP4Eとプロジェクトの2つに行います。DEP4Eの設定は一回やるだけで良いですがプロジェクトでの設定はプロジェクトを作るごとに行わなければなりません。
DEP4Eの設定 - 検証時のXML Inclusions
DocBookで大きな文書を作るとなると、セクションやチャプターごとにファイルを分けて作成することになるでしょう。
その際にXInclusion(XInclude)によって連結を指示しますが、初期状態ではXInclusionをバリデータが認識せず検証エラーになってしまいます。
これを検証成功させるためにInclusionを検証するようにします。
Window→Preferencesとクリックし、下図の画面でProcess XML Inclusionsにチェックを付けます。
プロジェクトの言語設定
変更しなくても特に問題ないかと思いますが念のため...
ワークスペースのNavigatorのツリーにAntのbuild.xmlがありますのでこれをダブルクリックして開きます。
デフォルトでは次のようになっていますが、
<?xml version="1.0" encoding="UTF-8"?>
<project name="DocBook" default="All">
<property name="docbook.xml.filename" value="docbook" />
<property name="docbook.xml.language" value="en" />
<import file="${net.sourceforge.dep4e.resources}/ant/docbook_5-0.xml" />
</project>
5行目のdocbook.xml.languageのvalue="en"をvalue="ja"に変更します。
<?xml version="1.0" encoding="UTF-8"?>
<project name="DocBook" default="All">
<property name="docbook.xml.filename" value="docbook" />
<property name="docbook.xml.language" value="ja" />
<import file="${net.sourceforge.dep4e.resources}/ant/docbook_5-0.xml" />
</project>
docbook.xml.filenameのプロパティはビルド対象のファイルなので、これをvalue="docbook"からvalue="master"などとすれば、master.xmlがビルド対象になります。
変更したら当たり前ですが保存することをお忘れなく...
サンプルファイルの削除
サンプルファイルを削除します。
Navigatorでsource以下にあるenフォルダをまるごと削除します。
文書のマスターファイルを作成
Navigatorのsourceを右クリックしてFolderを作成します。Folder nameにはjaと入力しましょう。
つづいてjaフォルダを右クリックしてDocBook 5.0 Fileを新規作成します。
私の場合はルートエレメントはsectionにしました。この辺りは目的に合わせて変更します。
File Nameにはdocbook.xmlと入力します。これはbuild.xmlのdocbook.xml.filenameプロパティの値に合わせます。
開いたファイルでそのまま作業をします。
ルート要素の言語宣言を変更
作成されたXMLファイルのルート要素に、言語宣言がされていますがこれを変更します。
<?xml version="1.0" encoding="UTF-8"?>
<article xml:lang="en" xmlns="http://docbook.org/ns/docbook"
version="5.0" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xl="http://www.w3.org/1999/xlink">
xml:lang="en"をxml:lang="ja"に変更します。
<?xml version="1.0" encoding="UTF-8"?>
<article xml:lang="ja" xmlns="http://docbook.org/ns/docbook"
version="5.0" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xl="http://www.w3.org/1999/xlink">
なおこの作業はDocBook 5.0 Fileを作成するたびに必要になりますのでご注意ください。
もっとも、XMLファイルとして作成してイチから書いてしまえば問題無いですが。
docbook.xmlの内容を削除
余計なサンプル文を削除してしまいます。
<?xml version="1.0" encoding="UTF-8"?>
<article xml:lang="ja" xmlns="http://docbook.org/ns/docbook"
version="5.0" xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xl="http://www.w3.org/1999/xlink">
<info>
<title>Title of article</title>
</info>
<section>
<title>Section title</title>
<para>A paragraph.</para>
</section>
</article>
さぁ、DocBookで書き始めましょう！
以上でDocBookで書き始める準備が整いました。
DocBookにはたくさんのタグがあるので難解に感じますが、実際にはHTMLでページを書くくらいのタグを覚えればある程度のものはかけてしまいます。
必要になったら新しいタグを覚えてゆけばよい位の気持ちでいれば良いと思います。
マークアップ変換ソフトのPandocがDocBook対応しているので、MarkdownからDocBookに変換するのも手だと思います。