docbook-apps

  • 1.  DocBook to Microsoft Help File - all linked files being included

    Posted 05-02-2008 09:46

    I've just been working on a document and I find some behaviour I'd like
    to stop.

    I'm writing some instructions for a process.
    Part of the instructions concerns software to install and I've included
    <ulink> elements pointing to a selection of zip files.
    This is all fine when generating a single html file or a pdf. The
    resulting files are reasonable in size and the links are genuine links
    on the web, or links to one of our local servers.
    However, when I generate a Microsoft compiled html help file, all the
    zip files are included in the resultant chm file. Which as a result is
    very much larger than the other two formats (16Mb against a few hundred
    Kb). I would like to stop this happening.
    Of course the whole point of a chm file is that it is a mini web-site
    all in one file, but for some items, which start off as DocBook <ulink>
    elements I'd like this not to happen.
    Can I put anything in the DocBook source to stop this happening ?
    Or is there something I can do when calling hhc ?

    Appreciatively,
    Richard.



    Richard Kerry
    Colledia Control Engineer
    Siemens IT Solutions and Services Ltd
    Room 457 Design Building, BBC Television Centre, Wood Lane, London, W12
    7RJ
    T: +44 (0)20 82259063 F: +44 (0)20 8576 8182 M: +44 (0)7921 244993
    Email: richard.kerry@siemens.com
    <blocked::mailto:richard.kerry@siemens.com>
    Website: www.siemens.co.uk/it-solutions
    <blocked::outbind://47/www.siemens.co.uk/it-solutions>

    This e-mail contains confidential information and is for the exclusive
    use of the addressee/s. If you are not the addressee, then any
    distribution, copying or use of this e-mail is prohibited. If received
    in error, please advise the sender and delete it immediately. We accept
    no liability for any loss or damage suffered by any person arising from
    use of this e-mail.

    Siemens IT Solutions and Services Limited
    Registered No: 1203466 England
    Registered Office: Faraday House, Sir William Siemens Square, Frimley,
    Camberley, GU16 8QD





  • 2.  Re: [docbook-apps] DocBook to Microsoft Help File - all linked files being included

    Posted 05-02-2008 23:27
    2008/5/2 Kerry, Richard <richard.kerry@siemens.com>:
    >
    >
    >
    > I've just been working on a document and I find some behaviour I'd like to
    > stop.
    >
    > I'm writing some instructions for a process.
    > Part of the instructions concerns software to install and I've included
    > <ulink> elements pointing to a selection of zip files.
    > This is all fine when generating a single html file or a pdf. The resulting
    > files are reasonable in size and the links are genuine links on the web, or
    > links to one of our local servers.
    > However, when I generate a Microsoft compiled html help file, all the zip
    > files are included in the resultant chm file. Which as a result is very
    > much larger than the other two formats (16Mb against a few hundred Kb). I
    > would like to stop this happening.
    > Of course the whole point of a chm file is that it is a mini web-site all in
    > one file, but for some items, which start off as DocBook <ulink> elements
    > I'd like this not to happen.
    > Can I put anything in the DocBook source to stop this happening ?
    > Or is there something I can do when calling hhc ?
    >
    > Appreciatively,
    > Richard.

    As the MS HTML Compiler will include anything it finds, move the .zip
    files away from their current location so they cannot be found.


    --
    -----
    Richard Quadling
    Zend Certified Engineer : http://zend.com/zce.php?c=ZEND002498&r=213474731
    "Standing on the shoulders of some very clever giants!"



Related Content