OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook-apps] ???TITLE???


Yes, you should be able to add this:

<xsl:template match="d:bridgehead" mode="is.autonumber">
 <xsl:text>0</xsl:text>
</xsl:template>

<xsl:template name="label.this.section">
 <xsl:param name="section" select="."/>

 <xsl:variable name="level">
   <xsl:call-template name="section.level"/>
 </xsl:variable>

 <xsl:choose>
   <xsl:when test="$section/self::d:bridgehead">0</xsl:when>
   <xsl:when test="$level &lt;= $section.autolabel.max.depth">
     <xsl:value-of select="$section.autolabel"/>
   </xsl:when>
   <xsl:otherwise>0</xsl:otherwise>
 </xsl:choose>
</xsl:template>

I think that should do it.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

--------------------------------------------------
From: "Stefan Hinz" <stefan.hinz@oracle.com>
Sent: Wednesday, January 16, 2013 1:09 PM
To: "Bob Stayton" <bobs@sagehill.net>
Cc: <docbook-apps@lists.oasis-open.org>
Subject: Re: [docbook-apps] ???TITLE???

Hi Bob,

Again, thanks much for confirming my suspicion and for fixing the bug!

Is there a workaround for the 1.78.0 style sheets?

Cheers,

Stefan

On 16.01.2013 20:01, Bob Stayton wrote:
Hi Stefan,
Yes, this was a bug.  There was some confusion in the stylesheet about
whether bridgeheads are numbered.  Part of the confusion came from
DocBook: The Definitive Guide, which said a bridgehead is handled like a
section title.  However, I just consulted with the DocBook Technical
Committee in our monthly meeting, and we agreed that bridgeheads should
not normally be part of the section hierarchy and should not be numbered.

I fixed the stylesheet in SVN and it should appear in the next snapshot
and 1.78.1 release.  Thanks for the report.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

--------------------------------------------------
From: "Stefan Hinz" <stefan.hinz@oracle.com>
Sent: Wednesday, January 16, 2013 7:08 AM
To: <docbook-apps@lists.oasis-open.org>
Subject: Re: [docbook-apps] ???TITLE???

Hi Bob,

Update on my previous reply: I've tried building with the 1.78.0
stylesheets. Indeed, this gets rid of the ???TITLE??? ugliness, but it
still adds the section numbers to the link title, rather than using
just the text provided with <link>. Here's a sample from building with
1.77.1 and then 1.78.0:

~/svn/mysqldoc/refman-5.0> grep explain-output-columns manual.xhtml.1771
            <a class="link" href="#explain-output-columns"
title="8.2.2. ???TITLE??? Output Columns"><code
class="literal">EXPLAIN</code>
          </p></li></ul></div><h4><a id="explain-output-columns"></a>

~/svn/mysqldoc/refman-5.0> grep explain-output-columns manual.xhtml.1780
            <a class="link" href="#explain-output-columns"
title="8.2.2. EXPLAIN Output Columns"><code
class="literal">EXPLAIN</code>
          </p></li></ul></div><h4><a id="explain-output-columns"></a>

The corresponding DocBook source is:

<link linkend="explain-output-columns"><literal>EXPLAIN</literal>
Output Columns</link>

And the link target is:

<bridgehead id="explain-output-columns">
<literal>EXPLAIN</literal> Output Columns
</bridgehead>

Is this another bug, or is it expected behavior?

Cheers,

Stefan

On 15.01.2013 19:22, Bob Stayton wrote:
That's a bug that was fixed in version 1.78.0.  If you don't want to
upgrade, you can add this template to your customization layer:

<xsl:template match="bridgehead" mode="title.markup">
  <xsl:apply-templates/>
</xsl:template>

In 1.77.1 and earlier, that template used mode="title.markup" for the
children when it should not.

Bob Stayton
Sagehill Enterprises
bobs@sagehill.net

--------------------------------------------------
From: "Stefan Hinz" <stefan.hinz@oracle.com>
Sent: Tuesday, January 15, 2013 9:29 AM
To: "DocBook Apps" <docbook-apps@lists.oasis-open.org>
Subject: [docbook-apps] ???TITLE???

No, this is not a spam email. :-) While running some XHTML build tests
today, I noticed a couple of warnings like these:

Request for title of element with no title: literal
Request for title of element with no title: link

After debugging, to begin with the conclusion, we found these are
annoying but harmless. But I'd like to get rid of them, anyway, if
possible. :-)

The ???TITLE??? things in the output come from constructs that attempt
to link to a <bridgehead>. For example, in one of our files:

<para>
The join type. For descriptions of the different types, see
<link linkend="explain-join-types"><literal>EXPLAIN</literal>
Join Types</link>.
</para>

That links to:

<bridgehead id="explain-join-types">
<literal>EXPLAIN</literal> Join Types
</bridgehead>

The link becomes this in the output HTML:

<p>
The join type. For descriptions of the different types, see
<a class="link" href="#explain-join-types" title="8.2.2.  ???TITLE???
Join Types"><code class="literal">EXPLAIN</code>
Join Types</a>.
</p>

So the ???TITLE??? becomes part of the title that is displayed if you
hover the mouse over the link, but is not otherwise visible. (That's
why it's harmless.)

Each of the ???TITLE??? instances corresponds to the presence of a
<literal>something</literal> in the link content. No idea why the
stylesheets don't just use the text of the literal in the title
attribute value.

Does anyone have an idea what might be going wrong?

Cheers,

Stefan

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



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



--
Cheers,

Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager

Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc

ORACLE Deutschland B.V.&  Co. KG
Registered Office: Riesstr. 25, 80992 Muenchen, Germany
Commercial Register: Local Court Of Munich, HRA 95603
Managing Director: Jürgen Kunz

General Partner: ORACLE Deutschland Verwaltung B.V.
Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher

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





--
Cheers,

Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager

Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc

ORACLE Deutschland B.V.&  Co. KG
Registered Office: Riesstr. 25, 80992 Muenchen, Germany
Commercial Register: Local Court Of Munich, HRA 95603
Managing Director: Jürgen Kunz

General Partner: ORACLE Deutschland Verwaltung B.V.
Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher




[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]