カテゴリー別アーカイブ: XML-DITA

XMetaL 8J(XMetaL日本語版)紹介セミナー 報告

8月30日にアンテナハウス、アートダーウィン主催、富士ゼロックス協賛でXMetal Author Enterprise 8Jの紹介セミナーを開催しました。
ほぼ満席状態となり、暑い中をご参加くださった皆様には感謝申し上げます。

最初のセッションでは「DITA入門」と題し、DITAの特徴、特にコンテンツ再利用の機能について力を入れてお話させていただきました。以前このブログでも触れさせていただきましたが、conrefやconkeyrefあたりの話ですね。
この機能を使いこなすことができたら立派なDITAマニアということになると思います。

2番目のセッションは「XMetaL V8 日本語版紹介」です。ここでも再利用の話をさせていただきました。
conrefやconkeyrefを使うためにどのような操作をするのか、というような説明をしたのですが、最後の最後、conkeyrefのデモでずっこけてしまいました。ご参加者の皆様、申し訳ありませんでした。
アンケートでも「もっとこうした方が良かったのでは?」というご意見を多数いただきました。少々反省しています。

最後のセッションは「XMetaL編集機能のカスタマイズ方法」です。実際の業務でXMetaLをより使いやすくするにはどうすればいいのか、というのがテーマです。
私も知らなかったのですが、C#でロジックを書ければXMetaLの挙動を相当大きくカスタマイズできるんですね。
ご参加いただいた方もカスタマイズにご興味をお持ちの方が大勢いらっしゃいました。

さて、肝心のXMetaL 8Jですが、ここ2~3日のうちに正式リリースされるとの情報が入っています。ご期待ください。

