dhis2-devs team mailing list archive

[Bob Jolliffe <bobjolliffe@xxxxxxxxx>]

2009/9/11 Bob Jolliffe <bobjolliffe@xxxxxxxxx>

> 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.
>

There are a couple of stylesheets out there which can do that - google
xhtml2docbook


>
> Cheers
> Bob
>
>
>
> 2009/9/11 Jason Pickering <jason.p.pickering@xxxxxxxxx>
>
>
>> 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 <knutst@xxxxxxxxx>
>>
>> 2009/9/11 Lars Helge Øverland <larshelge@xxxxxxxxx>
>>>
>>>>
>>>>> 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     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
>>>> 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     : dhis2-devs@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~dhis2-devs<https://launchpad.net/%7Edhis2-devs>
>> More help   : https://help.launchpad.net/ListHelp
>>
>>
>