AEM Guides: xref가 Link에서 mailto:# 를 사용할 때 사이트 생성이 실패합니다
이 문서는 xref에 # 문자로 시작하는 mailto 링크가 포함된 경우 Adobe Experience Manager Guides의 사이트 생성 오류를 해결합니다.
설명 description
환경
Adobe Experience Manager Guides (모든 버전)
문제/증상
사전 설정을 사용하여 AEM Sites 출력을 생성할 때 xref 요소에 # 문자로 시작하는 mailto 링크가 포함되어 있으면 프로세스가 실패합니다(예: mailto:#example@example.com).
사이트 생성 중 다음 오류가 발생합니다.
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
- 모든 항목에서
mailto:#이(가) 있는 xref를 추가하고 AEM Sites 출력을 생성하려고 하면 문제가 재현될 수 있습니다. - DITA-OT 사전 처리 단계에서 오류가 발생합니다.
추가 컨텍스트를 보려면 DITA URI 기반 주소 지정 설명서를 참조하십시오.
해결 방법 resolution
-
# 문자에 대해 퍼센트 인코딩을 사용하도록 xref 요소를 업데이트합니다.
<xref>mailto:#example@example.com</xref>을(를) 사용하는 대신 #을%23(으)로 인코딩하십시오.예:
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.