-
-
Notifications
You must be signed in to change notification settings - Fork 3.6k
Description
Hi,
I tried to use docbook to translate postgres' documentation into other formats. That mostly works, but postgres' docs use <part>
. There's two issues with that:
- links to parts end up named "part_title" (similarly, links to books end up as "book_title")
- the TOC hierarchy ends up flattened (parts and chapters in the same hierarchy), making the TOC way too long to be useful, because toc-depth doesn't work anymore.
The first is quite easy to fix. Adding a line for part and book to xrefTitleByElem) + tests. I didn't yet open that as a PR, because to test that I need to add a part to test/docbook-xref.docbook - and I am not sure you want to do that without actually supporting part?
The second issue looks harder to fix entirely - I guess chapters, sect$n's all need to shift their heading level by one if they are in a a part?
How incrementally can things like this be integrated? It seems to me, a good first step would be to wire up part, partintro, partinfo, without adjusting the heading levels? And then subsequently adjust those as well?
Regards,
Andres