Ubuntu Wiki

Goals

The goals of this page are...

• to review projects for web-based management of DocBook documentation

• to suggest ideas and strategies for web-based DocBook management

• to complement DocBookEditors but focus on web-based tools

Projects

This section lists current projects relevant to developing a web-based Document Management System (DMS) for DocBook.

Borges

• homepage: http://www1.mandrivalinux.com/documentation/project/Borges/

• engine: apache + perl
• pros: translation support, fairly mature project
• cons: uses LaTeX toolchain, not aesthetically pleasing interface
• comments:

DocBookWiki

• homepage: http://doc-book.sourceforge.net/homepage/

• engine: apache + php + phpWeb framework
• pros: nice interface, uses xsltproc
• cons: demo site looks buggy/, security issues, incomplete code, not sure about ongoing development
• comments:

MoinMoin

• homepage: http://moinmoin.wikiwikiweb.de/

• engine: apache + python
• pros: already used for official Ubuntu wiki

• cons: although it can be made to generate DocBook, natively it is stored in WikiText

• comments:

  • according to MoinMoin wiki "MoinMoin 1.3.5 supports DocBook parsing and generation."

    • see http://moinmoin.wikiwikiweb.de/DocBook

  • Very ugly formatting

SilkPage

• homepage: http://silkpage.markupware.com/

• engine: apache + java
• pros: beautiful pages, simple design

• cons: uses DocBook Website document type not Book, not sure about licensing

• comments:

Sarma

• homepage: http://live.gnome.org/LiveDocumentationEditing

• engine: apache + python
• pros: nice handling of tags in javascript, presentation similar to XXE
• cons: demo site seems very slow to respond
• comments:

Docudo

• homepage: http://www.checkandshare.com/blog/?p=42

• engine: Apache + Python
• pros: appears to be in active development
• cons: does not support Docbook at all and no plans to either, simple text editor, no real web site, small community/developer base.
• comments: a Docbook plugin could be created for this by us.