XMetaL 製品ページ(https://www.antenna.co.jp/xmetal/


conrefとconkeyref

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>

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

<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を使っておいた方が安心かも(?)


海外出展レポート AIA Spring Tech Pubs Workshop

AIA (Aerospace Industries Association) Spring Tech Pubs Workshop

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

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

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

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

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


海外出展レポート CMS/DITA North Amrerica Conference 2013

この春アンテナハウスは2つのカンファランスに出展しました。4月にロードアイランドのプロヴィデンスで開催された 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名が参加。現在の世界的な経済情勢を考慮すれば、驚くべき実績ではないかと考えます。

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

このカンファファランスの最後のセッションで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に関わってはいません。基本的に3人の開発者がOTを開発しています。OTはSource Forgeにありダウンロード可能です。開発者はGithubを使っています。IBMが初期のコードを貢献、寄与しました。OTの開発やドキュメンテーションなどのボランティアは大歓迎です。Robertは、OTの開発に関わってきた観点から発言をし、EliotはOTのプラグインをビルドした経験を語り、Frankはベンダーとして、システムにOTを組み込んだ経験を、HalはOTのトレーニング教育について語りました。1つ問題なのはDITA OTを正式に管理する組織がないということ。このことはDITAの成功を左右する重大な問題だと考えます。本来の彼らの仕事がもちろん優先するストレスの中、少ない人数のボランティアが偉大な仕事をしています。

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

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

http://rainbowpdf.com/


DITA Open Toolkitパネルより:DITA OTの歴史・開発はどのように行なわれているか?

DITAでドキュメントを制作するとき、DITAコンテンツを出版(パブリッシュ)するのに重要な役割を占めているのがDITA Open Toolkit(DITA OT)です。

DITA OTはもともとはIBMが開発したものですが、DITAの仕様がOASISに寄贈されたとき、同時にSourceforgeでホストするオープンソースプロジェクトとなりました。

DITA OTについての現状や今後について、2013年4月に開催されましたCMS/DITA North Americaの最後にパネルディスカッションが行なわれました。

なお、パネルに先立って、有識者(275人)に対するアンケートが行なわれています。その結果では、
(1)DITA OTをサポートする組織はどこか?
・最も多かったのがボランティア:約180人。2位がIBM:約175人。

(2)DITA OTの入手方法
・最も多かったのがソフトウェアベンダが提供するデフォルト版:約140人強。2位がSourceforgeより入手:約130人弱。

などとなっています。

パネルの内容について主催者による録音を入手しましたので、以下に、簡単に紹介します。最初の発言者は、IBMのRobert Anderson氏です。

◆Anderson氏の発言要旨

DITA OTはOASISの完全外部にある独立のオープンソース・プロジェクトである。

IBMがDITAの仕様をOASISに贈与したとき、同じくDITA OTも放棄した。OTはSourceforgeに移され、しばらくの間はIBMの開発者が中心になって開発していた。その後、Jarno Elovirta(サイテック社)と、Deborah Pickettがかなり活動していた。Deborahは会社の管理上の事情で最近は活動していない。現在、JarnoとRobert Andersonが主な担当者である。この2年間の進歩は主にJarnoが週末にプログラムしたものである。ダウンロードはSourceforgeに残っているが、ソース管理は使いやすいGitHubに移している。

ドキュメントは最初のころはとても悪かった。最近改良された。

1年程前からKristen Eberleinがドキュメントを見ている。だいぶ洗練された。

・DITA OTはベンダー経由でエンドユーザに渡ることが多い。

・できるだけ後方互換性を保つようにしている。

・一部の不要なコードや速度低下の原因になるコードは取り除き始めているが、その変更点はリリースノートに記述する。

・ユーザーコミュニティからのリクエストはJarnoがとりいれる。

・月次のテストビルドで人々がチェックできるようにしている。障害の報告などがあったら直す。

・6ヶ月毎のパッケージ・リリースを目標とする。6月、12月。

◆参考

[1]GitHub: DITA Open Toolkit dita-ot (DITA Open Toolkit) GitHub

[2]SourceForge:DITA Open Toolkit DITA Open Toolkit Free Development software downloads at SourceForge.net

《注意》

DITA OTはプラグイン・アーキテクチャになっており、3rdパーティが様々なプラグインを追加できる。アンテナハウスは、独自のPDF用プラグインを開発して公開している。

https://www.antenna.co.jp/AHF/ahf_samples/#pdf5サンプル集 – AH Formatter V6


観光

JoAnnさんにはお忙しい中ハードなスケジュールでDITAの講演を行っていただきました。日本を少しでも楽しんで頂きたく、帰りのフライトまでの半日を観光にご案内しました。
今まで数回日本にいらしたことがあり、浅草を訪れたのも2回目だったのですが、20年ほど前の当時と何も変わっていない町並みに感激されていました。雷門を前にして右手を見ますと、巨大なスカイツリーの全容が現れました。これは今回初めての光景です。
まずは仲見世通りでショッピング。お孫さんのお土産にポケモングッズが欲しいとのこと。そういったものはここにはないと思いますよ、と言おうとした矢先、あるではありませんか。誰も持っていないカードが欲しいのよ。それに日本から買ってきたって言ったら喜ぶに違いないとポケモンカードを手にしました。そういえば、何年か前アメリカのXMLカンファランスで出展した時も、Formatterの機能説明をしていたのが、いつの間にかポケモンの話を振られたことがあったなあと思いだしました。ポケモンってそんなに海外で人気なんですね。
ご自分用にも、江戸趣味小道具のお店でお気に入りを見つけ購入。なかなか渋いです。
浅草堂本堂でお参りをし、さて小腹がすいたところでうどん屋さんで腹ごしらえ。
タクシーの運転手さんがかっぱ橋道具街も行ってみるといいですよ。といっていたので
早速、次はかっぱ橋へ。行き当たりばったりで入ったお店で素敵な信楽焼きの一輪挿しをみつけました。1つとして同じ焼き上がりがない中で、少し灰かぶりのある趣のものを選んでいました。選び方は日本人より日本的なセンスです。
さすが日本一の道具専門の問屋街。調理器具から包材、塗り物食器なんでも品ぞろえが半端ではない。日本製の上等な包丁を見つけ、ご自分用に購入されました。もっと時間があったらなあと思いつつ、かっぱ橋道具街を後にしました。
JoAnnさん、是非また近いうちに日本にいらしてくださいね。3日間本当にありがとうございました。
■アンテナハウス海外サイト
http://www.antennahouse.com/
http://rainbowpdf.com/


DITA Festaの2日目

2月8日、DITA Festaの2日目が行われました。
* 海外DITA最新導入事例 DITA Europe2012視察報告(インフォパース 関根さん)
* 制作現場目線で見たDITA/CMS ~導入を通しての気づき~(横河電機 針ヶ谷さん、情報システムエンジニアリング 小川さん)
* 汎用製品を活用したDITA導入事例(PFUソフトウエア 竹森さん)
* 制作手法のひとつとしてのDITA(クレステック 碓井さん)
* DITAユーザ交流会 2013年度活動報告(横河電機 針ヶ谷さん)
といったアジェンダでした。
どれも興味深い話を聞けたのですが個人的にぶったまげたのは、PFUソフトウエア 竹森さんのお話でした。
ワープロ専用機、DocBook、FrameMakerを経てDITA導入に至るまでの話が最初にあり、続いてシステム環境の紹介がありました。
マップの設計やトピックの管理はExcel、リポジトリはSubversion、執筆は汎用テキストエディタを使っているとのことです。汎用テキストエディタのマクロ機能をフルに使って、できるだけ効率よく間違いのないタグ付けができるよう工夫されています。アンテナハウスはXMetaLというDITAエディタを販売しているので、こういったお話はあまりうれしくないのですが(笑)、それにしてもそこまでやるか!と関心してしまいました。要所要所で金沢の名所の紹介とかもあり、とても楽しかったです。
セッション後、竹森さんと少しお話させていただきました。「いや~、結構泥臭いことをしているんですよ」と謙遜されていましたが、プロトタイプをできるだけ安価に構築したいと考えていらっしゃる方には、とても参考になったはずです。実際竹森さんと名刺交換されている方がたくさんいらっしゃいました。
それから最後のDITAユーザ交流会のご報告にはちょっと考えさせられました。メーカが制作会社に制作依頼するとき費用はどのように算定するのがいいのか、というのが交流会の中での大きなテーマのようです。たしかにトピック指向のDITAの場合、今までのブック指向のものとは別の考え方を導入しないといけないですね。これってけっこう大問題かも。


DITA Festa 2013

おはようございます。海外営業グループからの報告です。
2月6日のDITA Workshopの開催に引き続きまして、2月7日は  DITA Festa 2013の第一日目が開催されました。アメリカのComtech Services社の代表であるJoAnn Hackosさんに再びお時間を割いていただきました。
DITAの導入は情報制作・出版プロセスの変革ともなり、様々な落とし穴もあって、導入ステップは注意深くすすめなければなりません。 これまでComtech社が実践した多数の経験に基づいて、成功するDITA導入プロセスと留意点についてお話を伺うことができました。
ツールを手に入れたらもう大丈夫だと思わないこと。DITA Open Toolkitはただの出発点であって、これで何でもできるわけではないこと。文書モデル作成の大切さ、既存の文書のうち何をリライトするのか、DITA用変換可能なのか、慎重に決めていかなくてはならないこと。そうするとそれを指揮決定するInformation Architectの存在は非常に重要になってきます。
プロジェクトを進める上で、企業からの協力、人材、トレーニングの必要性、マネジメント、適切なツール等が欠如していては導入の過程でつまずいてしまいます。落とし穴をしっかり認識して十分に準備をしていけば、必ず成功に導く事ができるということです。
参加者は、200名定員の会場をほぼ埋め尽くすほどの人気で、予想通り、Good Questionsが時間の許す限り出されました。中でも、Information Architectにはどうやったらなれるのかなど、現状の日本における切なる需要をなんとかしたい質問等がありました。お隣中国で近々、60名のInformation Architectを養成する講座を行う予定とかで、大変刺激になりました。

休憩の後は、(休憩といってもJoAnnさんは休憩してはいられませんでした。名刺を持った参加者の皆様が列を作っていましたので。)Antenna House からの海外DITA最新導入事例 DITA Europe2012の視察報告です。昨年秋のDITA Europeに参加し、聴衆してきた最新情報の中から、選りすぐりの事例を発表しました。

  • NokiaがDITA 1.2をフルに使いこなし、コンテンツ再利用率90%を実現した手法
  • 英国の王立薬学会が「英国国民医薬品集(BNF)」をDITAベースのプロセスに移行した理由と方式
  • DITA仕様の今後の動向(DITA1.3開発進捗、またDITA簡素化の検討など)

会を重ねるごとに、日本でのDITAへの関心の高まりを実感いたします。

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


DITAコンソーシアムジャパン主催 DITA Workshop!

2月6日、DITAコンソーシアムジャパン主催のDITA Workshopが開催されました。講師としてアメリカのComtech Services社の代表であるJoAnn Hackosさんをお招きしました。
JoAnnさんはDITAコンサルとしてとても有名な方で、毎年ヨーロッパとアメリカでCMSやDITA関連のカンファレンスを開催されています。

丸一日かけてのWorkshopでとても有意義なものでした。
「conditionalは何年も使っていると収拾がつかなくなるからkeyrefやconkeyrefを検討した方かいいかもよ」とか「トラブルシューティング トピックタイプを作るようOASISに強く働きかけている」などなど…
その他にも、情報をDITA化するにあたってどのように整理したらいいか、など参考になる話が盛りだくさんでした。
中でも一番面白かったのが、あるスマートフォンメーカのマニュアル制作の事例でした。
まず、DITA導入前のマニュアルを提示しながら「”About this guide”なんていう誰も読まないものを載せる必要があるのか?」(ここで参加者一同苦笑い)とか「このマニュアルにはGetting startedが2つあるけどそれでいいの?」などと、もっときちんと情報整理しないとだめだということを強く主張されていました。で、そのあとにDITA導入後のマニュアルを見たのですが、なんとページ数が半分に減っているのです。
ここでJoAnnさんが言いたいのは、「DITAを導入すればいいっていうものではなく、情報を整理しなきゃだめ」ということです。
今、多くの企業がDITA導入を検討されています。けれど(DITA以前に)過去の悪い慣習をばっさりと切り落とす覚悟ができているのか、ということが問われているのだと思いました。「DITAを導入して今までと同じマニュアルが作れるのだろうか」という不安を多くの方がお持ちだと思うのですが、そうではなく「今までと同じマニュアルでいいのだろうか」を出発点にしようというのがJoAnnさんの考えですね。
それから「製品が何か」ではなく「ユーザが知りたいことは何か」という視点で書かないといけないという話はまったくごもっともでした。
今回のWorkshop、コンソーシアムの会員向けのもので、残念ながら非会員の方は参加できませんでした。今後もこういったWorkshopやセミナーが開催されるはずですので、DITA導入を検討されている企業さんにはぜひ会員になっていただきたいと思います。


「学術情報XML推進協議会」入会

アンテナハウスは、「学術情報XML推進協議会」(略称:XSPA)へ昨年末に入会いたしました。
1月31日には、XSPAの第一回総会が開催されました。
欧米の学術出版においてはXMLが標準となっており、
①論文データが構造化され、電子ジャーナルにおけるプレゼンテーションの高度化が実現する。
②リンクやセマンティック・タグの付与、図表など論文要素単位の配信、など加工・付加価値化が図れ る。
③メタデータの交換、アーカイブなど、標準化による流通促進がおこなわれる。
などの利点が生まれます。
学術出版においてXMLを普及していくために、昨年6月に「学術情報XML推進協議会」が発足されました。
XSPAでは以下の3つの分科会が設置され、XMLの理解と普及を目指します。
①JATS 規格検討分科会
国際的に使われているJATSへの建設的な提案を行う。
②J-STAGE 制作実務分科会
J-STAGEのFULL-XMLなど各プラットフォームを効率的に制作する方法を研究する。
③J-STAGE/PMC XML 相互交換分科会
J-STAGEとPMCを総合に変換活用するためのスタイルシートを作成する。
各分科会の本格的な活動は4月以降になると思いますが、アンテナハウスは②のJ-STAGE 制作実務分科会へ参加してFULL-XML化されたJATSの組版を支援していきたいと考えてます。
過去のブログでも紹介しましたが、アンテナハウスではJATSを組版するスタイルシートを提供してます。
詳細、スタイルシートの入手は、
https://www.antenna.co.jp/AHF/ahf_samples/20120612-JATS.html
こちらからどうぞ。
学術情報誌(ジャーナル)を記述す為のXMLタグセットがJATSになります。
先日開催されたPAGE2013でもJATSに関心をお持ちの印刷会社様が来場されてました。
JATSは、今後注目される規格になると思います。
アンテナハウスはXSPAと共にJATSの普及に努めてまいります。


Pages: Prev 1 2 3 4 5 6 7 8 9 10 11 12 Next