Linux: Administratorの設定要約のPDFで日本語が表示されない

ColdFusion Administratorの「サーバーの設定＞設定要約」の右上に[PDFとして保存]ボタンを押すと、Administratorの主要な設定項目をPDFファイルに書き出すことができます。

Windows環境では、デフォルトの状態で日本語が表示されますが、Unix環境でPDFを書き出すと日本語が表示されていない設定要約が出力されます。これは、内部で動作するcfdocumentタグのデフォルトのフォント設定がLinuxに含まれていないフォント（MS系フォント）になっているためです。

設定要約PDFの日本語を表示させるためには、下記のフォント設定を行ってください。

このページでは、IPAゴシックとIPA明朝を指定した例を解説しています。IPAフォントは下記からダウンロード可能です。
IPAフォント Ver.00303 | 一般社団法人文字情報技術促進協議会 (moji.or.jp)
※TTFフォントをダウンロードしてください。TTCフォントは使用できないことが多いです

【手順】

ダウンロードしたTTFフォントを展開し、任意の場所に配置します
- 例：/home/samuraiz/IPAfont00303
下記のようにcfdocumentが使用する内部ライブラリ（iText）のデフォルトのパスにシンボリックリンクを指定します
1. /usr/share/fonts/ に移動します
  - cd /usr/share/fonts/
2. /usr/share/fonts/内にdefaultフォルダを作成します
  - sudo mkdir /usr/share/fonts/default
3. リンクを追加します
  - sudo ln -s /home/samuraiz/font /usr/share/fonts/default/TrueType
[cf_root]/{インスタンス(cfusion等)}/lib フォルダに移動します
- cd /opt/ColdFusion2021/cfusion/lib
vi 等でcffont.properties.jaファイルを開き、フォントの指定を２で配置したフォントに変更します

【例】※1行目のdefaultbasefontはフォントを指定しないでください。エラーが発生します。
defaultbasefont=
dialog=IPAGothic
dialog.bold=IPAGothic
dialog.italic=IPAGothic
dialog.bolditalic=IPAGothic
dialoginput=IPAGothic
dialoginput.bold=IPAGothic
dialoginput.italic=IPAGothic
dialoginput.bolditalic=IPAGothic
serif=IPAPMincho
serif.bold=IPAMincho
serif.italic=IPAMincho
serif.bolditalic=IPAMincho
sansserif=IPAGothic
sansserif.bold=IPAGothic
sansserif.italic=IPAGothic
sansserif.bolditalic=IPAGothic
monospaced=IPAMincho
monospaced.bold=IPAMincho
monospaced.italic=IPAMincho
monospaced.bolditalic=IPAMincho
ColdFusionを再起動して変更を反映します。
ColdFusion Administratorの「サーバーの設定＞設定要約」ページを開き、[PDFを作成]でPDFを作成してください

上記の手順２．については、ColdFusion 2021でカスタムフォントが設定できない不具合があったため、その回避として上記の方法を行っています。
ColdFusion 2021のUpdate 5であれば、手順2.の代わりに ColdFusion Administratorの「サーバーの設定＞フォント管理」で「新規フォントをColdFusionで登録」で、任意の場所のフォントを登録する方法でも対応が可能な模様です。

記事公開日：2022年11月17日
最終更新日：2022年11月17日

Sample Modal Window

This is just a sample…