On 2011-06-23, Lex Trotman <[email protected]> wrote: >> 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 the 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.
I suggested that, but they say it would require a lot of work (which I don't doubt). > 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. Exactly. But whatever they use for the Gentoo site formats all paragraphs so that they're the same width as the widest "thing" on the page -- even if that thing is pre-formated source code or a shell session. As you can imagine, the results can be pretty bad -- especially if the monospaced font used for preformatted stuff is wide compared to the "normal" font (and that usually seems to be the case). -- 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.
