DITAをご検討中のお客様からconrefとconkeyrefについてよく分からないというお話を聞きます。まあ確かにconrefはともかくとしてもconkeyrefはピンときませんね。
今日は両者の違いについて少し書いてみます。両方ともフラグメント単位でのデータ再利用の方法なのですが、どのような違いがあるのか…

たとえばソフトウェアのマニュアルに「[開く]をクリックします」と出力したいとき、この文字列をトピックファイルにそのまま書いてしまってもいいわけですが、そうするとこのソフトウェアをタブレット端末用に移植したとき、「クリック」をすべて「タップ」に変更しなければいけません。
DITAの場合大量のトピックファイルにこのような記述があるはずですので、けっこうきつい作業になりそうです。

そこでconrefの登場です。conrefを使った場合、次のように記述することになるでしょう。

<p>［開く］を<ph conref=”names.xml#concept_names/operation_click” />します</p>

つまり「クリック」という文字列を直書きせずに、<ph>要素を使って「names.xmlを見に行け」とするわけです。そして別途作ったnames.xmlに次のような記述をしておきます。

<ph id=”operation_click”>クリック</ph>

するとDITA Open Toolkitが自動的に「クリック」という文字列に差し替えてくれることになります。将来タブレット端末対応したときに上記を

<ph id=”operation_click”>タップ</ph>

と書き換えれば、マニュアル全体の「クリック」がすべて「タップ」に置き換わってくれるわけですね。
大変便利で手軽なのですが、１つ問題があります。それはトピックファイルに

<p>［開く］を<ph conref=”names.xml#concept_names/operation_click” />します<p>

このように”names.xml”というファイル名を直書きしなければいけない点です。将来このnames.xmlのファイル名を変える必要が出てきたときは…
想像するだけでも嫌になってしまいますね。

そこで次に登場するのがconkeyrefです。conkeyrefを使った場合、トピックファイルには次のように書くことになるでしょう。

<p>［開く］ボタンを<ph conkeyref=”COMMON_NAMES/operation_click/”>します。</p>

で、今度はマップファイルに次のような記述をします。

<keydef href=”names.xml” keys=”COMMON_NAMES” />

“COMMON_NAMES”という文字列をキーにして、マップファイル経由でnames.xmlを参照に行きます。conrefのときとは違ってnames.xmlというファイル名を（トピックファイルではなく）マップファイルに追い出すことができました。
こうすることで将来names.xmlというファイル名を変更する必要があっても、マップファイルだけ修正すればいいことになります。

お手軽で分かりやすいconref、ちょっと面倒だけれど将来も安心なconkeyref。どちらが正解ということではなく、うまく使い分けできるといいですね。
最近は諸事情で「本社が移転！」なんていうこともちょくちょくあります。マニュアルに記載する本社住所もconrefとかconkeyrefを使っておいた方が安心かも(?)

Tweet

AIA (Aerospace Industries Association) Spring Tech Pubs Workshop

このワークショップは改訂データや情報の配信に関わっている産業界、DoD（Department of Defense、国防総省）サービス、および他の防衛機関が、デジタル出版や最新の技術への移行や、武装システムと訓練データの伝達に対応できるように情報交換の場として設立されました。

このイベントは今までは大盛況で、政府機関の議員や軍事産業の代表者が参加しました。内容はほとんどいつも技術的なものでした。今年は、sequestration（強制歳出削減）で知られるアメリカ政府による大幅な経費節減で、政府関係、軍事関係の人が誰も参加しませんでした。参加者の人数はだいたい80人で、例年に比べ残念な状態でした。

AIAイベントはフロリダ州で開催されたわけですが、フロリダ州といえば、2001年にアンテナハウスが海外展示会初出展をしたXML Conference & Exhibitionが開催された場所でもあります。あれから12年、開発に開発を重ね、AH Formatterは世界中の1800社以上の企業で導入されている組版ソフトウェアとなりました。

５月はAH Formatter V6.1のリリースがあり、その直前のワークショップでしたので、完成度の高い新機能のサンプルを披露して来ることができました。

アンテナハウス海外サイト
http://www.antennahouse.com/
http://rainbowpdf.com/

Tweet

この春アンテナハウスは２つのカンファランスに出展しました。４月にロードアイランドのプロヴィデンスで開催された Content Management Strategies/DITA North Americaと、五月にフロリダのクリアウォーターで開催された、2013 AIA (Aerospace Industries Association) Spring Tech Pubs Workshopです。

対照的だったのは、DITAイベントは確実に大成功だったのに対し、AIAイベントは参加者が少なかったことです。その違いは、一方はDITAに焦点を置いたカンファランスだったのに対し、一方は、S1000D（航空宇宙・防衛業界の国際的な技術文書仕様）に焦点を置いたカンファランスだったことです。S1000Dが、航空宇宙・防衛業界や、政府機関から指定された仕様である事に対して、DITAの導入は全く企業の選択で決められます。

CMS/DITA North Amrerica Conference 2013

DITAはまさにビジネス社会の要求を満たし、CMS/DITA North America conferenceは企業が、DITAを採用し続ける手助けをし、北アメリカにとどまらず、DITAは世界中に広まろうとしています。今年は世界17カ国から344名が参加。現在の世界的な経済情勢を考慮すれば、驚くべき実績ではないかと考えます。

４つのトラック、情報デザイン開発、テクニカルソリューション、マネジメント、先端テクノロジーで構成され、参加者にとってこれは非常に役立ちます。

このカンファファランスの最後のセッションでDITA-OT Panelが開催され、DITA-OT(DITA Open Toolkit)に関わっているキーパーソンが集い、OTの現在の状態、調査結果　そしてOTの今後についてディスカッションが行われ、大変興味深いものとなりました。(Robert Anderson (IBM Corporation) (DITA Technical Committee), Eliot Kimber (RSI Content Solutions)、 Frank Shipley (Componize Software)、Hal Trent (Comtech Services, Inc))

OTはボランティアによって支えられています。デフォルトのOTは多くの人が使うものですが、システムに組み込んでベンダーから提供されるツールキットもあります。OASISはDITA標準を維持管理しますが、OTに関わってはいません。基本的に３人の開発者がOTを開発しています。OTはSource Forgeにありダウンロード可能です。開発者はGithubを使っています。IBMが初期のコードを貢献、寄与しました。OTの開発やドキュメンテーションなどのボランティアは大歓迎です。Robertは、OTの開発に関わってきた観点から発言をし、EliotはOTのプラグインをビルドした経験を語り、Frankはベンダーとして、システムにOTを組み込んだ経験を、HalはOTのトレーニング教育について語りました。１つ問題なのはDITA OTを正式に管理する組織がないということ。このことはDITAの成功を左右する重大な問題だと考えます。本来の彼らの仕事がもちろん優先するストレスの中、少ない人数のボランティアが偉大な仕事をしています。

アンテナハウスはDITA Open Toolkit で使用する PDF出力用の新しいプラグインを用意しています。是非お試しください。

アンテナハウス海外サイト
http://www.antennahouse.com/

http://rainbowpdf.com/

Tweet