タグ別アーカイブ: DITA

DITA Festa 2017 Tokyo (2)

昨日 に引き続き、DITA Festa の話題です。

大人気であったユーザーパネルディスカッションのあとに、DCJ の専門部会である、WebHelp 研究部会の発表を弊社社員が担当しました。

その発表のなかで大きく取り上げていたものが、CIDM のTrend Survey 2017 です。
本日は Trend Survey についてご紹介いたします。

https://www.dclab.com/resources/surveys/dcl-cidm-trends-survey-2017

Trend Survey01

Trend Survey 2017 は米国で行われたアンケート調査で、様々な問いのアンケートに専門家が回答した結果を表しています。1900名の回答者、その職務は製作者、情報アーキテクター、コンテンツ戦略家といった方々が回答しています。
回答者の80%が製品マニュアルを手掛けています。

 

Trend Survey02
3年後にどのようなコンテンツ戦略を予定していますか?

このアンケート結果には、近年のモバイル端末のシェアの増加が反映されて、「モバイルデバイスへのサポートを改善する」が第一位となっています。
続いて、「Dynamic Delivery System を提供する」が第2位となっています。
Dynamic Delivery System とは,コンテンツ全体から必要なコンテンツのみをパブリッシングできるようにするシステムです。
例えば、コンテンツ全体から、PDF を出力する際にはこのコンテンツを使用する、HTML を出力する際にはこのコンテンツを使用する、といったコンテンツの細かい使い分けができます。
DITA はこの Dynamic Delivery 機能を備えています。

 

Trend Survey03
現在のコンテンツの問題点は何ですか?

このアンケート結果には、検索機能に改善が必要、コンテンツが多すぎて情報が見つからない、上位を占めています。
これらは検索機能についての問題点で、ユーザの求めるコンテンツを迅速に提供できることが強く求められているということです。
技術の進歩でドキュメントはその分増えていきますが、ドキュメントが増えても情報を探す時間を増やしたくはないのです。

この大きな問題を解決するのが HTML によるニーズに沿った検索機能の実装です。
HTML の様々な機能で、コンテンツの問題点をカバーしていけるからこそ、近年はHTML の需要が高まってきています。

続いて見てみると、Dynamic Delivery System やコンテンツ構造化の未対応という問題点があげられています。
これらは DITA で解決できます。

DITA で構造化したコンテンツで、HTMLで構築する WebHelp を作成してニーズに沿った検索機能や色々な機能を実装することでコンテンツの問題を改善していくことができるのです。

Trend Survey 2018 は現在調査中です。
結果が楽しみですね!

https://www.dclab.com/resources/surveys/dcl-cidm-trends-survey-2018

DITA に関して、弊社には DITA 専門の DITA サービス部門がございます。
ご相談がございましたら、DITA サービス部門へお気軽にお問い合わせください!

<< DITA Festa 2017 Tokyo (1)


DITA Festa 2017 Tokyo (1)

昨年12月、6日と7日の二日間にわたり第15回 DITA Festa が富士ゼロックス株式会社の本社にて開催されました。
スウェーデンの医療機器メーカー「Elekta社」の導入事例や関連ツールの紹介等、今回も盛りだくさんの内容で、120名様を超える方々にご参加いただきました。

そんな中で、最も注目を集めていたのがユーザーパネルディスカッションです。
サトーテクノロジー株式会社、日本電気株式会社、株式会社日立製作所、リコークリエイティブサービス株式会社、ブラザー工業株式会社、横河電機株式会社、そしてローランド ディー.ジー.株式会社の7社からご担当者をお招きして、予定調和なしのガチンコで DITA について語っていただきました。
どこぞのパネルディスカッションは予定調和ありあり、という話を聞いたことがあるのですが、DITA Festa ではそのようなことはやりません(笑)

DITA Festa 2017

アンケート結果を見ても「メリットのみならずデメリットも聞けて参考になった」「各社さまざまな課題があり、個別の状況に合わせたソリューションの選択が重要と感じた」「ユーザー視点での想定外のメリット、デメリットが大変参考になった」「自由な意見交換が良かった」「各社の状況と DITA への取り組み方の違いが分かりおもしろかった」「パネリストのみなさまがとても本音でお話されていてよかった」などなど、大半の方が肯定的な感想を持たれたようです。

