On 2011-06-23, Lex Trotman <[email protected]> wrote: >>> See the admonition :-) at the beginning of user guide 12.4.1 and later >>> where it explicitly says "Use the caption attribute to customize the >>> admonition captions (not applicable to docbook backend)." >> >> Yep. Found it. >> >> Unfortunately, the user guide at >> http://www.methods.co.nz/asciidoc/userguide.html >> is formatted such that it's so wide (at least in my browser) it's >> difficult to read due to the constant left/right scrolling required. >> In my browser a normal paragraph averages about 170 characters wide. > > Welcome to my campaign for limited width text web pages in accordance > with W3C guidelines (about 80 characters ~ 35-40em). All Stuart has to > do is set :max-width: 40em instead of its current value of 70em, > please feel free to hassle him, I've been banging on in this and other > forums about it too much lately, people will be thinking I'm obsessed.
I think I've complained about it before. I've also complained about the same readability issues with auto generated web pages at other sites (e.g. Gentoo documentation pages), but often they claim that there's nothing they can do about it because they html-generator is too dumb to realize that just because one line of pre-formtted source code is 150 characters long that doesn't mean everything else needs to be formatted that wide. -- Grant -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/asciidoc?hl=en.
