Disclaimer:
Adobe Experience Manager Guides was formerly branded as XML Documentation for Adobe Experience Manager. Please note certain references within the documentation may still refer to prior branding but are still applicable to the current offering.
Troubleshoot the issue of non-duplicate file names getting appended with a suffix during AEM Site output generation.
Issue
While publishing to AEM Site output, file names used to get appended with a sequential suffix .
For example, topic files named as Index in folder A, Index in folder B and Section in folder C, resulted in file names getting changed as Index_1, Index_2, and Section_3 during the time of publish.
Although the topic Section is not duplicate, still it gets appended with a suffix.
Cause
While authoring, it is possible to have the same file name for one or more files under different folders. During publish, these duplicate files are handled by appending a suffix.
However, in the current publishing process, even non-duplicate files are appended with a suffix.
Solution
How is this issue now handled?
With the 3.8 release of XML Documentation solution, file name generation process has been fixed. Now, file names no longer get appended with a suffix unless there is duplication of file names involved.
For example, topic files named as Index in folder A, Index in folder B, and Section in folder C, will result in file names getting changed as Index_1, Index_2, and Section during the time of publish.
As the topic Section is not duplicate, it doesn’t get appended with a suffix.
What is the impact of this change?
Due to the changes in the current file name generation process, the existing file/page URLs will change and may lead to 404 error under the following scenarios:
When you republish existing content with duplicate file names.
When you try to access these generated pages via redirects pointing to older page name (URLs with appended suffixes).
When end users try to access the older bookmarked site pages.
Resolution
To resolve the 404 error, modify existing URL redirects to land to new site pages.
