Create section-numbers-tree-processor extension

[andrewcarver]

Allows you to control your DocBook section numbering from within AsciiDoc, with your sectnums and leveloffset attributes (just like they work with the HTML5 backend). Control over styles--at each level--and more. Updated to work with Asciidoctor 1.5.7, including Parts-numbering.

This extension was inspired by the Asciidoctor discussion topic http://discuss.asciidoctor.org/asciidoctor-fopub-tp6285.html

[mojavelinux]

This seems very useful for those who need fine-grained control over section numerals. I wonder, though, whether it would be better putting this in asciidoctor-fopub. What do you think? Does it make sense outside of that context?

[andrewcarver]

Well, the scheme I've adopted here is to add the sec.-numbering before we get to fopub--on the way from AsciiDoc to DocBook XML. (The idea being, to have nice control over such numbering, in not only HTML5 conversion, but also the XML conversion--rather than trying to handle all that by tweaking your XSL/fopub parameters or whatnot.) So I confess, I don't see how it could work as a direct inclusion in fopub... which presupposes the DocBook XML as its input. Have I missed some premise of the question?

[andrewcarver]

Also, consigning it to FOPUB (assuming that is possible) seems to suppose that nobody using the Asciidoctor-thru-DocBook toolchain would ever want to do it apart from fopub. Which may be true, but seems to me a hefty assumption...

[mojavelinux]

This extension is entirely too complex for this lab. You are welcome to publish it out of your own repository if you would like to share it with others.