DITA
今、DITAのコミュニティーでは、DrupalとDITAの統合がホットな話題になってます。 私は、DrupalというCMSのことを今まで知りませんでしたが、オープンソースCMSアワードを２年連続で受賞した経歴を持つ、世界的に有名なCMSだそうです。日本での知名度はいま…
前に紹介した、Web-based Help from DocBook XMLを調べていたら、TOCの表示や検索キーワードのハイライト表示にjQueryを使用していることがわかりました。「jQueryってどんなもの？」って調べ始めたら、これはスゴイ (*_*) 昔、Perlに出会ったとき以来の衝撃…
DITA-OT1.5.2正式版前の最後のテストビルドであるMilestone7がSourceForgeにアップされました。この版から、日本語のHTML Helpも正しく生成されるようになりました。私もちょっとだけバグフィクスに貢献したので、うれしく思っています。「やっと、ここまで…
DITAに関する技術文書を、MeCab形態素解析エンジンを組み込み済みのhtmlsearchプラグインに食わしてみましたが、やはり専門用語がうまくヒットしません。そこで、下記ページの説明に従って、DITA技術文書用のユーザー辞書を作りました。http://mecab.sourcef…
昔に書いた、「DITA Open Toolkit活用ガイド」をYahoo DITA users groupにアップしました。ファイル名は、dita_ot_tips.zip です。DITA-OT 1.4.3の頃に書いたものなので少し内容が古いですが、DITA-OTの日本語化やカスタマイズ方法を知るのに有用だと思いま…
ちょっと長いです。土日２日分の苦闘の記録ですので。 OS: WinXP 32bit DITA-OT: 1.5.2 M6 MeCab: 0.98 cmecab-java: v1.7 1) 下記からMeCabをダウンロードして、インストール。 http://mecab.sourceforge.net/2) 下記から cmecab-java-1.7-i386.zip をダウ…
土曜日丸１日かかったけど、何とかMeCabの組み込みに成功した。きちんと日本語の形態素解析が行われるので、検索した単語が文書中にあれば確実にヒットするようになった。ハマッた点などについては、後日まとめる予定。 まだ、以下の課題が残っている。?辞書…
KAKASIをJavaから利用するためのライブラリが、インターネット上から消えてしまったようなので、代わりにMeCabというソフトを使って分かち書きに挑戦することにした。こちらは、Javaから利用できる。http://code.google.com/p/cmecab-java/上記ページからソ…
htmlsearchが日本語の分かち書きを正しく行えるようにする方法を調べていたら、DocBookのFull Text Searchについて書いたページを見つけました。http://www.thingbag.net/docbook/gsoc2010/doc/content/index.htmlどうも、このページで説明しているサーチエ…
DITA-OT1.5.2 M6に、tocjsbisプラグインとhtmlseachプラグインをインストールして動かしてみました。原因は調べていませんが、1.4.3の頃にはほとんど使い物にならなかったhtmlseachが、結構まともに動くようになりました。htmlseachプラグイン自体は、1.4.3…
dita4publishersをインストールしたら、従来のxhtml出力がおかしくなってしまいました。グラフィックスが一切表示されません。 dita4publishersによるhtml2出力の結果を見ると、従来のxhtml出力と異なり、imagesという1つのフォルダにすべてのグラフィックス…
トピックタイトルに が含まれていると、目次が正しく表示されない件、解決しました。 目次は toctree.js によって表示されます。このJavaScriptファイルを生成しているのは、 %DITA-OT\demo\tocjsbis\xsl\topicref.xsl です。 このXSLにおいて、タイトル文字…
トピックタイトルに が含まれている場合、tocjsで生成した目次がおかしくなります。JaveScript toctree.jsにより、目次にトピックのタイトルを表示しますが、 がHTMLのタグの関係を壊すため、目次の表示がおかしくなります。ちょっと別の話になりますが、Eli…
DITA-OT1.5の頃から、tocjsプラグインが標準で提供されるようになりました。tocjsプラグインは、コンテンツとは別のフレームに目次を表示するためのプラグインです。ツリー形式の目次が表示され、HTML Helpの目次と同様のユーザー・インターフェイスになりま…
Alfrescoのオンラインヘルプは、DITAで作られています。Alfrescoは、オープンソースのECM(Enterprise Contents Management system)として有名です。 tocjs形式のXHMTLをオンラインヘルプにしています。コーポレートイメージに合うようにCSSをカスタマイズし…
DITA-OT 1.5以前は、PDF生成時にトピック間のリンクを出力するかどうかは、AntパラメータのdisableRelatedLinksで決まっていました。 disableRelatedLinksをyesにすると、トピック間のリンクは一切出力されません。 disableRelatedLinksをnoにすると、relate…
OS: Windows7 64bit Home Premium DITA-OT: 1.5.2 M6 上記の環境でPDF生成を試みたところ、以下のようなエラーになりました。 [echo] Using document.locale=ja_JP [echo] [echo] Java maximum memory=500m [java] Could not create the Java virtual machin…
予定より、丸１年以上遅れて、ようやくDITA1.2が正式に認可されました。 仕様書は下記からダウンロードできます。http://dita.xml.org/news/dita-12-submitted-for-oasis-ballotこれを機に、DITA-OT1.5.2を使えるようにセットアップしようと思います。 少し…
純国産のDITA-OT PDFプラグイン（pdf5プラグイン）が、アンテナハウス社からオープンソースとしてリリースされました。DITA-OTに標準で組み込まれているIdiom社製のFOプラグインのalternativeとなるプラグインです。http://www.antenna.co.jp/XSL-FO/sample/…
Yahoo! DITA user groupにポストされたメッセージからの引用です。DITA XML.orgに、DITA Open Toolkitの内部処理の概要を説明した記事があります。DITA Open Toolkitをカスタマイズする人は、是非とも押さえておきたい情報だと思います。DITA Processing in …
私がoXygenを気に入っている理由の1つに、ネストしたマップを1つのツリーで見られる点が挙げられます。私は、DITAでマニュアルを書くとき、ルートマップをbookmapで作り、ルートマップの各chapter要素から、章にあたるマップを参照させます（下図参照）。こ…
DITA-OTを実行するために、Antスクリプト・ファイルを書くのに難儀している人に役立ちそうなツールが、SourceForge.netで公開されています。 http://sourceforge.net/search/?type_of_search=soft&words=winantこのツールのユーザー・インターフェイスはこん…
oXygenには、Diff Filesというツールが標準でバンドルされています。 使ってみたら、これはなかなかイイです。 DITA-OT1.5 M21からM22へ、カスタマイズ箇所をマージする作業が、このツールのおかげではかどりました (^^)vDiff Filesを使いながらマージ作業を…
ドイツのinstinctoolsという会社が、同社が開発、販売しているDITAworksに含まれる、DITAの特殊化を支援するためのビジュアルエディタを、無償で提供することをアナウンスしました。公開は12月始めになるそうです。また、無償提供の対象は、業界標準化を目指…
DITA-OT1.5 M22の改善項目を見ると、マイナーだけれども、大切な機能改善がいくつかなされています。1. PDF生成時に、しおりを閉じた状態にするか、展開した状態にするか、選択可能にする。args.bookmark.style Antパラメータに、COLLAPSED または EXPANDED …
少し前まで、DITA文書を編集するのにXMLmindというエディタを使っていました。XMLmindは、構造図の表示の仕方や操作感が少しFrameMakerと似ていて、割と気に入って使っていました。image要素やtopicref要素の、href属性の指定を、Windows Explorerからのドラ…
「DITA 1.2 Feature Description: Glossary and Terminology Specialization」に書かれたベスト・プラクティスに従って、用語集を書いてみました。 【注意】 DITA-OT1.5 M21のPDF出力では、まだkeyrefがサポートされていません。 1用語1ファイルで作成してい…
非常に個人的な見解ですが、こんなふうに感じています。やりたいことがある人にとって、DITAはそれを実現するための強力な武器になる。 漠然と、コスト削減、TAT短縮、品質アップをしたいと思っている人にとって、DITAは偶像でしかない。普通の企業の中では…
Yahoo DITA users gourpにポストされたメールから。DITA-OTによる文書の生成処理を、Apache Mavenを使ってバッチ的に行う方法が紹介されています。DITA Open Toolkit Maven Pluginのページはこちら http://mojo.codehaus.org/dita-maven-plugin/このプラグイ…
Scriptorium Publishingという会社のコラムに、「When is XML the wrong answer」という記事があります。 http://www.scriptorium.com/resources/xml-strategist-columnsこれを読んだ私の理解は以下のとおりです。「XML(DITA)が間違った選択肢である場合とは…
