AEM Guides: La generación del sitio falla cuando xref utiliza mailto:# en el vínculo
Este artículo aborda un error de generación de sitios en Adobe Experience Manager Guides cuando una referencia cruzada contiene un vínculo mailto que comienza con el carácter #.
Descripción description
Entorno
Adobe Experience Manager Guides (todas las versiones)
Problema/Síntomas
Al generar la salida de AEM Sites mediante Ajustes preestablecidos, el proceso falla si un elemento xref contiene un vínculo mailto que comience con el carácter # (por ejemplo: mailto:#example@example.com).
El siguiente error se produce durante la generación del sitio:
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
- El problema se puede reproducir agregando una xref con
mailto:#en cualquier tema e intentando generar resultados de AEM Sites. - El error se produce durante el paso de preprocesamiento DITA-OT.
Para obtener más información contextual, consulte Documentación de direccionamiento basada en URI de DITA:
Resolución resolution
-
Actualice el elemento xref para que utilice codificación porcentual para el carácter #.
En lugar de usar<xref>mailto:#example@example.com</xref>, codifique # como%23.Por ejemplo:
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.