Antenna House Formatter V5.0には、オプション設定を外部ファイル（オプション設定ファイル）から読み込む機能があります。オプション設定ファイルのファイル・パスは、環境変数AHF_OPTを使って指定します。オプション設定ファイルを作成する方法には、テキ…

DITA Open ToolkitのPDF出力にAntenna House Formatter V5.0を使用するには、startcmd.batとFOプラグインのビルド・ファイル(build.xml)の修正が必要です。Antenanna House Formatter V5.0を使用するための、startcmd.batとFOプラグインのビルド・ファイルの…

DITA-OTの不具合を見つけたときや改善要望があるときは、SourceForgeのTrackerに登録しましょう。Trackerに登録した不具合や改善要求は、それらの対応が完了するまで追跡記録されます。日本語に関する不具合や改善すべき点は、たくさん残っています。日本か…

DITA Open ToolkitによりPDFを出力するとき、各ページのヘッダ部に製品名や文書名などの決まった文字列を出力することができます。製品名や文書名は、prodname要素を使って指定します。 prodname要素の指定の仕方は、DITAマップのルート要素の種類によって変…

【改訂後】DITA-OT1.4.3のPDF出力を日本語化する(RenderX XEP編)を訂正しました。 日本語フォントを適用する、Unicodeの範囲の指定を変更する手順を追加しました。この変更をしておかないと、日本語の句読点や全角英数字、全角記号などが文字化けを起こしま…

来たる６月９日、DITAコンソーシアムジャパンの２回目の大きなイベントである、「DITA普及公開セミナー」を開催します。詳細は下記のページをご覧下さい。参加費は無料ですが、事前申込みが必要です。席に限りがありますので、お早めにお申し込みください。D…

DITA-OT1.4.3のFO plug-inの動作テストのために、DITA 1.2のLanguage SpecificationをPDFに変換してみたところ、下記のようなエラーが発生しました。 [java] Exception in thread "main" java.lang.OutOfMemoryError: Java heap spaceYahoo! DITA user group…

