タグ別アーカイブ: AH Formatter

[AH Formatter] Markdown形式の原稿を CSS組版により PDF文書に変換するための事例紹介

AH Formatter の導入事例紹介ページに有限会社フェリックス・スタイル様の事例「AH Formatter を用いた Markdown-PDF 変換事例紹介」を掲載しております。

事例紹介ページにある PDF文書では、Markdown形式の原稿を『AH Formatter』の CSS組版により、表紙や目次、ノンブルなどを備えた PDF文書へと変換するフローが詳解されております。

また、この事例紹介の PDF文書も Markdown原稿から作成されており、その作成に用いたソースファイル一式も GitHub にて公開しておりますので、実際に Markdown原稿から CSS組版を利用した PDF へのビルドをご体験いただけます。是非ご覧ください。

なお、主に海外の方に向けて、ソースファイルは英語版もご用意しております。
Markdown-PDF
→ https://github.com/2SC1815J/md2pdf/tree/en (English Version)
　
　

『AH Formatter』の評価版は以下のページよりお申し込みいただけます。是非、お試しください。
→ AH Formatter 評価版のお申し込み

XSL-FO の基本仕様と『AH Formatter』の拡張機能をお試しいただけるよう「サンプル FO 集」もご用意しています。

『AH Formatter』についてお問い合わせがございましたら sis@antenna.co.jp 宛てにご連絡ください。

投票をお願いいたします

海外出展情報その２

DITA North America (続き)

<< DITA North America（前回）
セッションの合間には、展示室で出席者と出展者が集まる休憩がありました。この会議の出展者の大部分はアンテナハウスのパートナーでしたので、彼らと再会し、今後のソフトウェア機能を確認し、パートナーシップを強化するための様々な機会について議論する絶好の機会でした。既存のお客様はもとより初めての訪問者も、当社の製品に対する要望、問題を解決する方法についての質問、当社が提供するより多くの他の製品を知ることに興味を持っていました。全体として、今年のカンファレンスでの参加率、ブースでの関心の高さ、そしてパートナーやクライアントとの興味深いディスカッションを通じて、満足のできる結果であったと思います。

さて4月は展示会がとても多い月です。ちょうど今ネバダ州のラスベガスで Xplor International に出展している最中です。また4月29日にはアラバマ州ハンツビルで開催の AIA Product Support に参加する予定です。いずれもお客様、パートナーとの情報共有の大変良い機会となり、アンテナハウスが健全で成長し続けている企業であることを示す良い機会となることでしょう。

今朝ほど丁度営業担当から、Xplor International の報告が届きましたので、合わせてご紹介いたします。

Xplor International

アンテナハウスが CCM およびデジタルドキュメントの専門家のための Xplor19 に参加するのは今年で3年目です。 Xplor19 は今年から大きくイベントの変更がありました。過去10年間、フロリダ州オーランドで開催された単独のイベントだったのですが、今年 Xplor は、ISA International Sign Expo との提携を発表し、カンファレンスをネバダ州ラスベガスに移しました。今後、カンファレンスの開催は、オーランドとラスベガスで交互で行われます。 2つのカンファレンスは独立したイベントとして運営し続けますが、出席者は両方のイベントの特典を体験、享受できるよう、特別なオファーや招待状を受け取ることができます。今年は開催のスタイルにも変更がありました。イベントは夕方に始まり、一般的なセッションのトラックは出展者と同じホールで行われました。一方ビジネステクノロジー、デリバリーテクノロジー、マーケティングテクノロジーは他のホールで行われました。

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

http://rainbowpdf.com/

投票をお願いいたします

海外出展情報その１

DITA North America

4月14日から17日にかけて、アンテナハウスはノースカロライナ州ダーラムで開催された CMS/DITA North America に、スポンサーとして出展しました。これは、情報開発管理センター（CIDM）が主催する第21回目の ContentManagement Strategies/DITA North America conference です。この会議では、メタデータと分類法、パーソナライズされたコンテンツ配信、インテリジェントコンテンツ、ケーススタディ、DITA 2.0 と軽量 DITA、および構造化オーサリングなどのテーマを扱う4つのセッションが同時開催されました。この会議には、DITA 規格に関する質問に応じたり、問題解決に貢献した DITA 有識者も多数参加されていました。参加者はまた、実地体験をすることもできます。Technology Test Kitchen では、興味のあるツールを試したり、既存のツールを使って新しいトリックを習得したりできます。

