docbook-apps

  • 1.  Framemaker to DocBook conversion

    Posted 10-25-2006 10:51
      |   view attached
    -----BEGIN PGP SIGNED MESSAGE-----
    Hash: SHA1

    Hi all,

    I've been crawling archives and websites, found 2 threads dating back
    from 1999 and 2005, but nothing definitive. FM hacking looks not quite
    appealing.

    We have to migrate FM docs to DocBook, and using intermediate formats
    like HTML or RTF give quite poor results.

    Looking at the XML output from FM, it looks quite decent, the
    hierarchical structure could even be reconstructed with a bit of XSL
    neurons burning I believe.

    So did someone found a reliable FM -> DocBook conversion method?

    Thanks for your help,

    Camille.
    -----BEGIN PGP SIGNATURE-----
    Version: GnuPG v1.4.5 (GNU/Linux)
    Comment: Using GnuPG with Mandriva - http://enigmail.mozdev.org

    iD8DBQFFP0Gnjv9P65BfOUMRAmH5AJ9E8b6/MLTBE96yj5/xblHd/TagVwCfaYAc
    zcXYh8ptezlHVBb8F5JfrZA=
    =kk0M
    -----END PGP SIGNATURE-----

    Attachment(s)

    vcf
    camille.vcf   472 B 1 version


  • 2.  Re: [docbook-apps] Framemaker to DocBook conversion

    Posted 10-25-2006 14:30
    On 10/25/06, Camille Bégnis <camille@neodoc.biz> wrote:
    > I've been crawling archives and websites, found 2 threads dating back
    > from 1999 and 2005, but nothing definitive. FM hacking looks not quite
    > appealing.

    Many of the earlier attempts using XSLT1 (which were probably what you
    found with Google) failed because of the pain of grouping in XSLT1.

    > Looking at the XML output from FM, it looks quite decent, the
    > hierarchical structure could even be reconstructed with a bit of XSL
    > neurons burning I believe.

    What version of FrameMaker do you have? Recent versions have more XML
    support, but I haven't played with any since 5.5.

    > So did someone found a reliable FM -> DocBook conversion method?

    For some subset of documents in a very strictly applied template, yes,
    I have. Will there every be a reasonable
    All-Frame-Documents->Reasonable-DocBook? Never.

    How rigorously do your input documents follow a template? How much
    format tweaking not using styles? Do you have a good understanding of
    how all of the Paragraph Styles will map to DocBook elements or are
    many of them purely visual?

    Here's my suggestion on how to approach it:
    * Get your Frame into full-fidelity XML (prolly very flat)
    ** We eventually wrote a MIF->XML parser (not that hard for someone
    with experience), but there may be better options for recent versions
    of Frame or consider the Perl modules that build a MIF tree (which is
    easy to serialize as XML)
    * Do simple A->B mapping of Frame's \\xNN chars and <Char>s
    ** Consider generating this stylesheet, as you'll have to add a ton
    * Write a lot of XSLT2 stylesheets, each of which attacks something
    needing greater depth (sidebars, examples, lists [especially lists,
    this is what will make or break you]) with XSLT2 grouping
    * Figure out how to handle index terms (this is hard, I still don't
    know if we've solved it the right way)
    * Do simple A->B mapping of elements into DocBook at the end
    ** Considering generating this document, as above

    For someone experienced with the input documents, XSLT2, and document
    transformation, I bet you could have something working in 80 hours.

    For reference, I have 41 helper stylesheets, one stylesheet chainer
    (to run the 41), two XSLT2 libraries, and one generated stylesheet
    (style mapping), with a total of 4000 lines in the project.


    HTH,
    Keith



  • 3.  Re: [docbook-apps] Framemaker to DocBook conversion

    Posted 10-25-2006 17:23
    Camille Bégnis wrote:
    > -----BEGIN PGP SIGNED MESSAGE-----
    > Hash: SHA1
    >
    > Hi all,
    >
    > I've been crawling archives and websites, found 2 threads dating back
    > from 1999 and 2005, but nothing definitive. FM hacking looks not quite
    > appealing.
    >
    > We have to migrate FM docs to DocBook, and using intermediate formats
    > like HTML or RTF give quite poor results.
    >
    > Looking at the XML output from FM, it looks quite decent, the
    > hierarchical structure could even be reconstructed with a bit of XSL
    > neurons burning I believe.
    >
    > So did someone found a reliable FM -> DocBook conversion method?
    A guy called Chris (anyone help me with a surname? I feel guilty 'cos I
    met him)
    used to hang around on this list. IIRC he did a lot of Frame
    transforms, and I'm sure docbook was one target.

    Keep looking, I feel sure you'll find something Camille.

    HTH DaveP





    regards

    --
    Dave Pawson
    XSLT XSL-FO FAQ.
    http://www.dpawson.co.uk