Post details: Wikis: tagging releases and building distributable docs

Mar 07, 2006 : Wikis: tagging releases and building distributable docs

I want to create project documentation on a wiki, and be able to build well-versioned, distributable releases. I've yet to find a wiki that can do this.

First, you have to be able to generate stand-alone documents (preferably HTML or PDF) that are still navigable and usable (i.e. not just a big dump of the wiki). Some wikis do this.

Second, you have need to store the documents in a versioned repository. One like subversion, that will support tags. You should be able to tag the whole wiki as "release-0.3" and then be able to browse the whole wiki as it was at that release and be able to rebuild that release's PDF/HTML docs. Subwiki seems to be dead; Kwiki has a SVK (distributed SVN) plugin, but I haven't tested it yet and I doubt you can browse "at" a tagged release.

Comments, Pingbacks:

Comment from: Jan Matèrne [Visitor]
Long time ago .... but I remember that I read that Apache Forrest should be able to convert wiki-format to pdf/html...
Permalink 03/08/06 @ 05:03
Comment from: Dave Brondsema [Member] · http://brondsema.net/
Yes, it does. A few years ago I set up several JSPWiki instances and wrote ant scripts to get all the wiki source files, place them into Forrest sites and build "wholesite" PDFs. However, the conversion from wiki-format was imperfect and the "wholesite" feature of Forrest had some bugs I never managed to fix.
Permalink 03/08/06 @ 07:38

Leave a comment:

Your email address will not be displayed on this site.
Your URL will be displayed.
What is the 2-letter abbreviation for Michigan?
Allowed XHTML tags: <p, ul, ol, li, dl, dt, dd, address, blockquote, ins, del, span, bdo, br, em, strong, dfn, code, samp, kdb, var, cite, abbr, acronym, q, sub, sup, tt, i, b, big, small>
Options:
 
(Line breaks become <br />)
(Set cookies for name, email & url)

<  August 2019  >
Mon Tue Wed Thu Fri Sat Sun
      1 2 3 4
5 6 7 8 9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31  

Categories


Archives

Misc

Syndicate this blog XML

powered by
b2evolution