Problem with numbering of appendices

Post here questions and problems related to editing and publishing DITA content.
susannecm
Posts: 109
Joined: Wed Mar 17, 2010 1:04 pm

Problem with numbering of appendices

Post by susannecm »

Hi everyone,
we are using Oxygen version 25.1 to create and publish our DITA documents in PDF and WebHelp format. PDF creation is CSS-based. Our opt file contains the following entry:

Code: Select all

<parameter name="args.css.param.numbering" value="deep-chapter-scope-no-page-reset"/>
This is working pretty much the way we want it for documents with parts. With these documents, the first appendix has the number A.
However, we do not like the results if the documents have no parts but do have an appendix. In this case, chapter 10 might be followed by appendix K.
Any ideas on how to resolve this?
Thank you for your help.
Susanne
andrei_pomacu
Posts: 39
Joined: Mon Jul 25, 2022 11:18 am

Re: Problem with numbering of appendices

Post by andrei_pomacu »

Hi,
I tested in Oxygen version 25.1, and the only problem that I found was that in the TOC, the counter for the Appendix is reset. To resolve this issue, you can add the following CSS customization rule:

Code: Select all

*[class ~= "map/map"][numbering ^= 'deep'] *[class ~= "bookmap/chapter"] + *[class ~= "bookmap/appendix"] {
    counter-reset: toc-chapter 0 !important;
}
This is my bookmap structure that I tested with:

Code: Select all

<bookmap id="taskbook">
    <chapter href="topics/installing.dita">
        <topicref href="tasks/installstorage.dita">
            <topicref href="tasks/replacecover.dita"/>
        </topicref>
        <topicref href="tasks/installwebserver.dita">
            <topicref href="tasks/restart.dita"/>
        </topicref>
    </chapter>
    <chapter href="tasks/configuring.dita">
        <topicref href="tasks/configurestorage.dita"/>
        <topicref href="tasks/configurewebserver.dita"/>
        <topicref href="tasks/configuredatabase.dita"/>
    </chapter>
    <chapter href="tasks/troubleshooting.dita">
        <topicref href="tasks/drivetrouble.dita"/>
    </chapter>
    <appendix href="topics/task_appendix.dita"/>
</bookmap>
Please let me know if you have any questions.

Regards,
Andrei
susannecm
Posts: 109
Joined: Wed Mar 17, 2010 1:04 pm

Re: Problem with numbering of appendices

Post by susannecm »

Hi Andrei,
My description wasn't precise enough, sorry about that.
We actually want the appendix counter to be reset; the first appendix should have number A.
This does happen in bookmaps with parts.
However, in bookmaps without parts, the result is inconsistent. In the TOC, the first appendix has the number A, but in the PDF bookmarks and in the topic title, depending on the number of chapters, the same appendix might have the number K.
Kind regards,
Susanne
andrei_pomacu
Posts: 39
Joined: Mon Jul 25, 2022 11:18 am

Re: Problem with numbering of appendices

Post by andrei_pomacu »

Hi,
To reset the appendix chapter number, please add the following CSS customization rule:

Code: Select all

*[class ~= "topic/topic"][topicrefclass ~= "bookmap/part"] + *[topicrefclass ~= "bookmap/appendix"],
*[class ~= "topic/topic"][topicrefclass ~= "bookmap/chapter"] + *[topicrefclass ~= "bookmap/appendix"],
*[class ~= "map/map"][numbering ^= 'deep'] *[class ~= "topic/topic"][topicrefclass ~= "bookmap/part"] + *[topicrefclass ~= "bookmap/appendix"],
*[class ~= "map/map"][numbering ^= 'deep'] *[class ~= "topic/topic"][topicrefclass ~= "bookmap/chapter"] + *[topicrefclass ~= "bookmap/appendix"] {
    counter-reset: chapter 0 chapter-and-sections 0 !important;
}
susannecm
Posts: 109
Joined: Wed Mar 17, 2010 1:04 pm

Re: Problem with numbering of appendices

Post by susannecm »

Much better, thank you!
Post Reply