今年は Technology Test Kitchen で、XSL-FO と CSS を使って PDF 出力をするデモを行いました。 PDF 変換用の DITA のスタイル設定に関しては、最もよく使用されるスタイルシート言語は XSL Formatting Objects（XSL-FO）です。これは、DITA Open Toolkit（DITA-OT）が PDF 変換の主要パスとして XSL-FO を使用しており、いくつかのFOプロセッサをサポートしているためです。しかし、DITA-OT できれいな PDF を作成する別の方法もあります。Cascading Style Sheets（CSS）です。 CSS はその単純さのために印刷に広く使用されるようになり、新しい DITA 採用者は従来の XSL-FO の代わりにこの代替パスを採用することもあります。 AH Formatter は XSL-FO と CSS の両方をサポートしているので、お客様には選択肢があります。このテストキッチンでは、XSL-FO と CSS の違いについて説明し、さまざまなプラグインオプション、カスタマイズされたスタイルシートを利用し、DITA-OT と AH Formatter を使用して各プロセスがどのように機能するかを示しました。そして彼らの要求に基づいていくつかのライブデモをしました。質疑応答の時間を設け、既存のお客様との間で非常に興味深い議論があり、どのフォーマット方法がそれぞれのお客様にとって最適であるかについて可能性を探ることができました。

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

http://rainbowpdf.com/

海外出展情報　その２ >>

投票をお願いいたします

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

投票をお願いいたします

海外出展情報　その２

Tekom 2018

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

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

投票をお願いいたします

海外出展情報　その１

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/

投票をお願いいたします

アンテナハウス製品におけるJava 11以降の動作確認と動作保証

2019年1月でJava 8のサポートが切れます。
そして、2018年9月下旬、Java 11が予定通り出荷され、お客様からの問い合わせが入っていますので、アンテナハウス製品におけるJava 11以降の動作確認、動作保証について、現段階での方針をお知らせします。

Oracleが、これまで無償で配布してきたJDKのサポートを有償化するという話が出て、いろいろと混乱した話が飛び交いましたが、OpenJDKを使えば、無償で使えます。
OpenJDKは、OracleからJDKのソースコードの提供を受けて、いろんな企業や団体がビルドして無償で配布しているもので、企業や団体によって、有償サポートがあったりなかったり、サポート料やサポート期間もマチマチです。
この辺は、Linuxに各種のディストリビューションがあるのと似ています。
詳しい話は、参考に挙げた記事やサイトをお読みください。

アンテナハウスは、OpenJDKの中でも、LTS(Long Term Support)バージョンのOpenJDKを、無償で、最低4年間は、セキュリティやバグフィックスのアップデートを提供するといっているAdoptOpenJDKによって、動作確認と動作保証を始めています。
AdoptOpenJDKのJava 11は、最低、2022年9月までアップデートが提供される予定です。

AdoptOpenJDK

AdoptOpenJDK Support

	First Availability	End of Availability [1]
Java 8 (LTS)	March 2014	At Least Sep 2023 [2]
Java 9	Sept 2017	March 2018
Java 10	March 2018	Sept 2018
Java 11 (LTS)	Sept 2018	At Least Sept 2022 [2]

AdoptOpenJDKでダウンロードできるバイナリのうち、アンテナハウスが動作確認、動作保証の対象とするJava 11は、「OpenJDK 11 Hotspot」です。
Hotspotは、元々Sun(Javaの本家)が作ったJVM(Java仮想マシン)です。Oracleがメンテナンスや機能拡張をしています。これがリファレンスと考えてよいので、このJVMのみ動作保証対象にする予定です。
理由は、JVMは多くの実装があるので、やり出したら、きりがないからです。
たとえば、上記サイトには、Java 11でも、
「OpenJDK 11 with Eclipse OpenJ9」
がありますが、OpenJ9は、IBMが開発したJVMです。これは動作保証の対象にはしない予定です。
アンテナハウス自身が、動作確認、動作保証をするJVMを限定することについては、何卒、ご了承ください。

現在、アンテナハウス製品で使われているJavaのコードは、Java 8のコンパイラでビルドして出荷していますが、動作確認を始めた製品では、いずれも、問題なくJava 11で動いています。
アンテナハウスの製品のうち、Javaを使っている製品については、いずれ、各製品のウェブページで、動作確認が取れたことをお知らせしていく予定です。
なお、Java 8のコンパイラからJava 11のコンパイラに切り替える時期は未定です。
Java 11のコンパイラでビルドすると、Java 11の実行環境が必要になり、Java 8では動かなくなることが予想されます。
2019年1月でJava 8のサポートが切れるといっても、すぐ、Java 11に乗り換えられるお客様は、そんなに多くないだろうと考えていますので、2019年早々のコンパイラの切り替えは考えていません。
Javaを使っているアンテナハウス製品のリリース時期によりますが、今後、1年から数年をかけて、コンパイラを切り替えていくことになるでしょう。

