On 10/06/13 02:33, Lex Trotman wrote: > Hi Tong, > > The setext <http://en.wikipedia.org/wiki/Setext> title are hostile > to syntax highlighting, and cause all kinds of other inconveniences. > E.g., > > > Depends on your editor, and anyway who uses syntax highlighting ;) > > > - It takes 0.2 seconds for me to tell what level of single line > title is; whereas I'd scratch my head very hard on seeing the > settext titles and trying to identify them. > > > And I'm the other way, I guess its what we each are used to :) > > > - Moreover, I'm an perfectionist, if I'm to use the settext titles, > I'll be obsessed to make the underline the same width as the title, > which I would hate to do but feel obligated. > > > Well, actually you *are* obligated, since they have to be within 2 > characters to be recognised. > > > That's the foremost reason I hate them. Furthermore, if none-mono > fonts are used for title syntax highlighting, then it'd be next to > impossible to make them line up perfectly. > > > Now the non-monospaced fonts argument is the first one that actually > makes sense, yes it would be virtually impossible. For me I am usually > documenting code, so my editor is usually set to mono anyway (have you > ever tried to do code indenting with non-mono fonts :) and I only speak > ASCII so I don't have problems with wide characters. > > > > That's going to drive me mad. > - Most importantly, single line titles make it extremely easy to > shift title levels up and down, which happens quite often when I > want to "borrow" contents from other places or simply rearranging > things. > > > Yep agree, its easier since most editors can easily be made to globally > add or subtract one from the numbers of === > > Still, while your arguments make sense, I'll stick to what I am used to > and you can use what you like, thats the nice thing about flexibility :)
The complaints about two-lined titles are from the perspective of the document writer (single-line titles are easier to write and maintain), but I think there's a valid argument to be made that two-lined titles are more easily understood and aesthetically more pleasing to casual readers who are not familiar with the AsciiDoc syntax (if you stick to single-byte character sets that is). Thinking back, that was my original rationale -- I put one-line titles in mainly as a sop to users from one-line markups and not because of any revelation that one-lined titles were better. So (back-peddling on my previous post) I won't deemphasize two-lined titles. Cheers, Stuart > > Cheers > Lex > > > In comparison, each time that I have to do the same thing in Ms > Word, e.g., changing all header 2 to header 3, I'd > curse vigorously how brain-dead Micro$oft is to make my life harder. > > > > -- > You received this message because you are subscribed to the Google > Groups "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, > send an email to [email protected] > <mailto:asciidoc%[email protected]>. > To post to this group, send email to [email protected] > <mailto:[email protected]>. > Visit this group at http://groups.google.com/group/asciidoc?hl=en. > For more options, visit https://groups.google.com/groups/opt_out. > > > > > -- > You received this message because you are subscribed to the Google > Groups "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, send > an email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/asciidoc?hl=en. > For more options, visit https://groups.google.com/groups/opt_out. > > -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc?hl=en. For more options, visit https://groups.google.com/groups/opt_out.
