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.
