Chris Chiasson wrote: > > Someone has to be evil and mention this: > MediaWiki >
SAGE already uses a MoinMoin Wiki installation. > If you are willing to sacrifice absolute editorial control, the wiki > documentation can develop organically at its own pace and in the > manner that the writers choose. > We (the [Ap]CoCoA people) are using a MediaWiki installation for documentation management. The main problem we have had is the transfer of the WikiText to other formats and the import of existing documentation in XML format. While there are various tools out there to do transfer to and from DocBookXML and so on none of them get it 100% right. One of us spend 6 months on the MediaWiki parser and lets just say that in the end we went with some XML format + XSLT transformation extension, so that we use out own XML tags that are dynamically tanslated to WikiText for rendering. In the end that way we bypassed the MediaWiki parser completely. With the extension we can pull and push all documentation in XML format in and out of the Wiki to/from revision control (CVS or mercurial) and then translate the XML to PDF, Html, manpages and so on. With enough discipline, i.e. using only the subset of tags that "work", this is a non-issue, but from experience I can tell you that this is a lot more work and requires a lot of handholding and supervision. > There is already a site that wove together Mathematica and MediaWiki. > The same could probably be done for SAGE. Of course, that site hasn't > done so well because the Mathematica user base is so small Small compared to what? Maple or MATLAB? There are certainly many more (probably orders of magnitude) Mathematica than SAGE users (until SAGE achieves [mathematical software] world domination - I am sure it is only a question of time ;) SAGE users may be more open to participate in the creation of documentation because the vast majority "get" open souce. > and the pre- > existing documentation for Mathematica nullifies much pf the possible > benefit of the wiki. Not to mention that MMA 6 broke the site... > Well, the Mathematica book is rather expensive, but the Html documentation is certainly nice. > Doesn't MediaWiki already support some TeX/LaTeX? Yes, there are at least two plugins that add LaTeX support. <SNIP> Cheers, Michael --~--~---------~--~----~------------~-------~--~----~ To post to this group, send email to sage-devel@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sage-devel URLs: http://sage.scipy.org/sage/ and http://modular.math.washington.edu/sage/ -~----------~----~----~----~------~----~------~--~---
