AEM Guides : la génération du site échoue lorsque la xréf utilise mailto:# dans le lien
Cet article traite d’un échec de génération de site dans Adobe Experience Manager Guides lorsqu’une xref contient un lien mailto commençant par le caractère #.
Description description
Environnement
Adobe Experience Manager Guides (toutes versions)
problème/symptômes
Lors de la génération d’une sortie AEM Sites à l’aide de préréglages, le processus échoue si un élément xref contient un lien mailto qui commence par le caractère # (par exemple : mailto:#example@example.com).
L’erreur suivante se produit lors de la génération du site :
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
- Le problème est reproductible en ajoutant une xref avec
mailto:#dans n’importe quelle rubrique et en essayant de générer une sortie AEM Sites. - L’erreur se produit lors de l’étape de prétraitement DITA-OT.
Pour plus de contexte, consultez la documentation sur l’adressage basé sur l’URI DITA :
Résolution resolution
-
Mettez à jour l’élément xref pour utiliser le codage de pourcentage pour le caractère #.
Au lieu d’utiliser<xref>mailto:#example@example.com</xref>codez le # comme%23.Par exemple :
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.