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
[email protected]
--------------------------------------------------
From: "Stefan Hinz" <[email protected]>
Sent: Tuesday, January 15, 2013 9:29 AM
To: "DocBook Apps" <[email protected]>
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: [email protected]
For additional commands, e-mail: [email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
--
Cheers,
Stefan Hinz <[email protected]>, 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: [email protected]
For additional commands, e-mail: [email protected]
