docbook-apps

  • 1.  DocBook 4.5 -> DocBook 5

    Posted 11-19-2008 21:37
    Hello,

    I have been using DocBook 4.5 to produce documentation. I recently ran into
    a problem where some of my documents are in DocBook 5. Is it pretty easy to
    convert everything to DocBook 5?

    Lillian



  • 2.  Re: [docbook-apps] DocBook 4.5 -> DocBook 5

    Posted 11-19-2008 21:57
    Hi Lillian,

    On Mittwoch, 19. November 2008, Lillian Sullam wrote:
    >
    > I have been using DocBook 4.5 to produce documentation. I recently ran
    > into a problem where some of my documents are in DocBook 5. Is it
    > pretty easy to convert everything to DocBook 5?

    In general yes. You can use the following stylesheet to convert your
    DocBook4 documents into DocBook5:

    https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/tools/db4-upgrade.xsl

    Maybe you have to check it to avoid some rare transformation problems.
    Therefore always validate your result documents before you apply further
    processing steps. :-)


    Tom

    --
    Thomas Schraitle



  • 3.  RE: [docbook-apps] DocBook 4.5 -> DocBook 5

    Posted 11-19-2008 23:38
    Hey Lillian:

    The conversion part is pretty easy. I agree with Tom that the stylesheet he referred to can make the transformation a snap. However, if you use xincludes or entities, your transformed DB 5 document structure won't mirror your DB 4 structure. Most stylesheets that I've seen create one large transformed file.

    Once you know what elements you need to replace, I'd recommend transform your doc manually if you want to retain the structure.

    Two things that make me hesitant to call DB 5 ready for prime time: there's still limited or no support for roundtrip and, more importantly for me, if you chunk using a generated TOC then it flat-out doesn't work. At least with Relax NG. The problem seems to be--at least according to my feeble brain--that you can't generate valid TOC elements because the stylesheets still don't support them. Yet, when you generate the older DB 4 TOC elements, you can't validate the doc.

    I love the idea of DB 5. I just haven't been smart enough to figure out how to use it for my own purposes.

    -Scot

    -----Original Message-----
    From: tom_schr@web.de [mailto:tom_schr@web.de]
    Sent: Wednesday, November 19, 2008 1:57 PM
    To: docbook-apps@lists.oasis-open.org
    Subject: Re: [docbook-apps] DocBook 4.5 -> DocBook 5

    Hi Lillian,

    On Mittwoch, 19. November 2008, Lillian Sullam wrote:
    >
    > I have been using DocBook 4.5 to produce documentation. I recently ran
    > into a problem where some of my documents are in DocBook 5. Is it
    > pretty easy to convert everything to DocBook 5?

    In general yes. You can use the following stylesheet to convert your
    DocBook4 documents into DocBook5:

    https://docbook.svn.sourceforge.net/svnroot/docbook/trunk/docbook/relaxng/tools/db4-upgrade.xsl

    Maybe you have to check it to avoid some rare transformation problems.
    Therefore always validate your result documents before you apply further
    processing steps. :-)


    Tom

    --
    Thomas Schraitle

    ---------------------------------------------------------------------
    To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org




Related Content