Page 1 of 1

phpDocumentor + Wiki?

Posted: Thu Sep 24, 2009 3:16 am
by Inkyskin
Hey all, does anyone know if it's possible to get phpDocumentor to export to a wiki format? I've googled for ages but cant seem to find anything useful :(

Or - is there an alternative to phpDocumentor that might do it? I really want to use a wiki, but really don't want to type it out by hand :lol:

Re: phpDocumentor + Wiki?

Posted: Sun Sep 27, 2009 11:20 pm
by josh
That doesn't make sense because if someone edited the "wiki" it would get overwritten. The proper way to do this would be to probably make a subversion branch where people can commit documentation changes, then merge them into your trunk at your discretion ( and then regenerate the docs by calling the phpdocumentor utility again )

Re: phpDocumentor + Wiki?

Posted: Mon Sep 28, 2009 2:46 am
by Inkyskin
The reason would be so I could expand on the documentation with other pages a lot more easily (With guides etc), and it would all look uniform. I'd be locking down the ability for other people to edit.

Re: phpDocumentor + Wiki?

Posted: Mon Sep 28, 2009 9:14 am
by josh
That's not really a wiki then, phpdocumentor lets you write "guides" and even link them to your docblock tags, so in the generated documentation its all linked up. I even used phpdocumentor to do the http://www.datashuffler.org homepage, you can literally use any XSL to build your own XHTML, with docbook you just write your chapters and semantically link them up in your documentation, no "wiki" is ever needed ( even I need collaborative editing I'd grant SVN commit access )

Re: phpDocumentor + Wiki?

Posted: Mon Sep 28, 2009 9:16 am
by Inkyskin
Ah, that sounds good, thanks :)

Looks like I've got some reading up to do ;)