あまりにも評判が良かったので、3月あたりにもう一度どこかで… という話もあるとかないとか(^^)

DITA Festa 2017 Tokyo (2) >>


DITA の便利ツール

DITA でオーサリングをする際、初めにコンテンツ構造の計画を立てていると思います。
そして計画に対しレビューを行い、コンテンツの全体を把握した後に DITA ファイルを作成。このファイルを作成する作業がなかなか大変。
しかも一度 DITA ファイルを作成してしまうと手直しがまた大変。
コンテンツは大量にあるのでファイルを探すだけで一苦労です。

この作業が自動化できたらいいな、そんなことを考えたことはありませんか?

その悩みを解消してくれるツールがこの「ATL to DITA」(仮)です。

1.Excel ファイルでコンテンツ構造の計画を立てます。
グループ(第一階層)や階層レベル、chunk、タイトル、メタデータの情報を記載していきます。

atl_excel

Excel 画面

2.ツールの画面で Excel ファイルや出力先などを指定します。

atl_gui1

ツール画面1

atl_gui2

ツール画面2

※画面は開発中のものです

3.出力先のフォルダに DITA ファイルが作成されます。

atl_out1

出力ファイル1

atl_out2

出力ファイル2

atl_out3

出力ファイル3

階層に応じたマップが生成され、トピックには予め Excel で記載したタイトルやメタデータが挿入されます。

atl_out4 atl_out5

4.計画に手直しが入った場合はもう一度ツールを実行してください。

如何でしょうか?ちょっとした機能ですが、なかなか便利ですよね!

このツールは Java、Ant、XSLT を組み合わせて構成しています。

atl_architecture

構成

皆様は日々の業務でこういうものがあったら便利なのにな、といったものはございますか?
こういった便利なツールのご要望がございましたらアンテナハウスまでご相談ください!


AH Formatter の海外での評価

XML 自動組版ソフトとして弊社の AH Formatter は高い評価をいただいているのですが、海外ではどう見られているのでしょうか。
競合ソフトとしては FOP や XEP といったものがよくあげられますが、海外ではどうなのでしょう。

1か月ほど前の話なのですが、YAHOO! GROUPS にある “DITA users group” にこんなタイトルの投稿がありました。

「Japanese PDF layout issues」

どうやら日本語組版で問題を抱えているようです。詳しい内容は
https://groups.yahoo.com/neo/groups/dita-users/conversations/topics/42731
を見ていただくとして、これに対していくつかのレスポンスがありました。
Formatter に関するところをキャプチャーしてみました。

20171024-1 「Antenna House を強く推奨する」と言ってくださっています。

もうひとつ20171024-2

「Antenna House Formatter を使うことがおそらく最高の解決策だ」

海外でもこうして高い評価をいただいています。うれしい限りです。
ちなみにこのサイトで “antenna house” を検索してみると山ほどの高評価をいただいていることが分かります。

DITA に限らず XML 自動組版に挑戦しようとされているのなら、是非弊社の Formatter を選択肢のひとつに加えていただきたいと思います。


DITA で WebHelp を作る

マニュアルを制作するにあたり「PDFよりもHTMLを優先したい」という声が最近増えて来ました。自動組版エンジン AHFormatter を開発している弊社としては、あまり面白くない話なのですが(笑)時代の流れには逆らえません。

タブレット端末やスマホがここまで浸透した今、固定レイアウトの PDF や紙マニュアルよりもリフロー型の HTML の方がニーズにマッチしているのでしょう。弊社でもレスポンシブな HTML の作成方法についてすでに研究を開始していますし、弊社の WEB サイトのレスポンシブ化もほぼ完了しています。

とは言え「紙マニュアルは絶対に必要。停電したときでも読めなければいけない。紙は最後の砦」このような、とあるプラントメーカー様の声もあります。

