Login  Register

Re: Toc rendering options in Asciidoctor.js

Posted by mojavelinux on Jul 26, 2015; 10:02pm
URL: https://discuss.asciidoctor.org/Toc-rendering-options-in-Asciidoctor-js-tp3564p3571.html

On Sun, Jul 26, 2015 at 3:24 AM, abelsromero [via Asciidoctor :: Discussion] <[hidden email]> wrote:
Perfectly clear now.

+1
 

I think that offering a good initial user experience is very important (even if the target audience is developers enjoying hacking).

100% agreed.
 

Btw, related to this subject, should we consider reviewing the usage of “showtitle” and “notitle” as well? When you read the documentation is clear that they apply to different scenarios, but having two options with opposite meanings it's weird to me.

Actually, `showtitle` is the official attribute name and `notitle` is deprecated. We should gradually phase out mention of `notitle` as a negative attribute name is very confusing.

(There may still exist some bugs around the use of `showtitle`, but let's just identify those and get them fixed).

 
For instance, we could use showtitle always, but set it to true by default when footer_header is true, and false otherwise.

This is an open issue scheduled for 1.6.0. See https://github.com/asciidoctor/asciidoctor/issues/1149

Cheers,

-Dan

--