Just had a first glance at section one of the manual. It looks very nice but it is unstructured word processed text - ie. everything is styled "default". So there are no shortcuts to be had - conversion to docbook and creation of structure for the document will be manual. I guess the others will be the same. This will be a bit painful but will add considerable value to the documentation.
Regards Bob 2009/9/11 Ola Hodne Titlestad <[email protected]> > The user manual developed in India is on word format, have a look here: > http://folk.uio.no/knutst/pub/usermanual/ > > Which is linked from the front page of hisp.info (and should be linked > from dhis2.com as well, but it is not at the moment). > > > Ola Hodne Titlestad |Technical Officer| > Health Metrics Network (HMN) | World Health Organization > Avenue Appia 20 |1211 Geneva 27, Switzerland | Email: [email protected]|Tel: > +41 788216897 > Website: www.healthmetricsnetwork.org > > Better Information. Better Decisions. Better Health. > > > 2009/9/11 Bob Jolliffe <[email protected]> > >> Hi Jason >> >> >> I will have a look at odf2docbook. It is just implemented as an xslt >> filter in openoffice so I should be able to get it out. >> >> If there are word documents with reasonable structure (highly unlikely!!) >> then this might be a shortcut to getting a first pass going. Otherwise, >> from word save as xhtml (I presume it can do that) and transform that to >> docbook. >> >> Cheers >> Bob >> >> >> >> 2009/9/11 Jason Pickering <[email protected]> >> >> >>> Aha, there is a user manual, on yet another server! Never knew about this >>> one. :) >>> >>> Wow, there really is a lot of material out there, and it is going to be a >>> monumental task to get into into some type of "proper" form. >>> >>> Well, I am willing to try and coordinate the initial pass at getting the >>> documentation into DocBook, but it will have to be a team effort. This was >>> one of my arguments for moving towards this format, as it should allow >>> collaborative work. This will have to be done in my "spare" time, but I am >>> willing to give it a try, assuming that everyone else is on board, and this >>> is the direction the community wants to go. It will be a lot of work, but it >>> seems that the long-term advantages are abundant. >>> >>> I would still be interested to hear what the technical writer to be >>> engaged by HMN has to say, as we definitely do not want to jump off a cliff >>> here. >>> >>> >>> >>> 2009/9/11 Knut Staring <[email protected]> >>> >>> 2009/9/11 Lars Helge Øverland <[email protected]> >>>> >>>>> >>>>>> The intrinsic problem with formats such as DockuWiki is that they are >>>>>> pretty much a one way street. It is an easy format to use, but not >>>>>> entirely >>>>>> easy to transform into something else. Pure XML formats such as DocBook >>>>>> separate entirely the content away from the presentation. Want Word? No >>>>>> problem. How about PDF? Can do. How about an integrated help system with >>>>>> the >>>>>> application? Should not be an issue as you have pure XML to work with. >>>>>> >>>>> >>>>> I want to emphasize this argument: We have decided earlier to have an >>>>> integrated dynamic help function in dhis2, and we already have a simple >>>>> solution implemented which we can build on. Still, syncronizing the >>>>> content >>>>> of this help function with the general documentation effort would be >>>>> desirable (and necessary). Going for an xml format such as docbook and >>>>> locating the help file inside the repo will solve this issue. Choosing a >>>>> wiki will demand lots of manual work. >>>>> >>>> >>>> Ola and I agree with going for DocBook - so please don't hesitate, >>>> Jason. That said, we should look into ways of making it easy for people to >>>> contribute. An initial approach would be for contributors to send their >>>> material to you, and you make sure it fits in DocBook. >>>> >>>> The changes with release 2.0.2 does probably mean a new manual should be >>>> created. Some material from the previous user manual may still be suitable: >>>> http://folk.uio.no/knutst/pub/usermanual/ >>>> >>>> Knut >>>> >>>> >>>> >>>>> >>>>> Lars >>>>> >>>>> _______________________________________________ >>>>> 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 >>>>> >>>>> >>>> >>>> >>>> -- >>>> Cheers, >>>> Knut Staring >>>> >>> >>> >>> _______________________________________________ >>> 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<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
