http://d-programming-language.org/ 404 & small proposal

Andrei Alexandrescu SeeWebsiteForEmail at erdani.org
Sat Dec 11 11:13:22 PST 2010


On 12/11/10 11:56 CST, Jimmy Cao wrote:
> I think bold instead of all caps would be better.  Either way is fine,
> though.
>
> On Fri, Dec 10, 2010 at 4:05 PM, Lutger Blijdestijn
> <lutger.blijdestijn at gmail.com <mailto:lutger.blijdestijn at gmail.com>> wrote:
>
>     Andrei Alexandrescu wrote:
>
>      > On 12/9/10 8:04 PM, Andrej Mitrovic wrote:
>      >> The D website is 404'ing for the library page:
>      >>
>      >> http://d-programming-language.org/phobos/phobos.html
>      >>
>      >> And I've had an idea to make the documentation website a little
>     easier to
>      >> navigate. Here's what the docs look like with their old design:
>      >>
>      >> http://imgur.com/8Vdrj.jpg
>      >>
>      >> Now, that's quite a mess to look at. The text isn't aligned or
>     anything
>      >> so it doesn't look that good, and you can't really tell which of
>     those
>      >> names are functions, class definitions or enums, etc.
>      >>
>      >> So I just quickly sketched out what I'd like to see instead:
>      >>
>      >> http://imgur.com/0lufR.jpg
>      >>
>      >> Disregard the off coloring, font sizes, and my general lack of
>     design
>      >> skills please :). The main point is to put the links in a table so
>      >> they're aligned and easier to browse, and maybe even categorize
>     all the
>      >> names by their type (functions/enums/etc).
>      >>
>      >> I'm pretty sure adding a table is trivial, but I don't know if
>     we can
>      >> automatically categorize all the names and put them in separate
>     tables.
>      >>
>      >> Thoughts?
>      >>
>      >
>      > Very nice initiative. I'm not sure how we can implement that easy
>      > without considerable effort; currently, the list is generated with
>      > Javascript using a flat list. To generate a more structured list, the
>      > programmer would need to insert appropriate cues in the
>     documentation.
>      >
>      > Andrei
>
>     With the json files dmd produces it can be automated, and you can do
>     it the
>     ddoc way (so latex and other formats would also be supported.) A
>     disadvantage is that ddoc processor has to be ran twice plus an
>     additional
>     pass over the json is needed. ddoc support for this would obviously be
>     better. I got this far (but it uses non-standard css3):
>
>     https://dl.dropbox.com/u/6777848/ddoc_index.jpeg
>
>     I'll share the tool when it's more complete, if this is something
>     that is
>     wanted for phobos I am willing to put it together.

Yes please. Other Phobosites?

Andrei


More information about the Digitalmars-d mailing list