dlang.org Library Reference

[Sönke Ludwig]

Am 11.12.2012 22:13, schrieb Andrei Alexandrescu:
> On 12/11/12 3:54 PM, Rob T wrote:
>> On Monday, 10 December 2012 at 22:33:49 UTC, 1100110 wrote:
>>> On 12/10/2012 05:16 AM, Mr. Anonymous wrote:
>>>> On Monday, 10 December 2012 at 02:10:43 UTC, Ellery Newcomer wrote:
>>>>> Is anyone else noticing e.g. std.datetime taking upwards of 30 seconds
>>>>> to render the blob of links at the top? It's freakin freezing my
>>>>> entire browser.
>>>>
>>>> ddox* on dlang.org, anyone?
>>>> http://vibed.org/temp/phobos/index.html
>>>>
>>>> * https://github.com/rejectedsoftware/ddox
>>>
>>> Man, how did I miss that? I like that.
>>
>> http://vibed.org/temp/phobos/std/datetime.html
>>
>> Wow, that's a HUGE improvement to what has been a very difficult read
>> for std.datetime.
>>
>> I'd like to bookmark the Vibe Phobos reference page for use as my
>> library reference. Will it remain there at least until the official web
>> page reference is improved in a similar or identical way?
> 
> Do whom do we talk about Borging the vibe dox into dlang.org?
> 
> Andrei
> 

Okay, I have prepared a small repository which generates Phobos/Druntime documentation and
integrates it into dlang.org (it currently needs vibe.d installed to build the ddox binary):

https://github.com/s-ludwig/phobos-docs


The paths are currently adjusted for working side-by-side with phobos, druntime and
d-programming-language.org:

-----
/
	/dprogramming-language.org/
	/druntime/
	/phobos/
	/phobos-docs/
-----


There are some batch files that generate the documentation. Running the following sequence will
yield HTML docs in ../d-programming-language.org/phobos/:

-----
cd phobos-docs
vibe build
generate_json
filter_json
generate_html
-----

Example generated site is here:

http://vibed.org/temp/d-programming-language.org/phobos/index.html


Is any further work on this desired? If so, what would be the next steps to integrate it into the
general dlang.org workflow? (or rather, how is that workflow in terms of folder structure, build
scripts etc.?)

It would also need a phase of bug fixing regarding some macros used in the Phobos ddoc comments.