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.blijdest...@gmail.com <mailto:lutger.blijdest...@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
