I think docbook is a really good choice for DHIS documentation. And the emacs mode works more than fine ...
Openoffice will also save as docbook. I haven't checked how clean it is, but it is possibly a good route for first pass conversion from ms word. Cheers Bob 2009/9/10 Jason Pickering <[email protected]> > Hi Lars, > > I prefer XMLSpy, but this a personal preference, and I am used to > using it. It is a commercial product, but very good. > > As for free products, Vex is pretty good and simple, but not sure it > is actively maintained. XMLMind was pretty good as well, but not quite > as easy to use as Vex. > > If you prefer text based editors, JEdit is a good choice. Notepad++ > for Windows users may be an option as well. > > Of course there is always good ole Emacs. > > There is a long list available here. > > http://wiki.docbook.org/topic/DocBookAuthoringTools > > I have committed a portion of the GIS user manual, along with a HTML > file with one of the many XSLs availble for DocBook format in the docs > section for review. If there is enough interest, I will go ahead and > convert the rest of the document. > > Best regards, > jason > > > > > Regards, > Jason > > > On 9/10/09, Lars Helge Øverland <[email protected]> wrote: > > Hi Jason, this looks interesting, can you recommend a docbook editor? > > > > Lars > > > > > > On Wed, Sep 9, 2009 at 8:31 PM, Jason Pickering > > <[email protected] > >> wrote: > > > >> Hi Everyone, > >> > >> I have been speaking with Jan and Old a bit about documentation and > >> before > >> I start committing anything, or making too many changes, I would like to > >> get > >> some feedback from everyone. > >> > >> Let me be quite honest. I find the documentation of DHIS2 to be quite > >> appalling. It is scattered between different Wiki sites, Launchpad, > >> mailing > >> lists, and various documents here and there. We need to do better. > >> > >> Jan has started a document on the GIS portion of DHIS2 and I would like > >> to > >> suggest that we standardize all documentation by using the DocBook > >> format.Visit www.*docbook*.org for more info. I will not repeat the > >> various advantages of using this format over others, other than to say > it > >> is > >> very common, it is structured, and is supported by a large number of > >> editors > >> and can be transformed into essentially any format . Since DocBook is > >> pure > >> XML it is much more suited to the sort of distributed development > >> environment we are working in, as opposed to say proprietary, binary > word > >> documents or other formats. > >> > >> Any reactions here? I have started a bit of work on the conversion of > the > >> GIS manual to DocBook format, but wanted to get feedback from the > >> community > >> before I proceeded much further. Of course, documentation in a structure > >> format like XML will be a bit more painful, but there are several tools > >> out > >> there (many of them OpenSource) that provide good editors for the > format. > >> Of > >> course the ability to transform this XML info many different formats, > >> such > >> as HTML, Word, PDF, JavaHelp files (the list is very long) is a big > >> advantage in my mind. > >> > >> What does everyone think? > >> > >> Best regards, > >> Jason > >> > > > > _______________________________________________ > Mailing list: > https://launchpad.net/~dhis2-devs<https://launchpad.net/%7Edhis2-devs> > Post to : [email protected] > Unsubscribe : > https://launchpad.net/~dhis2-devs<https://launchpad.net/%7Edhis2-devs> > More help : https://help.launchpad.net/ListHelp >
_______________________________________________ Mailing list: https://launchpad.net/~dhis2-devs Post to : [email protected] Unsubscribe : https://launchpad.net/~dhis2-devs More help : https://help.launchpad.net/ListHelp
