docbook-apps

  • 1.  Webhelp files chunking to wrong directory

    Posted 03-04-2012 03:43
    I just started using WebHelp this weekend and followed the instructions
    to install Ant. I couldn't test that Ant was installed properly because
    when I ran "ant -version" at the command prompt I got an error message
    that "ant" is not a recognised command, etc....
    However, I decided to run webhelp from within oXygen v 13.2 anyway
    (apparently not using ant), and it is creating chunks, but it is
    creating the docs directory in the oXygen 13.2 program directory. I have
    modified the webhelp build.properties file to specify an output directory:
    output-dir=file:///c:/xmplar/cop-e-boox v 0-1a/docs
    ..but this makes no difference.

    Do I need to specify an output directory somewhere else? Have I missed
    an installation step?
    I'm using the ns version 1.76.1 in Windows XP.
    --
    **Dave Gardiner



  • 2.  Re: [docbook-apps] Webhelp files chunking to wrong directory

    Posted 03-04-2012 04:09
    -----BEGIN PGP SIGNED MESSAGE-----
    Hash: SHA1

    So generating webhelp from oXygen should just work. However, I would
    suggest using the latest snapshot build for webhelp. It has lots of
    improvements and bug fixes:

    http://snapshots.docbook.org/

    This version isn't yet integrated with oXygen. I'm not sure how much
    it would take to do that integration if you need it, but if we can do
    a DocBook release in time, I expect the could get it in the next
    version of oXygen.

    David

    On 03/03/2012 09:42 PM, Xmplar wrote:
    > I just started using WebHelp this weekend and followed the
    > instructions to install Ant. I couldn't test that Ant was installed
    > properly because when I ran "ant -version" at the command prompt I
    > got an error message that "ant" is not a recognised command,
    > etc.... However, I decided to run webhelp from within oXygen v 13.2
    > anyway (apparently not using ant), and it is creating chunks, but
    > it is creating the docs directory in the oXygen 13.2 program
    > directory. I have modified the webhelp build.properties file to
    > specify an output directory:
    > output-dir=file:///c:/xmplar/cop-e-boox v 0-1a/docs ..but this
    > makes no difference.
    >
    > Do I need to specify an output directory somewhere else? Have I
    > missed an installation step? I'm using the ns version 1.76.1 in
    > Windows XP. -- **Dave Gardiner

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

    iQEcBAEBAgAGBQJPUurNAAoJEMHeSXG7afUhRnkIAIpmqVuLTWCz8fUqCWZParnE
    EK9uJht0IbZ327ZEexjKwdNjylNjG9fa5DPUdhNwAS3lrU014WfUoppytAkA2Y2f
    MPCZXdSuSiPEe0F0jFaWaEfRADJ2MMHEPyfPwBiOHuZzEg8RWNHA00Cbyht7GThH
    kVwZ8DwV/unhdTRZFjAGGjHVZiqOgB82o/1Z9lB11J8sXTG+mVI7UXG2xNe9R8cX
    dz0eNWs+OcNXKYf7K8wHW5OeEq5UsobAixoBpk7eSTlIV66ZcFAVvng29obnCdbq
    S0LGcJxYxsZFYVLrSh68ehEeC0/4670E3tuZ3o7YG8bQS0S/lFwYfupArcXAjJg=
    =mTFv
    -----END PGP SIGNATURE-----



  • 3.  Re: [docbook-apps] Webhelp files chunking to wrong directory

    Posted 03-04-2012 04:58
    On Sun, Mar 4, 2012 at 9:12 AM, Xmplar <info@xmplar.biz> wrote:

    > I just started using WebHelp this weekend and followed the instructions
    > to install Ant. I couldn't test that Ant was installed properly because
    > when I ran "ant -version" at the command prompt I got an error message that
    > "ant" is not a recognised command, etc....
    >

    This probably means that you haven't added the path to ANT's bin directory
    to PATH environment variable. Can you make sure that it's the case? You may
    read the Ant manual for a more detailed instructions.
    http://ant.apache.org/manual/install.html

    However, I decided to run webhelp from within oXygen v 13.2 anyway
    > (apparently not using ant),
    >

    As far as I'm aware of, Oxygen has ANT integrated into its pack. So, when
    you invoke webhelp via Oxygen, it invokes ANT internally.


    > and it is creating chunks, but it is creating the docs directory in the
    > oXygen 13.2 program directory. I have modified the webhelp build.properties
    > file to specify an output directory:
    > output-dir=file:///c:/xmplar/cop-e-boox v 0-1a/docs
    > ..but this makes no difference.
    >
    >
    And, I did a quick test on Oxygen 13.1. For me, the output folder out/ was
    created in the same directory as the docbook document was. So, I think if
    the document you are trying to convert is inside Oxygen, then the output
    will also be created there.

    This can be changed using "webhelp.base.dir" parameters that is present in
    Oxygen UI. How I changed was - I first duplicated the webhelp
    transformation scenario, then right-click in the new transformation name
    -> edit. There's a tab called "Parameters". Oxygen has changed the webhelp
    build.xml a little bit.
    It should be noted that, Oxygen has DocBook WebHelp 1.76.1 built-in. So,
    unless you configured it manually, Oxygen invokes the built-in webhelp. It
    can be found at <path to oxygen>/frameworks/docbook/xsl/webhelp.

    Regards,
    --Kasun

    Do I need to specify an output directory somewhere else? Have I missed an
    > installation step?
    > I'm using the ns version 1.76.1 in Windows XP.
    > --
    > **Dave Gardiner
    >



    --
    ~~~*******'''''''''''''*******~~~
    *Kasun Gajasinghe*
    Software Engineer; WSO2 Inc.; http://wso2.com,
    *linked-in: *http://lk.linkedin.com/in/gajasinghe*
    *
    *blog: **http://blog.kasunbg.org* <http://blog.kasunbg.org/>

    *
    twitter: **http://twitter.com/kasunbg* <http://twitter.com/kasunbg>



Related Content