docbook-apps

  • 1.  xlink:title not getting into HTML, 1.77.1

    Posted 12-14-2012 08:13
    Hello all

    When transforming from DocBook to HTML using oXygen 8.2, I did have
    xlink:title="whatever" being made into title tags in HTML, but now it's
    gone again.

    I suspect this probably started when I got 1.77.1 a few weeks ago
    (previously was using 1.74.0), though can't be 100% sure as I've only
    just noticed it.

    Is there a change I've missed in how xlink:title needs to be stated, or
    anything else obvious-ish like that? Or where can I look to work out
    what's going on?

    Thanks in advance

    Jennifer

    --
    www.uncharted-worlds.org/blog/
    newest recording www.single-bass.co.uk/songs/heavy-woman



  • 2.  Re: [docbook-apps] xlink:title not getting into HTML, 1.77.1

    Posted 12-14-2012 18:32
    Hi Jennifer,
    Can you supply more details:

    1. Are you using DocBook 4 or DocBook 5 XML?

    2. Can you provide an example of your linking element with xlink:title in
    it?

    I presume since you are using Oxygen that your file validates and the xlink
    namespace is properly declared.

    Bob Stayton
    Sagehill Enterprises
    bobs@sagehill.net

    --------------------------------------------------
    From: "Jennifer Moore" <jennifer@uncharted-worlds.org>
    Sent: Friday, December 14, 2012 12:13 AM
    To: <docbook-apps@lists.oasis-open.org>
    Subject: [docbook-apps] xlink:title not getting into HTML, 1.77.1

    > Hello all
    >
    > When transforming from DocBook to HTML using oXygen 8.2, I did have
    > xlink:title="whatever" being made into title tags in HTML, but now it's
    > gone again.
    >
    > I suspect this probably started when I got 1.77.1 a few weeks ago
    > (previously was using 1.74.0), though can't be 100% sure as I've only just
    > noticed it.
    >
    > Is there a change I've missed in how xlink:title needs to be stated, or
    > anything else obvious-ish like that? Or where can I look to work out
    > what's going on?
    >
    > Thanks in advance
    >
    > Jennifer
    >
    > --
    > www.uncharted-worlds.org/blog/
    > newest recording www.single-bass.co.uk/songs/heavy-woman
    >
    > ---------------------------------------------------------------------
    > To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
    > For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
    >
    >
    >



  • 3.  Re: [docbook-apps] xlink:title not getting into HTML, 1.77.1

    Posted 12-14-2012 19:52
    Hi Bob

    thanks for your reply!

    > Can you supply more details:
    >
    > 1. Are you using DocBook 4 or DocBook 5 XML?

    5.

    > 2. Can you provide an example of your linking element with xlink:title
    > in it?

    OK, experiment coming up. I've gone back and found an XML and HTML pair
    from an old article, that I hadn't touched for a couple of years.

    XML original:
    ====
    xlink:href="http://www.guardian.co.uk/commentisfree/2010/apr/25/david-cameron-david-mitchell"
    xlink:title="Article, 25 April 2010">this article
    ====

    When I last did the HTML transform on that one, back in 2010, it wrote:
    ====
    href="http://www.guardian.co.uk/commentisfree/2010/apr/25/david-cameron-david-mitchell"
    title="Article, 25 April 2010">this article

    ====

    Doing it again just now, without changing the XML at all, produces:
    ====
    href="http://www.guardian.co.uk/commentisfree/2010/apr/25/david-cameron-david-mitchell"
    target="_top">this article

    ====

    > I presume since you are using Oxygen that your file validates and the
    > xlink namespace is properly declared.

    Well my understanding of namespace protocol is only middling, so
    wouldn't like to guarantee "yes", but here's what I've got...

    XML declaration is like this:

    xmlns:xlink="http://www.w3.org/1999/xlink">

    Top-level XSL file has:

    <xsl:stylesheet
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

    - should there be something else there? oXygen does point me at that
    file, as the destination associated with the following "info" message
    from the transform reporting bit:

    == quote from oXygen ==
    SystemID: [redacted]/XSL/WordPressCustom/docbookWP.xsl
    Description: Note: namesp. cut : stripped namespace before processing
    Election day
    == end quote ==
    ("Election day" is the name of the article)

    which looks a bit suspicious maybe? I think it's always thrown up that
    same message, but as it always used to do (or seem to be doing)
    everything fine in practice, I've always ignored it till now. Could it
    be one of those things where it's technically always been an error but
    the software used to be more forgiving of it?

    anyway that's what I've got so far...

    thanks again

    Jennifer

    --
    www.uncharted-worlds.org/blog/
    newest recording www.single-bass.co.uk/songs/heavy-woman



  • 4.  Re: [docbook-apps] xlink:title not getting into HTML, 1.77.1

    Posted 12-14-2012 22:14
    Hi Jennifer,
    > namesp. cut : stripped namespace before processing

    This indicates that the stylesheet being applied to your DocBook 5 document
    is the non-namespaced version. That stylesheet cannot match on namespaced
    elements, so it first converts the DocBook 5 document to DocBook 4 before
    processing. In doing so, it converts external links to <ulink> and that
    element does not support xlink:title attributes.

    I suggest you instead process your document with the namespaced version of
    the stylesheets with are meant for DocBook 5, (with "-ns-" in the directory
    name). If you are using an old version of Oxygen, it may not have them, but
    you can download them from SourceForge:

    https://sourceforge.net/projects/docbook/files/docbook-xsl-ns/1.77.1/

    With that stylesheet, it will not convert your link to ulink, and it will
    output the title attribute from the xlink:title input.

    Bob Stayton
    Sagehill Enterprises
    bobs@sagehill.net

    --------------------------------------------------
    From: "Jennifer Moore" <jennifer@uncharted-worlds.org>
    Sent: Friday, December 14, 2012 11:52 AM
    To: "Bob Stayton" <bobs@sagehill.net>; "DocBook Apps"
    <docbook-apps@lists.oasis-open.org>
    Subject: Re: [docbook-apps] xlink:title not getting into HTML, 1.77.1

    > Hi Bob
    >
    > thanks for your reply!
    >
    >> Can you supply more details:
    >>
    >> 1. Are you using DocBook 4 or DocBook 5 XML?
    >
    > 5.
    >
    >> 2. Can you provide an example of your linking element with xlink:title
    >> in it?
    >
    > OK, experiment coming up. I've gone back and found an XML and HTML pair
    > from an old article, that I hadn't touched for a couple of years.
    >
    > XML original:
    > ====
    > > xlink:href="http://www.guardian.co.uk/commentisfree/2010/apr/25/david-cameron-david-mitchell"
    > xlink:title="Article, 25 April 2010">this article
    > ====
    >
    > When I last did the HTML transform on that one, back in 2010, it wrote:
    > ====
    > > href="http://www.guardian.co.uk/commentisfree/2010/apr/25/david-cameron-david-mitchell"
    > title="Article, 25 April 2010">this article

    > ====
    >
    > Doing it again just now, without changing the XML at all, produces:
    > ====
    > > href="http://www.guardian.co.uk/commentisfree/2010/apr/25/david-cameron-david-mitchell"
    > target="_top">this article

    > ====
    >
    >> I presume since you are using Oxygen that your file validates and the
    >> xlink namespace is properly declared.
    >
    > Well my understanding of namespace protocol is only middling, so wouldn't
    > like to guarantee "yes", but here's what I've got...
    >
    > XML declaration is like this:
    >
    >
    > xmlns:xlink="http://www.w3.org/1999/xlink">
    >
    > Top-level XSL file has:
    >
    > <xsl:stylesheet
    > xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
    >
    > - should there be something else there? oXygen does point me at that
    > file, as the destination associated with the following "info" message from
    > the transform reporting bit:
    >
    > == quote from oXygen ==
    > SystemID: [redacted]/XSL/WordPressCustom/docbookWP.xsl
    > Description: Note: namesp. cut : stripped namespace before processing
    > Election day
    > == end quote ==
    > ("Election day" is the name of the article)
    >
    > which looks a bit suspicious maybe? I think it's always thrown up that
    > same message, but as it always used to do (or seem to be doing) everything
    > fine in practice, I've always ignored it till now. Could it be one of
    > those things where it's technically always been an error but the software
    > used to be more forgiving of it?
    >
    > anyway that's what I've got so far...
    >
    > thanks again
    >
    > Jennifer
    >
    > --
    > www.uncharted-worlds.org/blog/
    > newest recording www.single-bass.co.uk/songs/heavy-woman
    >
    >