On 23 June 2011 12:18, Grant Edwards <[email protected]> wrote: > 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.
Asciidoc is of course smarter! (or at least doesn't try to be smart so it isn't so dumb :-) So get them to change to asciidoc. Preformatted content and images being too big is not something the generator should care about. Yes they might extend beyond the normal text (especially if the user has a small font size) and may need scrolling but the user only has to scroll to read the image/preformatted content not the text. Cheers Lex -- 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.
