ツイート
2013年03月01日
観光
JoAnnさんにはお忙しい中ハードなスケジュールでDITAの講演を行っていただきました。日本を少しでも楽しんで頂きたく、帰りのフライトまでの半日を観光にご案内しました。
今まで数回日本にいらしたことがあり、浅草を訪れたのも２回目だったのですが、２０年ほど前の当時と何も変わっていない町並みに感激されていました。雷門を前にして右手を見ますと、巨大なスカイツリーの全容が現れました。これは今回初めての光景です。
まずは仲見世通りでショッピング。お孫さんのお土産にポケモングッズが欲しいとのこと。そういったものはここにはないと思いますよ、と言おうとした矢先、あるではありませんか。誰も持っていないカードが欲しいのよ。それに日本から買ってきたって言ったら喜ぶに違いないとポケモンカードを手にしました。そういえば、何年か前アメリカのXMLカンファランスで出展した時も、Formatterの機能説明をしていたのが、いつの間にかポケモンの話を振られたことがあったなあと思いだしました。ポケモンってそんなに海外で人気なんですね。
ご自分用にも、江戸趣味小道具のお店でお気に入りを見つけ購入。なかなか渋いです。
浅草堂本堂でお参りをし、さて小腹がすいたところでうどん屋さんで腹ごしらえ。
タクシーの運転手さんがかっぱ橋道具街も行ってみるといいですよ。といっていたので
早速、次はかっぱ橋へ。行き当たりばったりで入ったお店で素敵な信楽焼きの一輪挿しをみつけました。１つとして同じ焼き上がりがない中で、少し灰かぶりのある趣のものを選んでいました。選び方は日本人より日本的なセンスです。
さすが日本一の道具専門の問屋街。調理器具から包材、塗り物食器なんでも品ぞろえが半端ではない。日本製の上等な包丁を見つけ、ご自分用に購入されました。もっと時間があったらなあと思いつつ、かっぱ橋道具街を後にしました。
JoAnnさん、是非また近いうちに日本にいらしてくださいね。３日間本当にありがとうございました。
■アンテナハウス海外サイト
http://www.antennahouse.com/
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2013年02月28日
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の場合、今までのブック指向のものとは別の考え方を導入しないといけないですね。これってけっこう大問題かも。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2013年02月27日
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/
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2013年02月26日
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導入を検討されている企業さんにはぜひ会員になっていただきたいと思います。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2013年02月19日
「学術情報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を組版するスタイルシートを提供してます。
詳細、スタイルシートの入手は、
http://www.antenna.co.jp/AHF/ahf_samples/20120612-JATS.html
こちらからどうぞ。
学術情報誌（ジャーナル）を記述す為のXMLタグセットがJATSになります。
先日開催されたPAGE2013でもJATSに関心をお持ちの印刷会社様が来場されてました。
JATSは、今後注目される規格になると思います。
アンテナハウスはXSPAと共にJATSの普及に努めてまいります。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2012年12月01日
「ここだけ」の実践DITAセミナー
おはようございます。
昨日はDITAオーサリングツールXMetaLV7.0を紹介したつながりで、今月開催されるDITAセミナーについて、紹介します。
「ここだけ」の実践DITAセミナー
12月7日にDITAセミナーを開催します。今回もナビックスさんとの共催です。「ここだけ」の実践DITAセミナーは毎回人気で、いつも募集定員がいっぱいになってしまいます。ありがたいことだと思うと同時に、DITAへの関心の高さには驚いてしまいます。
今回は「多言語展開を見据えたDITA」「多言語組版の基礎知識」の２本立てのセミナーです。
やっぱりDITAと言えば多言語がキーワードのひとつになりますね。
すでにお申込み数が定員を超えてしまったのですが、どうやら同じ内容で年明けにもう一度開催することになったようです。
今回お申込みできなかった方は定期的に弊社のサイトにお越しいただきチェックしてくださるとうれしいです。
●セミナー詳細
「ここだけ」の実践 DITA セミナー ～ DITA の多言語展開－翻訳手法と組版を学ぶ～
どうぞよろしくお願いいたします。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2012年11月30日
XMetaL 7.0
おはようございます。
本日はバージョンアップした、DITAオーサリングツールXMetaLを簡単に紹介します。
大幅値下げ対応！
DITAのオーサリングツールとして必ず名前のあがるXMetaLですが、11月1日より価格改定を行いました。けっこう大きな値下げです。XMetaL V7.0 から DITA1.2 規格を正式にサポート
7.0の目玉としてはなんといっても「DITA1.2規格の正式サポート」です。
6.0でもパッチを当てることでDITA1.2をある程度サポートできましたが、ついにフルサポートされました！
それからDITA Open Toolkit 1.5.4を搭載しています。
今までは1.4.2という、ちょっとバグの多いOTが搭載されていたのでようやく一安心といったところです。
メニューが日本語化されていないのがちょっとあれなのですが、General Task, Machine Industry Task, DITA Learning Topicといった新しいタイプのテンプレートが追加されていたり、keyrefやconkeyrefにもちゃんと対応できていたり、ますます使いやすくなっています。
ご興味のある方はぜひ体験版を使ってみてください。
製品紹介
XMetaL Author Enterprise 7.0
体験版の入手
http://xmetal.com/content-support-downloads/
お問い合わせ
xmetal@antenna.co.jp
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2012年11月29日
海外出展レポート（２）
前回に続きまして、残りの3つを紹介します。
Frankfurt Book Fairは、15世紀から存在しているそうです。古い歴史を持っていますね。さてアンテナハウスにとっては今年は4回目の参加となります。弊社のパートナー会社であるDoctronicのブースで展示を行いました。もっぱら関心はePubs/e-booksに寄せられています。ここではクラウド型汎用書籍編集・制作システム（CAS-UB）のデモを行いました。
The tekom annual conference in Weisbaden, Germanyは、tcworldとの協賛で開催され、テクニカルコミュニケーションの最大規模のグローバルイベントであり、市場でもあります。この会場では、アンテナハウスは大きなブースを構えました。3,700人の参加者があり、その内の450人はドイツ国内からです。ここでも非常に沢山のユーザがFormatterを導入していることを実感してきました。アンテナハウスにとって、6回目の出展となります。
DITA-Europe in Frankfurt, Germanyは、今年参加した最後のカンファランスとなります。このDITA Europeは特に楽しく有意義な機会となりました。なぜかといいますと、出展社はアンテナハウスのパートナーが多数を占め、また、参加者の多数がアンテナハウスのお客様だからです。情報交換、近況報告の非常に良い機会となりました。ここでは、ブース展示と、プレゼン発表の両方を提供し、PDF比較テストのページ出力の自動化というタイトルで発表を行いました。またアンテナハウス日本からも、DITAコンソーシアムジャパンの派遣団の一員として参加しました。
数年にわたって、アンテナハウスは、弊社のソフトウェアのリリース向けのレベルダウンテスト用に、社内用のテストシステムを開発してきました。この自動PDF比較テストツールは実際、数か月間、社内で使用しました。このツールを使うことにより、より正確な精度で比較ができ、テストにかかわる人件費の90%以上の大幅削減が可能であることを発表しました。多数の方が聴講されました。
DITA Europeはアンテナハウスの6回目の参加となります。この短い2か月間に7つもカンファランスが集中するのは本当に面白い事実ですが、来年もたぶんこのスケジュールで行くのでしょう。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2012年09月07日
「DITAの不安」
昨日に引き続き、XML関連の営業担当です。
DITAに興味はあるがなかなか採用を決断することができない、という方もたくさんいらっしゃいます。
DITAフェスタで発表された事例紹介の中でも、DITA導入前に感じた不安の話が出てきました。いくつか代表的なものを抜き出してみましょう。
* ブック指向からトピック指向に変える必要がある
* DITAの考え方は従来の紙マニュアル（ブック指向）と異なっており、多くのライターがその考え方に慣れない
* 一つのタスクトピックに複数の手順を書くことができない
* 単一言語（日本語のみ）でも効果があるか？
* トピックを交換可能な部品としてとらえる必要がある
最後の「交換可能な部品としてとらえる」というのはもう少し具体的に言うと、「様々な形式で再構成される」「複数のメディアで利用される」「複数の製品のマニュアルで利用される」というようなことの可能性があるということを常に意識しながら執筆しなければならない、ということになるかと思います。
たしかにDITAというのは一度書いたトピックはとことんしゃぶりつくすという思想ですので、それを実現させるには今までよりも気を使わなければいけないこともあるでしょう。
さて、そんなDITAですが、エプソン・アメリカがDITA導入後3年間の定量的測定をしたところ次のような結果が出たそうです。
* 70-90%のプロジェクトからプロジェクトへの再利用率
* 50%のソース・コンテンツと改定履歴の調査時間の削減
* 4ヶ国語に対するフォーマット時間の短縮
* 40%の生産性の向上
* 70%の翻訳コストの削減
また農業機械メーカーのAGCOによると（82%が共通のエンジンなので）
* 15%のオーナーズ・マニュアル削減
* 18%のワークショップ・マニュアル削減
なのだそうです。
こんなにうまく行くケースばかりではないとは思いますが、ちょっと無視できない話ではあります。
それからDITAの利用率を地域別にまとめると、北米 72%、ヨーロッパ 22%、アジア 4% だそうです。さすがアメリカはフットワークが軽いですね。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2012年09月06日
「DITAの理由」
こんにちは。XML関連の営業担当です。
1ヶ月半ほど前になりますが、恒例のDITAフェスタが7月12日に開催されました。今回も100名を超える方々にご参加いただき、DITAへの関心の高さを再確認することができました。
今までのDITAフェスタでは「トピックって何？」「conrefって何？」みたいなDITAの仕様の話が散見されましたが、今回は事例紹介中心の内容となり、参加いただいた方からも「事例の話がたくさん聞けてよかった」という声を多数いただきました。
当然「最近DITAの勉強を始めたばかりです」という方もいらっしゃいます。そういった方々にも満足していただけるにはどうしたらいいか、真剣に考えないといけませんね。
さてその事例紹介ですが、前半はエプソンアメリカ、AGCO、IBM、富士通ネットワークコミュニケーションズ、フリースケールセミコンダクター、シトリックスなどなど海外での事例の話で、後半はＮＥＣインフロンティアさん、日本電気さん、NECデザイン&プロモーションさんといった国内からの事例紹介となりました。
その中から、なぜDITAなのか、という部分を抜き出してみると…
* 翻訳コスト削減をしたかった
* 紙以外のメディア（iPad、WebHelpなどなど）にも対応する必要に迫られた
* オープンスタンダードな仕様で安心したかった
* ベンダーの縛りから逃れたかった(使っていたツールセットがもうサポートされていない）
* 執筆者によるばらつきをなくしたかった
* ファイル間のコピー＆ペーストをやめたかった
といったあたりが共通項として浮かび上がるようです。
じゃあ、DITAを採用すればすべてがうまく行くのかというと、成功させるためにはそれなりの覚悟と努力が必要です。
明日は正反対のテーマ「DITAの不安」に触れてみたいと思います。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2012年09月04日
Best Practice 2012 Monterey, California
Best Practice 2012は、DITAに焦点を置き、情報開発、トレーニング、およびサポートの管理者のための毎年恒例のカンファランスです。今回はカルフォルニア、モントレーにて9月10日から3日間に渡って実施される予定です。アンテナハウスは今年も参加してきます。
アジェンダを見ますと、 IBM Corporation、 Microsoft Corporation、Intel Corporation、Freescale Semiconductor, Inc. など業界をリードする北米の会社の発表が目立ちます。また、Comtech Services, Inc. Hewlett-Packard Company、Medtronic. Inc.、easyDITA、 Quark, Inc.などベンダーによる参加、ユーザの要望改善のためのアイデアをだし、具体的な新機能の開発ロードマップの発表が行われます。 一方、グループセッションでは、University of California、University of Wisconsin、Michigan State Universityなど大学教授が参加し、学術研究者や業界の専門家がお互いのニーズを満たすべく協力し情報提供のための講演が行われます。
アジア系企業としては中国のHuawei Technologies のインフォメーションアーキテクトの発表があります。ドキュメントの再利用によってマニュアルの最適化に成功した内容です。DITAが中国でどのくらい普及しているのか大変興味深いです。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2012年06月13日
「ここだけ」の実践DITAセミナー」
こんにちは。XML関連の営業担当です。
先週6月8日に「「ここだけ」の実践DITAセミナー」が開催されました。
このセミナーはナビックス、エクスイズム、アンテナハウスの共催で、今回で３回目になります。毎回多くの方にご参加いただきありがたく思っています。
当初、比較的少人数の参加者募集で行こうと計画を立てたのですが、いざふたを開けてみると40名様を超えるご参加があり、DITAへの関心は相変わらず高いものがあるなと、改めて感じたしだいです。
会場が少々手狭で、ご参加いただいた方には申し訳なく思っています。
セミナーですが、まずは「レガシーデータのDITA移行」と称して、既存データをDITAトピックに移行させるにあたり、その考え方や留意点の話がナビックスさんより行われました。これは個人的にも興味を持っていたテーマで、とても面白く聞くことができました。
次に「XMetaLを利用したDITA化の実際」ということで、これもナビックスさんからデモを中心に話があり、さすが、DITAに力を入れている会社さんだけあって、手慣れたものだなぁと感心しました。
最後に「DITA Open ToolkitによるPDF出力手法について」というテーマで、DITAをPDF化するためのプラグインの紹介やそのカスタマイズの方法を中心にアンテナハウスから話をさせていただきました。
質疑応答も盛んに行われ、回答者側があたふたする場面もあり(^^; 皆さんの熱意をビシバシと感じた１日でした。
ご協力いただいたアンケートを参考に4回目を企画しますので、ご興味のある方は是非ご参加ください。
投稿者 AHEntry : 09:00 | コメント (0) | トラックバック
2011年09月30日
DITA超入門 ― まとめ
こんにちは。DITAの話は今日でいったんおしまいにします。
昨日までの４日間で漏れてしまった話題について、軽く紹介しておきます。
■conref
昨日、条件処理を使ってコンテンツの一部を出したり出さなかったりをする方法を紹介しましたが、conrefは他のトピックの中のほんの一部を流用する機能です（フラグメント単位での再利用）。
製品名とかコピーライト表記をひとつのトピックファイルにまとめておいて、それを参照したりするような使い方をします。
■関連テーブル
どのトピックとどのトピックが関連し合っているのかを、それぞれのトピックの中ではなくマップの中に記述することができます。
トピックの中に関連情報を書くこともできますが、そうするとトピック間の関連関係が変更されたとき、トピックをこつこつと変更しなくてはなりません。それはそれで大変なので、マップに追いやってしまおうというわけですね。こうすることでマップだけを修正すればいいことになります。
■keyref
これは参照先をマップで解決しようという機能です。言葉で説明するのは難しいのですが、図式化すると次のようになります。
トピックの中には具体的な参照先は書かないで、マップに書いてしまおうということですね。
この機能は最新のDITA1.2仕様で追加された機能です。一度書いたトピックはできるだけ変更しなくてもいいようにしよう、可変データは可能な限りマップに追いやってしまおう、というDITAの設計思想が感じられます。
■DITA Open Tookit
せっかくマップやトピックが用意できたのに、これをどうやってHTMLやPDFにすればいいんだろう、という疑問がありますよね。大丈夫です。マップやトピックを処理して最終成果物を作ってくれる「DITA Open Tookit」という処理系がすでにあります。オープンソースで誰でも無償で使うことができます。入手先は下記です。
http://sourceforge.net/projects/dita-ot/
Open Toolkitは
* トピックファイルや画像などの素材を集める
* 条件処理を解決する
* conrefやkeyrefを解決する
* PDFやHTMLを作る
といったことを自動的にやってくれます。
■期待するレイアウトを実現するには
Open Toolkitを使えばPDFを作ることはできるのですが、あくまでもサンプル程度です。
これを期待したレイアウトにするにはそれなりのカスタマイズが必要になります。具体的にはPDF生成用のXSLTスタイルシートを作らないといけないのですが、弊社ではこのスタイルシート作成を請け負っていますので、ぜひご相談ください。
また、Open Toolkitには標準で自動組版エンジンが付いてくるのですが、正直な話、機能的にいまいちです。特にまじめに日本語組版をしたいということであれば、Antenna House Formatterが必須になります。
■お問い合わせ
DITA導入についてのお問い合わせをお待ちしております。
営業担当：小林(guten@antenna.co.jp)までよろしくお願いいたします。
では、5日間ありがとうございました。
最後に関連情報のリンクを少しだけ
OASIS DITA仕様(英語サイト)
DITA News(英語サイト)
DITAコンソーシアムジャパン(日本語サイト)
アンテナハウスDITAサービス(日本語サイト)
投稿者 taishii : 09:27 | コメント (0) | トラックバック
2011年09月29日
DITA超入門 ― 特殊化ってなに？
こんにちは。今週のDITA超入門も、残すところ、あと1回です。
今回は特殊化の話題です。
「DITA」の最初の「D」は（進化論の）ダーウィンの頭文字から来ていますが、ずばり、特殊化という機能があるがゆえにダーウィンの登場というわけです。
昨日までに紹介した機能は、名称や形こそ違え、似たようなことは昔から行われてきました。しかし特殊化という機能はおそらくDITAが最初ではないでしょうか。
■特殊化
特殊化とは既存の情報タイプ（トピックタイプ）を自分が好きなように拡張することです。たとえばdocbookでドキュメントを記述するとき、docbookの仕様の中で定義されている要素をそのまま使うしかありませんが、DITAの場合、都合のいいように要素を定義し直してもいいよ、と。もちろんある程度の制限というか作法のようなものは守らなければいけませんが。
生物は環境に適したものが生き延びる、というのが進化論の教えるところですが、情報タイプもあなたの環境に応じたものを用意していいですよ、というわけです。
次のような手順を出力したい、としましょう。
---
1. 電源スイッチを押す
2. [ラジオ]ボタンを押す
3. チューニングレバーを回す
---
もっとも初歩的な解決方法は次のようなトピックを用意することです。
＜topic＞
＜title＞ラジオの聴き方＜/title＞
＜body＞
＜ol＞
＜li＞電源スイッチを押す＜/li＞
＜li＞[ラジオ]ボタンを押す＜/li＞
＜li＞チューニングレバーを回す＜/li＞
＜/ol＞
＜/body＞
＜/topic＞
もちろんこれでも期待する結果は得られますが、では次のような例はどうでしょうか。
＜task＞
＜title＞ラジオの聴き方＜/title＞
＜taskbody＞
＜steps＞
＜step＞＜cmd＞電源スイッチを押す＜/cmd＞＜/step＞
＜step＞＜cmd＞[ラジオ]ボタンを押す＜/cmd＞＜/step＞
＜step＞＜cmd＞チューニングレバーを回す＜/cmd＞＜/step＞
＜/steps＞
＜/taskbody＞
＜/task＞
前者は番号付き箇条書きであることは分かりますが、どういった意味の箇条書きであるのかまでは分かりません。それに対して後者の場合、単なる箇条書きではなく、何かの「手順」であるということがはっきりと分かります。どちらの方が情報の質が上かと言えばもちろん後者ですよね。
このように、それまでは＜ol＞を使うしかなかった状況から、（情報の質を高めるために）＜steps＞を使える状況に拡張することが特殊化です。
あ、これは＜ol＞に限ったことではなく、別の要素だって特殊化の対象になりえます。
■情報タイプ（トピックタイプ）
DITAにはすでに下記の情報タイプ（トピックタイプ）が用意されています。
【汎用topic情報タイプ】
DITAの出発点となる情報タイプで、HTMLライクな要素が定義されています。この情報タイプを使えばだいたいどのようなマニュアルも記述できますが、先ほど述べたように情報の質という点では劣ります。
昨日までにいくつかのトピックサンプルを例示しましたが、すべてこの情報タイプで記述したものです。
【task情報タイプ】
操作手順を記述するのに特化した情報タイプです。どのような順番でどういう操作をすればどのような結果が得られるか、というようなことを記述しやすいようになっています。
この情報タイプは上記の汎用topic情報タイプから派生させた（特殊化した）ものです。
【concept情報タイプ】
「それは何か」に対する答えを記述するのに便利な情報タイプです。たとえば「製品の特徴」であるとか「ご使用の前に」とか...etc。上記のtask情報タイプでは記述できないコンテンツは大抵この情報タイプを使うことになるでしょう。
この情報タイプは上記の汎用topic情報タイプから派生させた（特殊化した）ものです。
【reference情報タイプ】
リファレンスマニュアルを記述するのに特化した情報タイプです。
この情報タイプは上記の汎用topic情報タイプから派生させた（特殊化した）ものです。
【glossary情報タイプ】
用語集を記述するのに特化した情報タイプです。
この情報タイプは上記のconcept情報タイプから派生させた（特殊化した）ものです。
おおよそこれらのすでに用意された情報タイプで事足りると思いますが、中にはそれでも不十分だということもあるでしょう。そのときは（上記の情報タイプから派生させる形で）自分で特殊化することになります。
今日の話を図式化すると次のようになります。
なんだか、いかにもダーウィンって感じですね。
特殊化については（それだけで数十ページ書けそうな話題なので）これ以上突っ込んだ話は他の参考書に任せますが、日本語の参考書としては
があります。
では、また明日。
投稿者 taishii : 09:30 | コメント (0) | トラックバック
2011年09月28日
DITA超入門 ― フィルタリング トピックを効率的につくる！
こんにちは。昨日に引き続きDITAのお話です。
昨日は（複数の）トピックとマップを使ってマニュアルを作るという話でした。この仕組みによってトピック単位でのデータ再利用が実現されるわけです。
ここで、ある製品Ａと別の製品Ｂとで充電の方法が「ほんの少しだけ」異なる場合を考えてみましょう。昨日の話の範疇で考えると「充電の方法-Ａ用.dita」と「充電の方法-Ｂ用.dita」のふたつを用意して、マップの中から必要な方のトピックを参照すれば無事解決です。もちろんこの方法で間違っていません。
ただ、「ほんの少しだけ」違うだけなのにトピックを丸ごとふたつに分けるのもなんだかな～、と思いますよね。
そこで条件処理（コンディショナルプロセシング）の出番です。
■条件処理（コンディショナルプロセシング）
条件処理には、大きく２つの機能があります（フィルタリングとフラッギング）。今日は、そのうちのひとつ、「フィルタリング」を紹介します。
●フィルタリング
ひとつのトピックファイルの中に複数の製品の情報を混在して書いておいて、マニュアル生成時にその時の条件によって、特定の情報を出力したり、出力しなかったり、をコントロールすることをフィルタリングといいます。具体例をあげましょう。
＜topic id="HowToCharge"＞
＜title＞充電の方法＜/title＞
＜body＞
：
：
＜p product="上位モデル"＞
充電が完了するのに「30分」程度かかります
＜/p＞
＜p product="下位モデル"＞
充電が完了するのに「60分」程度かかります
＜/p＞
＜p＞
充電中は電源を入れないでください
＜/p＞
：
＜body＞
＜/topic＞
ここには上位モデル用の充電時間と下位モデル用の充電時間が混在して書かれています。このまま何も考えずに処理すると両方ともマニュアル内に出力されてしまいます。
そこで、もうひとつ、ditavalファイルというものを用意します。上位モデル用の出力を得たい場合は次のような内容にしておきます。
＜val>
＜prop att="product" val="上位モデル" action="include" /＞
＜prop att="product" val="下位モデル" action="exclude" /＞
＜/val>
ここでは、
* product属性が「上位モデル」のコンテンツは出力してください
* product属性が「下位モデル」のコンテンツは出力しないでください
* その他は出力してください
ということを意味しています。
そしてマニュアルを作る時に、このditavalファイルを使ってくださいね、と宣言すると次のような出力が得られるわけです。
---
充電が完了するのに「30分」程度かかります
充電中は電源を入れないでください
---
見事に下位モデル用の記述が抜け落ちていますね。
こうすることで、「ほんの少しだけ」違うトピックを複数個作る必要がなくなるわけです。
この機能をうまく使えば、ひとつのトピックの中に「Windows向けとLinux向けの記述」であるとか「上級者向けと入門者向けの記述」であるとかを混在して書いてもいいことになりますね。
では、また明日。
投稿者 taishii : 09:27 | コメント (0) | トラックバック
2011年09月27日
DITA超入門 ― トピックとマップ 避けては通れないはじめの一歩
こんにちは。昨日に引き続きDITAのお話です。今日は、DITAの初めの一歩として避けては通れないトピックとマップについて触れてみます。
DITAではひとつのドキュメントを作るにあたり、（複数の）トピックと（ひとつの）マップを組み合わせて使います。
■トピック
トピックにはドキュメントのコンテンツを記述します。たとえば次のようになります。
＜topic id="GoalOfDITA＞
＜title＞DITAのめざすもの＜/title＞
＜body＞
＜p＞DITAの目的は次のとおりです＜/p＞
＜ul＞
＜li＞データ再利用性の向上＜/li＞
＜li＞ワンソースマルチユース＜/li＞
＜li＞翻訳の効率化
＜/ul＞
＜/body＞
＜/topic＞
なんだかどこかで見たことあるような..ないような...
そう、雰囲気的にはHTMLにそっくりです。とりあえずここまではあまりハードルは高くなさそうですね。
ひとつのトピックファイルにはひとつのトピック（話題）しか書かない、ということが推奨されています。ひとつのトピックファイルの中でだらだらといくつもの話題に触れるのはよしましょう、ということですね。そのため、ひとつのドキュメントを制作するにあたり必然的に複数のトピックファイルを用意することになります。
■マップ
上記の（複数の）トピックファイルをひとつにまとめることがマップの役割です。マップを使ってトピックの出力順やトピック間の階層構造を決めることになります。たとえば次のようになります。
＜map title="取扱説明書"＞
＜topicref href="はじめに.dita" /＞
＜topicref href="電源の入れ方.dita" /＞
＜topicref href="ラジオの聴き方.dita" /＞
：
：
＜/map＞
この例は超基本的な例です。この他にさまざまな機能が用意されています。個人的にはマップを制することがDITAを成功へ導く秘訣だと感じていますが、ま、最初の一歩としては上記で十分でしょう。
マップとトピックの関係を図式化すると次のようになります。
この図を見て分かるように、マニュアルの種類だけマップを作り、それぞれのマップから１セットのトピックファイル（群）を共有参照する、というのがDITAの基本的な考え方です。
■トピック指向の執筆
ワードやdocbookでマニュアルを書くときは、１つのファイルに１冊分のコンテンツを丸ごと記述することになりますが、DITAでは複数のトピックファイルに分割して記述することになります（モジュール化）。こうすることで各トピックの再利用性の向上を図るわけですが、このことにより、執筆の仕方を今までとは変えなくてはならないことがあります。
たとえば「ラジオの聴き方」を書いたトピックの中では「すでに述べた方法で電源を入れた後に・・・」という書き方は避けた方がいいでしょう。なぜならマップの書き方次第では「すでに述べた」とは言い切れないからです。後で述べるかもしれませんし、そもそもどこにも述べない可能性もあります。つまり文脈依存の書き方は避けた方がよい、ということになります。これをトピック指向と言います。
■ショートデスクリプションの奨め
トピック内にショートデスクリプション（要約）を書くことが推奨されています。たとえば次のようになります。
＜topic id="GoalOfDITA＞
＜title>DITAのめざすもの＜/title＞
＜shortdesc＞DITAによってマニュアル制作の効率化を望めます＜/shortdesc＞
＜body＞
＜p＞DITAの目的は次のとおりです＜/p＞
＜ul＞
＜li＞データ再利用性の向上＜/li＞
＜li＞ワンソースマルチユース＜/li＞
＜li＞翻訳の効率化＜/li＞
＜/ul＞
＜/body＞
＜/topic＞
こうすることでHTMLにした場合など、アンカー文字列にマウスホバーしたときに要約をポップアップさせたり、検索結果として要約のみをリストアップすることができるようになります。
とても小さなトピックの場合、要約を書くことによって本文に書くことがなくなってしまう、という心配もあるかもしれませんが、そのときは本文の方を空にします。それほど要約が重要視されているということですね。
各トピックの要約を読んだだけで製品の全体像がそこそこ分かってしまう、という形が理想的なのかもしれません。ですので、
＜shortdesc＞ここではxxxについて述べます＜/shortdesc＞
というような要約はご法度です。
では、また明日。
投稿者 taishii : 11:30 | コメント (0) | トラックバック
2011年09月26日
これ以上ないくらい分かりやすいDITA入門（当社比）
こんにちは。今日から5日間、XML関連営業担当からDITA関連のお話をさせていただきます。
これ以上分かりやすいDITA入門情報は他に無い、という文面を心がけますのでしばらくの間お付き合いください。
●DITAとは
ここ数年、日本でもDITAの話題が盛んになってきました。DITAはもともとIBMが策定したマニュアルを記述・管理するための仕様で、その後この仕様はOASISに寄贈され世界標準の仕様となり注目を集めています。
2008年に「DITAコンソーシアムジャパン(http://dita-jp.org/)」がアンテナハウス、ジャストシステム、日本アイ・ビー・エム、富士ゼロックスの４社が発起人として設立され、現在26の企業、団体が会員となっています。
年に2回のペースで「DITAコンソーシアムジャパン」主催のイベントが開催されていますが、毎回、参加者募集開始後ほんの数日で100名を超える方々からの応募をいただいていて、DITAへの関心度が非常に高いことをしのばせています。この状況は今後も続くものと思っています。
●DITAはどんなマニュアル、またはマニュアルのどの部分を作るのに効果的？
もともとマニュアルを記述・管理するための仕様ですので、各企業のマニュアル制作ご担当者はもちろんのこと、制作会社や翻訳会社も大きな関心を持たれているようですが、突然DITAと言われても、いったい何から手をつければいいのかとまどっていらっしゃる方も多いのではないでしょうか。
そのDITA仕様ですが、目的は次の3つです。
* データ再利用性の向上
* ワンソースマルチユース
* 翻訳の効率化
これらはどれも絡み合った話ですので、あえて3つに分けることもないかと思いますが、ともかくDITAはこれらを実現するために考えられた仕様です。つまり、次のような方々はDITA採用を検討する価値がおおいにあるということです。
* 似たような製品を複数製造しているけれど、それぞれの製品のマニュアルをすべて個別に作っている
-->大多数の共通箇所は１つにまとめたいよなぁ...
* 住所や電話番号・部署名が変わったとき、数多くのマニュアルを改修するのがめちゃくちゃ大変だった
-->ほんのちょっとした変更にはほんのちょっとしか汗を流したくないよなぁ...
* いままでは紙のマニュアルだけだったけれど、これからはHTMLでも作らないといけなくなった
-->紙マニュアルのデータをHTMLでも流用したいよね...
* 毎年マニュアル改訂があるけれど、翻訳にかける時間を短くしたいなぁ...
では、DITAという仕様を「採用しただけで」すべて一気に解決すのでしょうか。答はNo.です。ここを勘違いすると後で痛い目に遭います。
明日以降、これらのことにも触れながら、少し具体的にDITAの仕様を見ていくことにします。
欧米ではDITA採用がちゃくちゃくと進んでいます。DITAという黒船はすでにそこまで来ているんですね。
●参考URL
DITAとは (アンテナハウスDITAサービスより)