さて、そんな昨今ですが、DITA コンソーシアムジャパンの中に「DITA for WebHelp 研究部会」というものが立ち上がり、7月5日に最初のミーティングが行われました。

  • DITA から作成した WebHelp の実態を調査し、課題を明確にする
  • DITA から使い易い WebHelp を作るためのガイドラインを作成する
  • DITA から WebHelp 変換のプロトタイプを開発する

このような目的を掲げています。どのような研究成果が得られるか楽しみです。

CIDM(コンテンツマネジメントと情報開発のベストプラクティスに焦点を当てた会員組織)の調査によると、今年ついに HTML パブリッシングの方が PDF パブリッシングよりもわずかに多くなったようです。
この流れは確実に大きくなりますね。


構造化文書とは何か?

新年、明けましておめでとうございます。

弊社では、2016年の課題のひとつとして、構造化文書の普及促進に重点的に取り組む予定です。構造化文書とは、文書の構造をマークアップした文書のことです。

では、文書の構造とはなんでしょうか? どんな意義があるのでしょうか?

文書構造の一つに、階層構造があります。2015年の暮れにJEPAのebookpediaで「階層構造とは」という用語解説が発表されました。この用語解説は人気抜群なのだそうです。

ebookpedia「階層構造とは」

主に電子書籍の階層構造について説明したものですが、簡単に整理すると次のようになるでしょう。

1.階層構造とは、章・節・項のような、つまり、大見出し、中見出し、小見出しのような見出しをつけること

2.階層構造は、XHTMLの<section>, <h1>~<h6>のようなタグで付ける。

3.階層構造の見出しによって、文章の持つ意味や重要度を差別化でき、読み手に意味の重要度が伝わる。また、目次を作ることができる。

4.タグに対して、スタイルシート(CSS)で重み付けと視覚的表現を紐づける。CSSを書き換えることで、見出しの色やフォントを切り替えられる。

この用語説明で、階層構造とはなにか? どんな意義があるかが大雑把に分かります。電子書籍のような簡単な出版物では、この程度の理解で十分かもしれません。しかし、電子書籍についていえば、eboookpediaでも少し触れられていますが、階層構造のような簡単な概念さえ、様々な見解があって必ずしも完全に合意されているわけではないようです。

文書の著者・編集者・制作者は、何らかの構造を念頭に置いているでしょう。これを暗黙ではなくて、明示的なルールでマークアップしたときに、構造化文書となります。タグはマークアップ手段のひとつです。

ところで、階層化以外の構造もあります。例えば、DITA(Darwin Information Architecture)では、技術文書を対象にして、構造についてもっと高度に定義しています。高度な構造は作成に手間がかかりますが、それなりの効果もあります。DITAにおける構造については、後日別途検討する予定です。

続きは:
1. あらゆる文書には構造がある?
2. 多くの文書は目的に応じた構造を持つ。その構造を明示化したのが構造化文書

関連ブログ(CASブログ)
CAS記法のマークアップがなぜ必要なのかー図版とキャプションの例
コンテンツの構造化とは何か? 構造化の目的、手段は? Word文書のスタイル付けとマークアップの関係

[参考資料](用語解説)
1.マークアップとは
2.DITA


「ここだけ」の実践DITAセミナー

おはようございます。
昨日はDITAオーサリングツールXMetaLV7.0を紹介したつながりで、今月開催されるDITAセミナーについて、紹介します。

「ここだけ」の実践DITAセミナー

12月7日にDITAセミナーを開催します。今回もナビックスさんとの共催です。
「ここだけ」の実践DITAセミナーは毎回人気で、いつも募集定員がいっぱいになってしまいます。ありがたいことだと思うと同時に、DITAへの関心の高さには驚いてしまいます。
今回は「多言語展開を見据えたDITA」「多言語組版の基礎知識」の2本立てのセミナーです。
やっぱりDITAと言えば多言語がキーワードのひとつになりますね。
すでにお申込み数が定員を超えてしまったのですが、どうやら同じ内容で年明けにもう一度開催することになったようです。
今回お申込みできなかった方は定期的に弊社のサイトにお越しいただきチェックしてくださるとうれしいです。
●セミナー詳細
「ここだけ」の実践 DITA セミナー ~ DITA の多言語展開-翻訳手法と組版を学ぶ~
どうぞよろしくお願いいたします。


