CMS 10.6: Page Navigations Do Not Reflect Changes to DITA Alias Structure
CMS 10.6 Incremental publishes of DITA content do not rebuild page navigations on the DSS. If DITA alias structures contain new changes since the last incremental publish, the DSS page navigation does not reflect these changes.
Statement of Issue
Incremental alias publishes do not trigger the DSS site page navigation to rebuild. If you make updates to your DITA collection that affect the alias structure, the DSS will not include these updates until the page navigation rebuilds.
Symptoms
If you remove an alias from the alias structure and then incrementally re-publish that structure, the link to the removed alias remains in the DSS site navigation, even though the alias is no longer part of the alias structure in the Site Tree. If you unmark the removed alias from publish, then the remaining navigation link will throw a 404 error.
Resolution
An upcoming CMS release will resolve this issue.
As a workaround, choose one of the following options, depending on your CMS 10.6 version.
CMS 10.6.342
After publishing your alias structure, you can run an incremental publish on the xID with the page navigation including the aliases. This publish will rebuild the page navigation. When the rebuild finishes, the DSS navigation will update to include your latest alias structure changes.
CMS 10.6.308
Run a full site publish to trigger the page navigation rebuild. When the rebuild finishes, the DSS navigation will include your latest alias structure changes.
Full site publishes on the DSS are comprehensive. Consequently, you may encounter other issues if you repeatedly run full publishes.
If you plan to make DITA alias structure changes, consider coordinating with your team to minimize the number of full publishes you need to run.
If this workaround introduces conflicts for your site implementation, consider upgrading.
There are no comments yet.