Re: Recommendation for best format for Maven Documentation

2008-12-29 Thread Lammert Westerhoff
Hi, There are various ways of doing this. I also did similar work like moving docs from Wiki to Maven. To generate the Maven websites I mainly used the APT format. I have no experience in working with XDoc but I think its worthed to look into this as an alternative as well. Besides that, I also cre

Re: Recommendation for best format for Maven Documentation

2008-12-29 Thread Ahana
Thanks, Vincent. My responses: -I have to convert MediaWiki docs. -The developers are expected to update the documents once I set up the structure. Do APT and XDoc both support cross-references, headers and footers? Vincent Siveton wrote: > > Hi Ahana, > > - which Wiki? Doxia supports TWik

Re: Format support for cross-referencing, headers and footers

2008-12-29 Thread Vincent Siveton
Hi, yes, via the doxia-sitetools. We used Velocity inside, so you could always customized header/footer. Internal links are handle too. [1] is a good sample to see your requirements live. [2] is a book HTH Cheers, Vincent [1] http://maven.apache.org/ [2] http://maven.apache.org/doxia/doxia-exa