DITA-OT1.4.3のPDF出力を日本語化する(RenderX XEP編)【重要】 XSLTエンジンをSaxon9Bにすると、以下のようなエラーが発生することがわかりました。 [java] Error on line 290 of index.xsl: [java] Cannot find a matching 2-argument function named [java…

DITA-OTが出力するXHTMLに検索機能を追加するプラグインがあります。プラグインの名前はhtmlsearchで、Yahoo! DITA user groupのFilesセクションで公開されています。 tocjsbisプラグインとhtmlsearchプラグインを組み合わせると、XHTMLの出力は下図のような…

DITA-OTが出力するXHTMLの、目次のフレームを、ツリー図形式でグラフィカルに表示するためのプラグインがあります。プラグインの名前はtocjsとtocjsbisで、どちらもYahoo! DITA user groupのFilesセクションで公開されています。 tocjsが目次をツリーズ形式…

DITA-OTが出力する各トピックのXHTMLファイルに、ヘッダーやフッターを追加することができます。この機能は、Copyright ©の注記をすべてのページに表示させるときなどに便利です。 DITA-OTを使ってXHTMLを生成するとき、下図の例に示したように、全ページの…

DITAを使ってドキュメントを執筆する際に、サンプルのドキュメントがあると便利です。今後、DITAコンソーシアムジャパンにおいて、日本語のDITAサンプル・ドキュメントを作成、公開していく予定です。英語のドキュメントでも構わない方は、DITAのLanguage Re…

コムテック社のWebサイトで、DITA Architecture SpecificationとDITA Language SpecificationのeCompress版が公開されています(30日の使用期限あり)。 Comtech Services, Inc. eCompressというのは、Eurofield Information Solutions Pty Ltdが開発した電子…

DITA-OTが出力するXHTMLファイルは、CSSファイルによってレイアウト・デザインが定義されています。DITA-OTには、ユーザー定義 CSSファイルを使って、XHTML出力のレイアウト・デザインをカスタマイズする機能があります。この機能により、DITA-OTが出力するX…

XHTML出力をフレーム形式で表示するには、(1)DITA-OTが出力する目次ファイルのファイル名の変更、(2)フレームセットを定義したindex.htmlの作成、(3)contentwinフレームに最初に表示するdefaultpage.htmlの作成、(4)index.htmlとdefaultpage.htmlをコピーす…

標準のDITA-OTが出力するXHTMLは、フレームを使わない形式になっています。目次とトピック・コンテンツを1つのウィンドウの中で同時に参照することができないため、文書全体の中でのトピックの位置づけを把握するのに不便です。 出力タイプにxhtmlを指定して…

DITA-OTで生成したXHTMLのコンテンツに、簡単に全文検索の機能を追加する方法を検討しています。すべてJavaScriptで書かれたサーチ・エンジンがあればと思い調べてみたところ２つのソフトウェアがありました。 Seach Maker Pro Windowsで動く有償ツールです…

BMC Software, Inc.のAnn Gentleさんのブログに、A chatched folder ofr publishing from DITA source filesという記事が掲載されていました。 自分一人でDITA-OTを使っている分には必要がない話しですが、会社の中で複数の人がDITAドキュメントを書いている…

現象 ドメイン・サーバーを立ち上げていないネットワーク環境において、PC間でファイルをコピーしようとすると、以下のようなエラー・メッセージが表示される。 「xxxをコピーできません。アクセスできません。 ディスクがいっぱいでないか、書き込み禁止に…

昨日の日記で、%DITA-OT%demo\fo\xsl\fo\links.xslを改善した旨を書きましたが、今日はその具体例を少しだけ示します。 改善前のlinks.xslの中には、Relationship Tableによるリンクを処理するための以下のようなコードがあります。 %DITA-OT%demo\fo\xsl\fo…

PDFの関連リンク生成の問題に書いたとおり、DITA-OTの「関連リンク」の出力には、リンクの種類が判別できないという問題があります。 %DITA-OT%demo\fo\xsl\fo\links.xslを修正することにより、下図のようにリンクの種別ごとにタイトルを出力することに成功…

関連リンクには、(1) parent/childリンク、(2) Relationship Tableによるリンク、(3) related-linksによるリンクの3種類があります。DITA-OTによりPDFを生成した場合は、「関連リンク」というタイトルの下にこれら3種類のリンクがすべて表示され、リンクの種…

DITA-OTを使ってPDFを生成するときに、トピック末尾の関連リンクを生成するために、DITA-OT内部でどのような処理が行われるかについて説明します。 結合済みDITAファイルの構造 DITA-OT処理フローの中で、topic mergeのステップにより出力されるXMLファイル(…

Yahoo! Users Groupに面白いメッセージがポストされていました。 電子ブックのコンテンツをDITA-OTを使って生成する、というものです。epubというのは、ソニーのebook reader（リブリエの後継？）やiPhoneのStanzaというアプリで読めるフォーマットだそうで…

DITA-OT1.4.3でアンテナハウス XSL Formatterを使用するためのパッチが公開された旨、昨日（4/8)、YahooのDITA Usersグループのメーリング・リストで情報が流れました。パッチという言葉は不適切かもしれません。公開されたものの実態は、DITA-OT1.4.3の実行…

原因はわかりませんが、ワークアラウンドはわかりました。 修正前 <xsl:when test="$collectionType"> 修正後 <xsl:when test="string-length($collectionType)>0"> 修正前のコードは、$collectionTypeの値が空文字列ならば、条件式がfalseに評価されるはずです。しかし、なぜか$collectionTypeの値が空文字列でも条件式がtrueになって、この条件</xsl:when></xsl:when>…

XSLTについて詳しい方、是非、ヘルプをお願いします。 FO Plug-inの中の、トピックの末尾に「関連リンク」を生成するコードがおかしな動きをしています。「関連リンク」は、%DITA-OT%demo\fo\xsl\fo\links.xslによって生成されます。このlinks.xslの中に、以…

DITA-OTをカスタマイズするには、DITA-OTのアーキテクチャを十分理解しておく必要があります。DITA-OTのアーキテクチャを説明した文書は、sourceforge.netのWebサイトにあります。DITA-OTの処理フローは、以下の2つの大きなステージに分かれています。 Pre-p…

DITA-OTを使ってPDFを生成するとき、トピックの末尾に関連リンクを出力するか否かを指定することができます。関連リンクを出力するか否かを指定する方法は、PDFの形式（pdfまたはlegacypdf）と、DITA-OTの実行方法（Antスクリプトを使うか、dost.jarを使うか…

ある語句の代替語句の参照を促すには、indexterm要素の子要素としてindex-see要素を挿入します。 代替語句を索引に表示させるための、indextermおよびindex-see要素の書き方を下図に示します。 index-see要素で指定した語句は、親のindextermで指定した語句…