Re:Asciidoctor – A fast, open-source text processor and publ...
by Someone on Monday January 07, 2019 @05:30PM
(#18850923)
Another argument in favor of adding markers for lower levels is that indenting the first character of a header typically indicates lower level headings in a table of contents.
Chapter 1 ............... 5
Section 1a ............. 7
Section 1b ............ 11
Chapter 2 .............. 17
Section 2a ............ 21
is nicely similar to # Chapter 1
Lorem ipsum dolor sit amet.
## Section 1a
Lorem ipsum dolor sit amet.
## Section 1b
Lorem ipsum dolor sit amet.
# Chapter 2
Lorem ipsum dolor sit amet.
## Section 2a
Lorem ipsum dolor sit amet.
Re:Asciidoctor – A fast, open-source text processor and publ...
by smartmic on Monday January 07, 2019 @04:01PM
(#18850014)
From a technical implementation point of view, I agree. But I had the viewpoint of a visually guided human, the non-technical type.
That is also why I stick to reStructeredText, they circumnavigate ATX-style headers at all.
Re:Asciidoctor – A fast, open-source text processor and publ...
by smartmic on Monday January 07, 2019 @04:11PM
(#18850126)
Concerning the baseline, doesn't the HTML5 standard just specify 6 ranks from <h1> … <h6>? Would be at least a candidate for common agreement on the lowest (highest) rank.
Re:Asciidoctor – A fast, open-source text processor and publ...
by occamrazor on Monday January 07, 2019 @04:37PM
(#18850418)
HTML5 also supports nestet <section> with their <h> tags. I’m not sure if there is a maximum nesting level in this case.
= heading
If you were to do it the other way around, there's no easy way to know which would would map to h1
======= this?
============= this?
The second reason why is because you have to have a baseline of maximum-importance. It's like ticket priorities capping out at P0 for maximum priority. The first intuitive thought would be that P5 should be more important than P0, but if you don't set a baseline of maximum importance, then there will always be someone who feels their thing is slightly more important.
========== Top level heading
=========== Super top level heading
============== Extra super top level heading deluxe