「DITAの不安」

昨日に引き続き、XML関連の営業担当です。
DITAに興味はあるがなかなか採用を決断することができない、という方もたくさんいらっしゃいます。
DITAフェスタで発表された事例紹介の中でも、DITA導入前に感じた不安の話が出てきました。いくつか代表的なものを抜き出してみましょう。
* ブック指向からトピック指向に変える必要がある
* DITAの考え方は従来の紙マニュアル(ブック指向)と異なっており、多くのライターがその考え方に慣れない
* 一つのタスクトピックに複数の手順を書くことができない
* 単一言語(日本語のみ)でも効果があるか?
* トピックを交換可能な部品としてとらえる必要がある
最後の「交換可能な部品としてとらえる」というのはもう少し具体的に言うと、「様々な形式で再構成される」「複数のメディアで利用される」「複数の製品のマニュアルで利用される」というようなことの可能性があるということを常に意識しながら執筆しなければならない、ということになるかと思います。
たしかにDITAというのは一度書いたトピックはとことんしゃぶりつくすという思想ですので、それを実現させるには今までよりも気を使わなければいけないこともあるでしょう。
さて、そんなDITAですが、エプソン・アメリカがDITA導入後3年間の定量的測定をしたところ次のような結果が出たそうです。
* 70-90%のプロジェクトからプロジェクトへの再利用率
* 50%のソース・コンテンツと改定履歴の調査時間の削減
* 4ヶ国語に対するフォーマット時間の短縮
* 40%の生産性の向上
* 70%の翻訳コストの削減
また農業機械メーカーのAGCOによると(82%が共通のエンジンなので)
* 15%のオーナーズ・マニュアル削減
* 18%のワークショップ・マニュアル削減
なのだそうです。
こんなにうまく行くケースばかりではないとは思いますが、ちょっと無視できない話ではあります。
それからDITAの利用率を地域別にまとめると、北米 72%、ヨーロッパ 22%、アジア 4% だそうです。さすがアメリカはフットワークが軽いですね。


「DITAの理由」

こんにちは。XML関連の営業担当です。
1ヶ月半ほど前になりますが、恒例のDITAフェスタが7月12日に開催されました。今回も100名を超える方々にご参加いただき、DITAへの関心の高さを再確認することができました。
今までのDITAフェスタでは「トピックって何?」「conrefって何?」みたいなDITAの仕様の話が散見されましたが、今回は事例紹介中心の内容となり、参加いただいた方からも「事例の話がたくさん聞けてよかった」という声を多数いただきました。
当然「最近DITAの勉強を始めたばかりです」という方もいらっしゃいます。そういった方々にも満足していただけるにはどうしたらいいか、真剣に考えないといけませんね。
さてその事例紹介ですが、前半はエプソンアメリカ、AGCO、IBM、富士通ネットワークコミュニケーションズ、フリースケールセミコンダクター、シトリックスなどなど海外での事例の話で、後半はNECインフロンティアさん、日本電気さん、NECデザイン&プロモーションさんといった国内からの事例紹介となりました。
その中から、なぜDITAなのか、という部分を抜き出してみると…
* 翻訳コスト削減をしたかった
* 紙以外のメディア(iPad、WebHelpなどなど)にも対応する必要に迫られた
* オープンスタンダードな仕様で安心したかった
* ベンダーの縛りから逃れたかった(使っていたツールセットがもうサポートされていない)
* 執筆者によるばらつきをなくしたかった
* ファイル間のコピー&ペーストをやめたかった
といったあたりが共通項として浮かび上がるようです。
じゃあ、DITAを採用すればすべてがうまく行くのかというと、成功させるためにはそれなりの覚悟と努力が必要です。
明日は正反対のテーマ「DITAの不安」に触れてみたいと思います。


DITA超入門 ― まとめ

こんにちは。DITAの話は今日でいったんおしまいにします。
昨日までの4日間で漏れてしまった話題について、軽く紹介しておきます。
■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サービス(日本語サイト)


Pages: 1 2 Next