Improving http://dlang.org/library/index.html

[Andrei Alexandrescu via Digitalmars-d]

On 1/11/15 4:01 PM, Mathias LANG wrote:
> On Sunday, 11 January 2015 at 20:22:02 UTC, Andrei Alexandrescu wrote:
>> I'm looking into ways to improve http://dlang.org/library/index.html.
>> Specifically I want to remove (some of) the std.c modules or at least
>> move them below, render the module names in code font, etc.
>>
>> Again, ddox is rather opaque. Is there a source for that page, or is
>> it hardcoded somewhere? Searching for the title 'API documentation'
>> yields no results.
>>
>>
>> Thanks,
>>
>> Andrei
>
> Surely what matters most should be at the top, not the C bindings :)

Yes, the sorting order is björked in several ways.

> So, assuming you know the basics of diet templates (if not:
> http://vibed.org/templates/diet ), you should know that ddox is based on
> a views hierarchy.
> You have `layout.dt` at the base of the hierarchy, then
> `ddox.layout.dt`, then, either `ddox.overview.dt` (which is the
> `index.html` we're talking about), `ddox.module.dt`, `ddox.docpage.dt`.
> `ddox.docpage.dt` includes various other templates to present a page
> that'll depend of the kind of symbol. Those are the ddox.inc.*.dt pages:
> https://github.com/rejectedsoftware/ddox/tree/master/views
>
> The inheritance can be overriden, and so should the includes (never
> tried it though).
>
> TL;DR: Define a `ddox.overview.dt` in the `views` folder (original
> source:
> https://github.com/rejectedsoftware/ddox/blob/master/views/ddox.overview.dt
> ). Then, as you see, you can just use D code to generate HTML.

Thanks!

Could someone please get on this? The few of us working on this can't do 
everything. Most of the work involved is highly parallelizable.

Please? Please? With sugar on top?


Thanks.

Andrei