Skip to content

Support docbook <part>s #8712

@anarazel

Description

@anarazel

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

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions