PDF出力へのバーコードの追加

バーコードは、機械が読み取ることができるデータパターンです。 お客様はバーコードスキャナーまたはスマートフォンのカメラを使用してバーコードをスキャンできます。 製品詳細、在庫番号、web サイト URL などのエンコード情報が役立つ場合があります。 バーコードを追加すると、データを簡単に取り込み、カスタマーエクスペリエンスを向上させ、データ管理とセキュリティを強化できます。

バーコードのスタイルを作成できます。 これを使用して、ページレイアウトにバーコードを挿入します。 目的のページレイアウトでサンプルバーコードにスタイルを適用できます。

このチュートリアルでは、PDF出力にバーコードを追加する方法について説明します。

バーコードの生成手順

バーコードを生成するには、次の手順を実行します。

テンプレートの CSS を更新してバーコード値をレンダリングする

PDFの生成時にバーコードをレンダリングするように、layout.css ファイルを変更します。 「qrcode」や「pdf417」など、様々なバーコードタイプがサポートされています。 詳しくは、​ バーコードの種類 ​ を参照してください。

...
.barcode {
-ro-replacedelement: barcode;
-ro-barcode-type: code128;
-ro-barcode-size: 100%;
-ro-barcode-content: content();
object-fit: contain;
margin-top: 2mm;

}
...

CSS スタイルを使用してバーコードを生成

バーコードは、様々な方法で生成できます。 例を次に示します。

例 1

テンプレートヘッダーにバーコードプレースホルダーを追加して、スタイルを適用します。

ページレイアウトを含むテンプレートを使用して出力PDFを生成すると、バーコードを表示できます。 前の手順を実行したら、バーコードを含むPDF出力を生成できます。

次のスクリーンショットは、PDF出力にサンプルバーコードを示しています。

{width="700"}

例 2

Common.plt 基本 テンプレートの ファイルを変更して、プロジェクトタイトルの後にバーコードを追加します。

ISBN番号のバーコードを作成するには、ISBN番号を追加します。 次に、ISBN番号を使用してバーコードを生成します。

...

  <div data-region="header">
    <p class="chapter-header"><span data-field="project-title" data-format="default">Project Title</span> </p>
    <p><span class="barcode">978-1-56619-909-4</span></p>
  </div>
}
...

例 3

マップのメタデータを使用してバーコードを作成するには：

DITA マップの <topicmeta> 要素に存在する任意のメタデータをバーコードとして表示します。 正しい XPath を使用していることを確認します。 たとえば、DITA マップの <resourceid> に <topicmeta> を追加できます。

次の例では、リソース ID がバーコードを生成するためのメイン入力として機能します。

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "technicalContent/dtd/map.dtd">
<map id="GUID-3c330691-4dac-4020-904a-d2d6246aeeb1-en">
  <title>Barcode Sample</title>
  <topicmeta>
    <resourceid id="7a5bda1c-b1db-4fd8-8763-a731e2e8abba">
    </resourceid>
  </topicmeta>
  <topicref href="GUID-139f6c64-bea3-4f17-8b22-ee131557e249-en.dita" type="topic">
  </topicref>
</map>

リソース ID は、次のようにページレイアウトで使用できます。

  <div data-region="header">
    <p class="chapter-header"><span data-field="project-title" data-format="default">Project Title</span> </p>
    <p><span class="barcode" data-field="metadata" data-format="default" data-subtype="//resourceid/@id">Resource ID (barcode)</span></p>
  </div>
}

バーコードの種類 barcode-types

よく使用されるバーコードの一部を次に示します。