Worrying attitudes to the branding of the D language

via Digitalmars-d digitalmars-d at puremagic.com
Wed Jul 2 13:36:27 PDT 2014


On Wednesday, 2 July 2014 at 19:51:29 UTC, w0rp wrote:
> I've been aiming for making text readable, using headings and 
> navigation to make documents easier to jump through, sticking 
> with things which will render quickly, etc. A lot of work so 
> far has just been for formatting text.

A very nice improvement would be to use nested elements for 
formatting indentation in code examples. Then it will line wrap 
correctly when reducing the width of the browser window. I like 
to have my editor and the browser window side by side on a single 
screen, so it should render well on narrow widths.

I remember making a XSLT stylesheet for transforming generic XML 
code formatting into nested HTML once, it isn't all that 
difficult (but a bit tedious). Maybe the dparser can be used 
since it can generate XML from D code. It might be possible to 
achieve this with just dparser+XSLT.

I generally think one should consider specifying a unifying XML 
format for the site documentation and compile down other formats 
(markdown, ddoc etc) to that format before generating either 
webpages, docbook, open office, or whatever.



More information about the Digitalmars-d mailing list