PDF出力へのバーコードの追加
バーコードは、機械が読み取ることができるデータパターンです。 お客様はバーコードスキャナーまたはスマートフォンのカメラを使用してバーコードをスキャンできます。 製品詳細、在庫番号、web サイト URL などのエンコード情報が役立つ場合があります。 バーコードを追加すると、データを簡単に取り込み、カスタマーエクスペリエンスを向上させ、データ管理とセキュリティを強化できます。
バーコードのスタイルを作成できます。 これを使用して、ページレイアウトにバーコードを挿入します。 目的のページレイアウトでサンプルバーコードにスタイルを適用できます。
このチュートリアルでは、PDF出力にバーコードを追加する方法について説明します。
バーコードの生成手順
バーコードを生成するには、次の手順を実行します。
テンプレートの CSS を更新してバーコード値をレンダリングする
を変更する layout.css
PDFの生成中にバーコードをレンダリングするファイル。 「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
テンプレートヘッダーにバーコードプレースホルダーを追加して、スタイルを適用します。
-
編集 テンプレート > ページレイアウト
-
ページレイアウトを選択します。 例えば、ヘッダーやフッターを含む BackCover ページレイアウトを選択できます。
-
バーコードを挿入する場所に次の範囲を追加します。
<span class="barcode">Sample barcode</span></p>
。note note NOTE と同じクラス名を使用します。 layout.css
. -
置換
<Sample barcode>
バーコードスキャナーで読み取る値を指定します。
ページレイアウトを含むテンプレートを使用して出力PDFを生成すると、バーコードを表示できます。 前の手順を実行したら、バーコードを含むPDF出力を生成できます。
次のスクリーンショットは、PDF出力内のサンプルバーコードを示しています。
例 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
マップのメタデータを使用してバーコードを作成するには:
に存在する任意のメタデータを使用 <topicmeta>
バーコードとして表示する DITA マップの要素。 正しい XPath を使用していることを確認します。 例えば、 <resourceid>
が含まれる <topicmeta>
(DITA マップの)。
次の例では、リソース 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
よく使用されるバーコードの一部を次に示します。