参考：
【GlassFish勉強会レポート】各JDKベンダの動向を知ってJava 11に備えよう
2018年10月5日
杉山貴章

Javaは今も無償です

Oracle Java SE サポート・ロードマップ
(2018年 9月25日更新)

Time to look beyond Oracle’s JDK
Monday, 3 September 2018

投票をお願いいたします

Breaking Paragraphs into Lines

Breaking Paragraphs into Lines は、Donald E. Knuth と Michael F. Plass の行分割に関する論文で、40年近く前のものです。ここで示されているアルゴリズムは、パラグラフ全体を Box/Glue/Penalty という要素（Paragraph Item）でモデル化して、行分割位置を決定するものです。処理の流れは次のようになります。

アプリケーションが、文書から Paragraph Items を構築する。
分割可能位置に対して、そこで行分割したときの不具合度を示すデメリット値と呼ばれる値を計算する。
もっともデメリット値の合計の少ない位置を選択し、行分割位置とする。

Paragraph Item の要素 Box/Glue/Penalty は、それぞれが幅を持っています。

Box は常に幅が確保される。伸縮性はない。
Glue も幅が確保されるが、そこで分割が起こったとき幅がなくなる。Glue には伸縮性がある。
Penalty はその逆で、通常は幅が確保されないが、そこで分割が起こったとき前の行末にその幅が確保される。Penalty に伸縮性はない。また、行分割の起こり易さを調整するペナルティ値という値を持っており、分割不可では ∞ を、分割必須では −∞ を与えることになっている。ハイフネーションは Penalty を利用して実現されている（通常の Penalty と区別するために Flagged Penalty と呼ばれる）。

次のような文書（論文に出てくるグリム童話）を例に、このアルゴリズムがどのように行分割位置を決定するのかをざっと見てみましょう。

fig-12

これから次のような Paragraph Items が構築されます。
x は要素、t は要素の種別、w は要素の幅、y は伸ばせる幅、z は縮められる幅、p はペナルティ値を示しています。

