Asciidoctor :: Discussion

Use of secnumlevels and Docbook / PDF output

_‹ Previous Topic Next Topic _›

Classic

List

Threaded

2 messages Options

littlepanda

Apr 17, 2014; 7:34pm

Use of secnumlevels and Docbook / PDF output

9 posts

Hello,

From what I understood, the document attribute "secnumlevels" can be used to set the maximum level for section numbering.

This works for HTML5 output but not for Docbook. I guess it's because Docbook has it's own section numbering logic.
However, it may still be useful to pass this setting to the Docbook XML. Maybe as a processing instruction? Then in the Docbook XSL FO customization layer one can make use of this to set the section.autolabel.max.depth parameter for example.

What are your thoughts?

mojavelinux

Sep 17, 2014; 6:53am

Re: Use of secnumlevels and Docbook / PDF output

Administrator

2681 posts

Great idea! We can communicate the max depth using an attribute on the processing instruction. DocBook XSL provides the pi-attribute template to extract the value of an attribute on a processing instruction.

I've opened an issue in Asciidoctor core to add this attribute if sectnumlevels is set (and also if toclevels is set).

https://github.com/asciidoctor/asciidoctor/issues/1091

I've already made the change to fopub in preparation. See: https://github.com/asciidoctor/asciidoctor-fopub/commit/5d80f1641a7cc77c31632af214ebfe079ab44450

Cheers,

-Dan

On Thu, Apr 17, 2014 at 1:34 PM, littlepanda [via Asciidoctor :: Discussion] <[hidden email]> wrote:

Hello,

From what I understood, the document attribute "secnumlevels" can be used to set the maximum level for section numbering.

This works for HTML5 output but not for Docbook. I guess it's because Docbook has it's own section numbering logic.
However, it may still be useful to pass this setting to the Docbook XML. Maybe as a processing instruction? Then in the Docbook XSL FO customization layer one can make use of this to set the section.autolabel.max.depth parameter for example.

What are your thoughts?

If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Use-of-secnumlevels-and-Docbook-PDF-output-tp1684.html

To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML

Dan Allen | http://google.com/profiles/dan.j.allen