AEM Guides: Site-Generierung schlägt fehl, wenn xref mailto:# in Link verwendet
Dieser Artikel behandelt einen Fehler bei der Site-Erstellung in Adobe Experience Manager Guides, wenn eine Xref einen Mailto-Link enthält, der mit dem Zeichen # beginnt.
Beschreibung description
Umgebung
Adobe Experience Manager Guides (alle Versionen)
Problem/Symptome
Beim Generieren der AEM Sites-Ausgabe mithilfe von Voreinstellungen schlägt der Prozess fehl, wenn ein xref-Element einen Mailto-Link enthält, der mit dem Zeichen # beginnt (Beispiel: mailto:#example@example.com).
Der folgende Fehler tritt während der Site-Erstellung auf:
BUILD FAILED
/mnt/crx/author/crx-quickstart/profiles/ditaot--<profile-id>/DITA-OT/plugins/org.dita.base/build_preprocess.xml:62:
Failed to run pipeline: Expected scheme-specific part at index 7: mailto:#example@example.com
- Das Problem lässt sich reproduzieren, indem in einem beliebigen Thema eine xref mit
mailto:#hinzugefügt und versucht wird, eine AEM Sites-Ausgabe zu generieren. - Der Fehler tritt während des DITA-OT-Vorverarbeitungsschritts auf.
Zusätzlichen Kontext finden Sie in der Dokumentation zur DITA-URI-basierten Adressierung:
Lösung resolution
-
Aktualisieren Sie das xref-Element, um die Prozentcodierung für das #-Zeichen zu verwenden.
Anstatt<xref>mailto:#example@example.com</xref>Sie # wie%23.Beispiel:
code language-none <xref href="mailto:%23example@example.com" format="html">Contact Support</xref>
2. Ensure the xref uses the href attribute and includes display text.
This helps DITA-OT correctly interpret the link as an external reference.
3.Save the topic and regenerate the AEM Sites output using Presets.The site generation should now complete successfully without errors.
Cause
The DITA-OT processor interprets the # character as a fragment identifier within URIs. When used directly in a mailto link, it causes URI parsing errors. Percent-encoding the # character as %23 allows DITA-OT to process the link as intended.