Barcode zur PDF-Ausgabe hinzufügen
Ein Barcode ist ein Datenmuster, das Maschinen lesen können. Kunden können Barcodes mit einem Barcode-Scanner oder ihrer Smartphone-Kamera scannen. Kodierungsinformationen wie Produktdetails, Inventarnummern oder Website-URLs können hilfreich sein. Das Hinzufügen von Barcodes hilft Ihnen, die Daten einfach zu erfassen, das Kundenerlebnis zu verbessern und ein besseres Datenmanagement und bessere Sicherheit zu gewährleisten.
Sie können einen Stil für den Barcode erstellen. und verwenden Sie ihn zum Einfügen eines Barcodes in ein Seitenlayout. Sie können den Stil auf einen Beispiel-Barcode im gewünschten Seitenlayout anwenden.
Dieses Tutorial hilft Ihnen beim Hinzufügen von Barcodes in der PDF-Ausgabe.
Schritte zum Generieren eines Barcodes
Führen Sie die folgenden Schritte aus, um einen Barcode zu generieren:
CSS der Vorlage aktualisieren, um einen Barcode-Wert zu rendern
Ändern Sie die Datei "layout.css
", um einen Barcode während der PDF-Erstellung wiederzugeben. Es werden verschiedene Barcode-Typen wie "qrcode"und "pdf417"unterstützt. Weitere Informationen finden Sie unter Barcodetypen.
...
.barcode {
-ro-replacedelement: barcode;
-ro-barcode-type: code128;
-ro-barcode-size: 100%;
-ro-barcode-content: content();
object-fit: contain;
margin-top: 2mm;
}
...
Verwenden Sie den CSS-Stil, um den Barcode zu generieren
Sie können den Barcode auf unterschiedliche Weise generieren. Einige der Beispiele sind:
Beispiel 1
Fügen Sie einen Barcode-Platzhalter in der Vorlagenkopfzeile hinzu und wenden Sie den Stil an:
-
Bearbeiten von Vorlagen > Seitenlayouts
-
Wählen Sie ein Seitenlayout aus. Sie können beispielsweise das Seitenlayout "BackCover"auswählen, das die Kopf- oder Fußzeile enthält.
-
Fügen Sie den folgenden Bereich an der Stelle hinzu, an der Sie den Barcode einfügen möchten.
<span class="barcode">Sample barcode</span></p>
.note note NOTE Verwenden Sie denselben Klassennamen, den Sie in layout.css
definiert haben. -
Ersetzen Sie
<Sample barcode>
durch den Wert, den der Barcode-Scanner lesen soll.
Sie können den Barcode beim Generieren der Ausgabe-PDF mithilfe der Vorlage anzeigen, die das Seitenlayout enthält. Nachdem Sie die vorherigen Schritte ausgeführt haben, können Sie die PDF-Ausgabe mit einem Barcode generieren.
Der folgende Screenshot zeigt einen Beispiel-Barcode in einer PDF-Ausgabe.
Beispiel 2
Ändern Sie die Datei Common.plt
in der Vorlage Einfach , um einen Barcode nach dem Projekttitel hinzuzufügen.
Um einen Barcode für eine ISBN-Nummer zu erstellen, fügen Sie eine ISBN-Nummer hinzu. Verwenden Sie dann die ISBN-Nummer, um den Barcode zu generieren.
...
<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>
}
...
Beispiel 3
So erstellen Sie einen Barcode mit den Zuordnungsmetadaten:
Verwenden Sie alle Metadaten, die im Element <topicmeta>
einer DITA-Zuordnung vorhanden sind, um sie als Barcode anzuzeigen. Stellen Sie sicher, dass Sie den richtigen XPath verwenden. Sie können beispielsweise eine <resourceid>
in der <topicmeta>
einer DITA-Zuordnung hinzufügen.
Im folgenden Beispiel dient die Ressourcen-ID als Haupteingabe zum Generieren des Barcodes.
<?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>
Sie können die Ressourcen-ID wie folgt in einem Seitenlayout verwenden:
<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-Typen barcode-types
Einige der häufig verwendeten Barcodes sind wie folgt: