PrizmDoc

新着情報

製品に関する情報をはじめ、ホワイトペーパーやコラム記事、セミナー開催などの
イベント情報といったPrizmDocに関する最新情報をご案内します。

  • コラム

PrizmDocViewerの日本語化方法

PrizmDocのViewerを日本語化できるってご存じですか?


PrizmDocは米メーカーの製品ということもあり、基本言語として英語が採用されていますが、ローカライズ機能を有しています。
このローカライズ機能を利用すれば、日本語でViewerを運用することも可能となります。ここではこのローカライズ方法をご紹介します。

ある程度英語を理解されていたとしても、細かいニュアンスなども含め、そのままですとオペレーションに時間がかかる可能性もあります。
日本語での運用で快適にPrizmDocをご利用ください。
【Before】
【After】

ローカライズ方法


では早速、ローカライズ方法をご案内します。まず大枠での手順は以下のようになります。
  • 英語版の表示内容(ファイル)をもとに、日本語版の表示ファイルを作成します。
  • ①で用意した日本語版表示ファイルを使うよう、ビューアの設定を行います。
  • 利用者は日本語表示のビューアを使用できます。

ローカライズのより詳しい手順は以下となります。実際に設定を行う際にご参照ください。
クリックして詳細を見る

ローカライズ方法詳細


STEP 1. GitHub にある PrizmDoc Viewer リポジトリをクローンする(Node.js 必須)
PrizmDoc Viewer の UI は GitHub で公開されています。
日本語化とビルドのため、まずリポジトリを取得します。


```bash
git clone https://github.com/Accusoft/prizmdoc-viewer
cd prizmdoc-viewer
npm install
```

※Node.js と npm が必要です。
※言語リソースは `src/languages/` に格納されています。

STEP 2. 日本語リソース(ja-JP.json)を作成する
英語版リソース(`en-US.json`)をコピーし、日本語版リソース(`ja-JP.json`)を作成します。

英語版リソースをコピー
src/languages/en-US.json → src/languages/ja-JP.json
日本語訳例:

```json
{"download": "ダウンロード",
"print": "印刷",
"rotateLeft": "左回転"}
```


STEP 3. Viewer をビルドする
日本語リソースを追加したら、Viewer 全体をビルドします。

```bash
npm run build
```

成果物は以下に生成されます:

```text
build/
```

※この中に日本語化済みの Viewer アセット一式が入っています。

STEP 4. 公式チュートリアルでダウンロードする Viewer アセットを置き換える
公式ガイドでは Viewer の静的アセットをダウンロードしていますが、
日本語化する場合は そのアセットを使わず、ビルドして生成された `build/`を配置します。
【公式ガイド】https://help.accusoft.com/PrizmDoc/latest/HTML/getting-started-viewing-part-1.html

```
/webroot/
viewer-assets/← build/ ディレクトリの内容をすべて配置
```


STEP 5. Viewer 初期化時に日本語リソースを指定する
Viewer を初期化するコードで、利用する言語を日本語に設定します。

```html
<script type="text/javascript">
$(function() {
$('#viewerContainer').pccViewer({
// documentID: 'TODO: We'll handle this in part 2',
imageHandlerUrl: '/pas-proxy',
viewerAssetsPath: 'viewer-assets',
resourcePath: 'viewer-assets/img',
// language: viewerCustomizations.languages['en-US'],
language: viewerCustomizations.languages['ja-JP'], //←日本語リソースを使う指定
template: viewerCustomizations.template,
icons: viewerCustomizations.icons,
annotationsMode: "LayeredAnnotations"
});
});
</script>
```


これで Viewer の UI が日本語表示に切り替わります。
Viewer の文言はJSONで管理されているため、自由にカスタマイズできます。
また、言語リソースのカスタマイズ以外にも、メニューの再編成、カスタムボタンの追加、スタイルの変更など、
様々なカスタマイズが可能です。
詳しくは[公式ガイド]をご参照ください。

JSONファイルの日本語イメージ(サンプル)


JSONファイルを日本語に書きかえた場合のサンプルをご紹介します。
【English】
【日本語】

※クリックすると拡大します。

※記載の例は1例です。
※PrizmDocのバージョンによって JSONファイルの内容が異なる場合があります。
 不明点などございましたらサポートにお問い合わせください。
※日本語の表現もご利用いただくお客様のニーズに応じて自由にカスタマイズできますので、
 上記はあくまで参考としてご覧ください。

まとめ


PrizmDocのViewerを日本語化できるお話はいかがでしたでしょうか?

ユーザーが利用しやすい環境で表示をすることで、作業工数削減につながるケースもあるかと思います。
そのひとつが日本語表示かと思います。是非、必要に応じた最適な運用にご活用ください。

まずは無料トライアルでお試しください。