向PDF输出添加条形码
条形码是一种机器可以读取的数据模式。 客户可以使用条形码扫描仪或智能手机摄像头扫描条形码。 产品详细信息、库存编号或网站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
在模板标题中添加条形码占位符并应用样式:
-
编辑 模板 > 页面布局
-
选择页面布局。 例如,您可以选择“后盖”页面布局,其中包含页眉或页脚。
-
将以下范围添加到要插入条形码的位置。
<span class="barcode">Sample barcode</span></p>
。note note NOTE 使用您在 layout.css
中定义的相同类名。 -
将
<Sample barcode>
替换为您希望条形码扫描仪读取的值。
使用包含页面布局的模板生成输出PDF时,您可以查看条形码。 执行上述步骤后,可以使用条形码生成PDF输出。
以下屏幕截图在PDF输出中显示一个条形码示例。
示例 2
修改 Basic 模板中的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映射的<topicmeta>
中添加<resourceid>
。
在以下示例中,资源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
一些常用的条形码如下: