Andras Mohari writes:
On Wed, Aug 14, 2002 at 12:51:18 +0200, Diego Biurrun wrote:
The problem here is that ASCII structuring techniques are mixed with HTML structure throughout the docs. In plain text docs it is ok to use some kind of email/IRC style with ALL CAPS, _underlined_ and such for stuff that is *really* IMPORTANT!!! HTML does offer markup like <i> and <b> or even better <em> and <strong> for this and in the HTML documentation these should be the preferred method of putting emphasis on certain aspects.
I agree. <em> and <strong> would do just fine. Very important notes could be displayed in separate blocks with large margins (similar to the way DocBook formats notes/warnings/tips). But it would be an impossible search & replace mission. :-)
I am currently converting the docs to use proper headings tags, expect a commit in the next days. Changing <B> to <STRONG> or <EM> would be a logical next step, let's see. skin-en.html does it very nice with red warnings and green notes, maybe we could adopt that for the rest of the docs. So many ideas, so little time :-(
Who knows, once we have XML, maybe we can make a stylesheet that translates into plaintext with these types of emphasis..
Hm, yes, if somebody is a master at stylesheets... I'm not. :(
Of course that is just a pie in the sky fantasy, but who knows :-) Diego