dhis2-devs team mailing list archive

[Bob Jolliffe <bobjolliffe@xxxxxxxxx>]

final PS:
There is no harm working with the pieces in article style for now.  But if
we want integrated TOC, index, front-matter etc we will get these better
from a book style.  I think many of the wysiwg tools may just produce an
article header by default.  Probably can be tweaked - or just reassemble the
pieces later ie transform articles into chapters.



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

> I also have no great knowledge of docbook so I guess for that reason, also
> no really compelling reason to move to 5.  Just been reading material on the
> docbook website which suggests 4.x is end of life.  And 5 is hardly bleeding
> edge at this point.  And the fact that version 5 is namespaced and has a
> relaxng schema rather than the older dtd.  Though I concede these are not
> issues which bother most people.  But as long as the schema is available
> there is no good reason not to be able to use either version in any xml
> schema-aware editor.  In which case I would probably use 5.  Emacs, oxygen,
> XMLmind and probably editx will allow you to edit valid docbook 5.0.  I
> haven't really surveyed all the other tools, but if it really is awkward
> then I guess we stick with 4.x for now (mind you 4.5 is the last of the 4
> series, not 4.4).
>
> Bob
>
> 2009/11/18 Knut Staring <knutst@xxxxxxxxx>
>
>> Agree with being practical - which probably means old-fashioned in this
>> case, unless there are very compelling features in version 5. Just wanted to
>> note that I personally have found XML Mind more suitable and faster than
>> Serna Free, and it is good in that it readily displays the path to resources
>> like images.
>>
>> Knut
>>
>> 2009/11/18 Jason Pickering <jason.p.pickering@xxxxxxxxx>
>>
>>> I do not have a strong opinion about which version to use, mostly out
>>>
>>> of ignorance, but somewhat based on practicality. We are using a very
>>> small subset (at the moment) of the total number of DocBook tags, so I
>>> am not 100% about whether we need to be on the bleeding edge. My
>>> recommendation of using version 4.x is based on what is available with
>>> the WYSIWYG editor, Serna Free, which support version 4.2 out of the
>>> box. There could be compelling reasons to use a later version of the
>>> schema, but they are not apparent to me. Based on our immediate
>>> requirements to have a somewhat more streamlined set of documents, the
>>> editors that are practical for both geeks and those less inclined to
>>> use VI for editing DocBook, it would make sense to stick with
>>> something that is perhaps not bleeding edge, but practical. I think
>>> the changes Jo has made to the pom are great and significantly ease
>>> the building on the documentation on my side (working over an
>>> incredibly bad link).
>>>
>>> Unless there are other reasons, I think we should tread softly, and
>>> stick with what works for now.
>>>
>>>
>>> On Wed, Nov 18, 2009 at 5:02 PM, Lars Helge Øverland
>>> <larshelge@xxxxxxxxx> wrote:
>>> >
>>> >
>>> > On Wed, Nov 18, 2009 at 4:00 PM, Jo Størset <storset@xxxxxxxxx> wrote:
>>> >>
>>> >> Den 18. nov. 2009 kl. 15.08 skrev Lars Helge Øverland:
>>> >>
>>> >> 5.0 is available:
>>> >>
>>> >> http://mvnrepository.com/artifact/org.docbook/docbook-xml
>>> >>
>>> >> Notice the size of the binary.. 0 bytes
>>> >
>>> >
>>> > Doh..
>>> >
>>> > _______________________________________________
>>> > 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
>>> >
>>> >
>>>
>>> _______________________________________________
>>> 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
>>
>>
>