AEM Guides: a geração do site falha quando xref usa mailto:# no link
Este artigo aborda uma falha na geração do site no Adobe Experience Manager Guides quando uma xref contém um link mailto que começa com o caractere #.
Descrição description
Ambiente
Adobe Experience Manager Guides (todas as versões)
Problema/Sintomas
Ao gerar a saída do AEM Sites usando Predefinições, o processo falhará se um elemento xref contiver um link mailto que comece com o caractere # (Por exemplo: mailto:#example@example.com).
O seguinte erro ocorre durante a geração do 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
- O problema pode ser reproduzido adicionando-se uma xref com
mailto:#em qualquer tópico e tentando gerar uma saída do AEM Sites. - O erro ocorre durante a etapa de pré-processamento do DITA-OT.
Para obter contexto adicional, consulte a documentação de endereçamento baseado em URI DITA:
Resolução resolution
-
Atualize o elemento xref para usar percent-encoding para o caractere #.
Em vez de usar<xref>mailto:#example@example.com</xref>, codifique # como%23.Por exemplo:
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.