タグ別アーカイブ: DITA

DITAをPDFに(PDF5-ML)

昨日 は DITA を docx に変換する DITA-OT プラグインのことを書きましたが、やはりいまだにマニュアル系は PDF が主流です。

DITA-OT には DITA で書かれたインスタンスを PDF にするためのスタイルシート(プラグイン)が標準で入っているのですが、残念ながら機能的にしょぼくて、あまり積極的に使いたいと思うようなものではありません。多くの人がまず「日本語が文字化けするんだけど」という問題にぶつかります。

アンテナハウスはこれに替わるプラグインを公開しました。”PDF5-ML”といいます。
https://github.com/AntennaHouse/pdf5-ml

“ML”というのは”Multiple Language”の略で、その名のとおり多言語対応を得意としています。
ひとつの DITA トピックファイルの中に複数言語が混在することがありますが、このような場合でも言語毎のフォント選択をきっちり行うことができます。
DITA 採用時にぜひお試しいただければと思います。

アンテナハウスはこのプラグインのカスタマイズ作業も請け負っております。PDF 生成でお悩みの方はご一報下されば幸いです。


DITAからWord(docx)への変換

最近「DITA から Word へ変換することはできないか」というお問い合わせをいただくようになりました。
日本で英語マニュアルを作って、それを各国の販社に送り、販社側でローカライズするには Word が便利なのでしょう。

Word へ変換する DITA OTプラグインはあるにはあります。
https://github.com/jelovirt/com.elovirta.ooxml
しかし、もう2年くらいメンテナンスがされておらず、ちょっと商用では使えないレベルのものです。docx の仕様があまりにも難しいというのが理由のひとつだと思われます。
XSL-FO の仕様は PDF にすると500ページ程度に対して、Word の Open XML File Format の仕様は PDF でなんと6700ページ。全部読み切った人はいるのでしょうか(^^;

ところがところが、昨年アンテナハウスはこの変換プラグインを開発しちゃいました。しかもオープンソースで、どなたでも自由にお使いいただくことができます。
https://github.com/AntennaHouse/ah-wml

そして、来る3月6日に DITAコンソーシアムジャパン主催の「DITA Festa 京都」の開催が計画されているようで、その中で上記のようなことをテーマにしたセッションがあるみたいです。
関西方面でご興味がある方は今のうちに予定に入れておいてください。

DITA


海外出展情報 その2

Tekom 2018

The European Association for Technical Communication  (欧州技術通信協会)は、11月13日から15日までドイツのシュトゥットガルトで開催される TCWorld aka Tekom  という年次の会議を主催しました。Tekom Europe は、世界最大のテクニカルライターの専門家向けの協会です。

Tekom では、PDF が今日使用されている最も一般的なドキュメントフォーマットであり、PDF を中心としたアンテナハウスの製品には常に大きな関心が寄せられています。 アンテナハウスは、AH Formatter V6.6Office Server Document Converter V7.0PDFXML変換ライブラリV2.0web Interface for AH FormatterWeb Interface for OSDC Regression Testing System V1.4 などの製品を紹介しました。

Tekom の参加者のあいだでは、XSL-FO は最適な組版ストラテジーとして選択されていますが、またページ組版としてのCSSにも非常に興味が持たれています。 AH Formatter V6.6 では、CSS の機能が改善されました。また、Formatter と CSS の併用に興味がある開発者のために、弊社ウェブサイトで CSS ページ組版入門 第4版 を公開しています。またプリントオンデマンド版がAmazon.co.jp から販売開始されました。

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

http://rainbowpdf.com/


海外出展情報 その1

DITA Europe

昨年の11月5日から6日にかけて、アンテナハウスはオランダのロッテルダムで開催された CMS/DITA Europe でスポンサーとして参加しました。 第14回目にあたる Content Management Strategies/DITA Europe であり、2日間にわたって DITA に関する貴重な情報がふんだんに提供されました。会議では、参加者は Technology Test Kitchen と呼ばれるセッションで、発表者が新しい DITA ツールまたは CMS の使用方法を説明した後に、一緒に実地経験を積むことができました。

アンテナハウスは、DITA Open Toolkit 用の Antenna House PDF5-ML プラグイン を使用して、1つの DITA 文書に複数の言語をフォーマットする方法についてのデモを Technology Test Kitchen で発表しました。 PDF5-ML プラグインは AH Formatter と連携して動作するように設計されており、DITA Open Toolkit が提供するデフォルトの PDF プラグインよりも使いやすく、変更や管理が簡単で、尚且つパワフルです。 参加者は、PDF5-ML プラグインに大きな関心を示し、多言語ドキュメントを修正して PDF 出力を生成することがどれほど迅速かつ簡単であるかを体験しました。

セッションの合間には、参加者と席者と出展会社が集い友好を深めるための休憩室が設けられていました この会議の出展会社の多くはアンテナハウスのパートナーであり、また参加者の多くは AH Formatter のユーザでしたので、彼らと再会し、ソフトウェアの新機能を紹介し、パートナーシップを強化すべく今後のプランについて話し合う絶好の機会であったと思います。

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

http://rainbowpdf.com/


美味しいDITAの作り方セミナー「DITA再利用の原理とシステム活用」その2

ふたつめのセッションは「DITA運用編:再利用と協働制作を支援するCCMSとSchematron(スキマトロン)の活用法」と題し、アートダーウィン社が講演しました。
DITAの特性に応じたCMS製品(CCMS)が持つべき機能を、DITA専用CMSを使って具体的に解説し、さらにSchematron(スキマトロン)を使って、誤ったトピックライティングを矯正し、再利用を促進させる手法を実演を交えて解説しました。

DITAセミナー04出典:アートダーウィン著「再利用と協働制作を支援するCCMSとSchematronの活用法」から

ご参加された方々は皆さん熱心で、懸命にメモを取っていらっしゃる方もいらっしゃったのが印象的でした。
最後にアンケートにお答えいただいたのですが、80%以上の方に「期待以上に有意義だった」あるいは「期待通り有意義だった」とおっしゃっていただけました。

美味しいDITAの作り方セミナーは今後も続けていきたいと考えていますので、DITAに興味のある方は是非ご参加ください。

DITAセミナー

セミナーの様子

<< 「その1」


美味しいDITAの作り方セミナー「DITA再利用の原理とシステム活用」その1

7月10日にアンテナハウスとアートダーウィン社共催で「美味しいDITAの作り方セミナー」を開催しました。
このセミナー、テーマを変えて過去に数回開催してきたのですが、毎回好評でして今回もその例にもれず、多くの方に喜んでいただけたと自負しています。

ひとつめのセッションは「DITA基礎編:みんなが知りたい再利用のしくみ」と題し、トピックファイルとは何か、マップファイルとは何かという話から始め、DITAが用意する各種情報タイプ(concept、task、reference、glossary)の概要説明、そして本セッションのメインテーマであるコンテンツ再利用手法(conref、conkeyref、keyref、条件処理、関連テーブル)の解説を行いました。

使用したスライドのほんの一部
DITAセミナー01DITAセミナー02DITAセミナー03
「その2」に続く >>


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 を選択肢のひとつに加えていただきたいと思います。


Pages: 1 2 Next