fatima-qaisar opened a new pull request, #1039:
URL: https://github.com/apache/tomcat/pull/1039
Fix the XSLT template for nested `<subsection>` elements so that the
generated heading level reflects the nesting depth.
Previously, every `<subsection>` was rendered as `<h4>`, regardless of
whether it was nested inside another subsection.
The template now generates:
- `<h4>` for subsections directly under a `<section>`
- `<h5>` for subsections nested one level deep
- `<h6>` for subsections nested two or more levels deep
Testing:
- `ant build-docs` - confirmed the generated documentation builds
successfully and the headings are rendered correctly in the output
- Verified visually with a local test XML document containing nested
subsections; the generated headings now use the expected h4 → h5 → h6
hierarchy.
Screenshots attached showing the correct rendering in both:
- an actual Tomcat documentation page
<img width="851" height="512" alt="test"
src="https://github.com/user-attachments/assets/9ea1a7f8-14fc-4e61-89fa-cb32435bea5e";
/>
- the local nested-subsection test XML output
<img width="570" height="619" alt="nesting test"
src="https://github.com/user-attachments/assets/c2522558-f325-4d08-9c72-eb712b45224f";
/>
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
