Suppressing automatic promotion of deeper headings
Is it possible to suppress automatic promotion of deeper level headings? (reference how headings are handled)
Usually I use h5 and h6 to behave like small headings for sections without numbering. The problem is that I often miss h3 and h4 heading and the automatic promotion behavior transform my h5 (correctly set up to have no numbering) in a h3 heading, which I'd like to have numbering when I choose it.
So if my page is something like this:
h1 Main section title
h2 Sub-section 1 title
h5 Minor section 1 title
h2 Sub-section 2 title
h6 Minor section 2 title
I'd like that h5 and h6 won't become two h3 headings.
Best regards,
Alessandro Tondo @qbrobotics
EDIT: even a hardcoded solution is fine for my purposes.
-
Hi Alessandro,
Thanks for your post.
Unfortunately, at the moment there is not an option that will prevent our heading algorithm from being used during the export process. As you are aware from the referenced document link, all our exporters use this algorithm to create a sensible hierarchy as Confluence does not enforce proper ordering of headings.
This means when Scroll PDF Exporter parses a tree of wiki pages it converts both the page hierarchy and the headings within a page into a hierarchical section and sets the highest level of heading on a page when it detects the first heading. In your use case, it means your heading 5's and 6's become level 3 headings.
Currently, we have an open improvement that pertains to introducing an option that will allow users to disable the algorithm. You can track this here: https://k15t.jira.com/browse/EXP-428. I would recommend signing up to our JIRA (via https://k15t.jira.com/secure/Dashboard.jspa) in order to watch, comment and/or vote on this issue. You'll then receive a notification for every status update.
Cheers, Thomas (K15t Software)
-
I want to add to this topic and push the impotance of https://k15t.jira.com/browse/EXP-428 by saying that the promotion feature completely prevents usage of a "small" reusable document concept.
I implemented the creation of subchapters with the PTC (PageTreeCreator) addon, which does the heading for me with predefined structures as I want them. The problem is, that the K15 Export algorithm pushes things on h1 level even with a SubPage category being neatly sorted.
In this case, this should be the levels as expected
But instead, the 2nd Page Header gets L1 as well, breaking to a new page. The 2nd Heading (2) at level 3-5 is ignored alltogether.
I understand the concept behind this, especially when wild heading structures up to h6 are possible, but the algorithm should be configurable to stop the promotion at a certain heading level, e.g. h2 to allow for "room" for user configuration.
Please sign in to leave a comment.
Comments
3 comments