x₀	empty box for indentation	t₀	= box	w₀	= 20
x₁	box for ‘In’	t₁	= box	w₁	= 17.44
x₂	glue for space U+0020	t₂	= glue	w₂	= 4.54	y₂	= 5	z₂	= 2
x₃	box for ‘old’	t₃	= box	w₃	= 25.68
x₄	penalty for hyphenation	t₄	= flagged-penalty	w₄	= 7.12	p₄	= 100
x₅	box for ‘en’	t₅	= box	w₅	= 19.44
x₆	glue for space U+0020	t₆	= glue	w₆	= 4.54	y₆	= 5	z₆	= 2
x₇	box for ‘times’	t₇	= box	w₇	= 43.7
x₈	glue for space U+0020	t₈	= glue	w₈	= 4.54	y₈	= 5	z₈	= 2
x₉	box for ‘when’	t₉	= box	w₉	= 43.88
`......`
x₂₄	glue for space U+0020	t₂₄	= glue	w₂₄	= 4.54	y₂₄	= 5	z₂₄	= 2
x₂₅	box for ‘lived’	t₂₅	= box	w₂₅	= 38.54
x₂₆	glue for space U+0020	t₂₆	= glue	w₂₆	= 4.54	y₂₆	= 5	z₂₆	= 2
x₂₇	box for ‘a’	t₂₇	= box	w₂₇	= 8.78
x₂₈	glue for space U+0020	t₂₈	= glue	w₂₈	= 4.54	y₂₈	= 5	z₂₈	= 2
x₂₉	box for ‘king’	t₂₉	= box	w₂₉	= 35.5
x₃₀	glue for space U+0020	t₃₀	= glue	w₃₀	= 4.54	y₃₀	= 5	z₃₀	= 2
x₃₁	box for ‘whose’	t₃₁	= box	w₃₁	= 50.64
`......`
x₅₁	box for ‘young’	t₅₁	= box	w₅₁	= 49.76
x₅₂	penalty for hyphenation	t₅₂	= flagged-penalty	w₅₂	= 7.12	p₅₂	= 100
x₅₃	box for ‘est’	t₅₃	= box	w₅₃	= 21.84
x₅₄	glue for space U+0020	t₅₄	= glue	w₅₄	= 4.54	y₅₄	= 5	z₅₄	= 2
x₅₅	box for ‘was’	t₅₅	= box	w₅₅	= 29.82
x₅₆	glue for space U+0020	t₅₆	= glue	w₅₆	= 4.54	y₅₆	= 5	z₅₆	= 2
x₅₇	box for ‘so’	t₅₇	= box	w₅₇	= 17.7
x₅₈	glue for space U+0020	t₅₈	= glue	w₅₈	= 4.54	y₅₈	= 5	z₅₈	= 2
x₅₉	box for ‘beau’	t₅₉	= box	w₅₉	= 38.36
x₆₀	penalty for hyphenation	t₆₀	= flagged-penalty	w₆₀	= 7.12	p₆₀	= 100
x₆₁	box for ‘ti’	t₆₁	= box	w₆₁	= 11.56
x₆₂	penalty for hyphenation	t₆₂	= flagged-penalty	w₆₂	= 7.12	p₆₂	= 100
x₆₃	box for ‘ful’	t₆₃	= box	w₆₃	= 21.82
`......`
x₁₄₃	box for ‘old’	t₁₄₃	= box	w₁₄₃	= 25.68
x₁₄₄	glue for space U+0020	t₁₄₄	= glue	w₁₄₄	= 4.54	y₁₄₄	= 5	z₁₄₄	= 2
x₁₄₅	box for ‘lime-‘	t₁₄₅	= box	w₁₄₅	= 42.34
x₁₄₆	penalty for inter-word	t₁₄₆	= flagged-penalty	w₁₄₆	= 0	p₁₄₆	= 100
x₁₄₇	box for ‘tree’	t₁₄₇	= box	w₁₄₇	= 30.46
x₁₄₈	glue for space U+0020	t₁₄₈	= glue	w₁₄₈	= 4.54	y₁₄₈	= 5	z₁₄₈	= 2
x₁₄₉	box for ‘in’	t₁₄₉	= box	w₁₄₉	= 16.3
`......`
x₂₆₇	box for ‘her’	t₂₆₇	= box	w₂₆₇	= 26.52
x₂₆₈	glue for space U+0020	t₂₆₈	= glue	w₂₆₈	= 4.54	y₂₆₈	= 5	z₂₆₈	= 2
x₂₆₉	box for ‘fa’	t₂₆₉	= box	w₂₆₉	= 14.7
x₂₇₀	penalty for hyphenation	t₂₇₀	= flagged-penalty	w₂₇₀	= 7.12	p₂₇₀	= 100
x₂₇₁	box for ‘vor’	t₂₇₁	= box	w₂₇₁	= 26.48
x₂₇₂	penalty for hyphenation	t₂₇₂	= flagged-penalty	w₂₇₂	= 7.12	p₂₇₂	= 100
x₂₇₃	box for ‘ite’	t₂₇₃	= box	w₂₇₃	= 19.6
x₂₇₄	glue for space U+0020	t₂₇₄	= glue	w₂₇₄	= 4.54	y₂₇₄	= 5	z₂₇₄	= 2
x₂₇₅	box for ‘play’	t₂₇₅	= box	w₂₇₅	= 33.42
x₂₇₆	penalty for hyphenation	t₂₇₆	= flagged-penalty	w₂₇₆	= 7.12	p₂₇₆	= 100
x₂₇₇	box for ‘thing.’	t₂₇₇	= box	w₂₇₇	= 47.02
x₂₇₈	finishing glue	t₂₇₈	= glue	w₂₇₈	= 0	y₂₇₈	= ∞	z₂₇₈	= 0
x₂₇₉	forced break	t₂₇₉	= flagged-penalty	w₂₇₉	= 0	p₂₇₉	= −∞

次の位置が分割可能位置となります。上の例では、x₂、x₄ などです。

x_b が Penalty であり p_b < ∞ である x_b
x_b が Glue であり x_b-1 が Box である x_b

デメリット値は、そこで行分割するとどの程度よろしくないのかを示す値であり、この値が小さいほどよい分割位置と判断されます。あまりに大きなデメリット値のときは分割位置の候補から除外されます。デメリット値の算出方法の詳細はここでは触れませんが、外部から与えるいくつかのパラメタによって、デメリット値を調整できるようになっています。

上の例では、x₂ や x₄ のデメリット値は非常に大きく、候補から除外されます。最初（1行目）の分割位置候補となるのは x₂₆ と x₂₈ で、デメリット値を d とすると、d₂₆ = 975.065、d₂₈ = 23.5004 となっています。
x₂₆ で行分割したとき、次の行（2行目）の分割位置候補は、x₅₂ と x₅₄ で、d₅₂ = 29412.2、d₅₄ = 1288.3 です。
x₂₈ で行分割したときは、x₅₆ と x₅₈ が次の候補となり、d₅₆ = 24.6185、d₅₈ = 6446.52 です。
パラグラフ全体にこれを繰り返すと、次のようなネットワークができ上がります（パスのいくつかは省略されています）。数値は、下に示された語の後で分割したときのデメリット値を示しています。この例では、太い枠の語で分割するのが最良となっています。