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