Re: [docbook-apps] changing how xrefs to listings are rendered in PDF

[Tomek Kaczanowski <kaczanowski.tomek@gmail.com>]

Bob,

 thanks to your advice, I managed to do exactly what I wanted. :)

I posted a detailed information on AsciiDoc mailing list, because my
problem (and solution) involves also some AsciiDoc-specific stuff. You
can read it here:
http://groups.google.com/group/asciidoc/browse_thread/thread/3d42b817465213ec

Thank you once again.

-- 
Regards / Pozdrawiam
Tomek Kaczanowski
http://kaczanowscy.pl/tomek
2011/9/28 Bob Stayton <bobs@sagehill.net>:
> I suggest you search the locale file (en.xml?) for all instances of
> "example" (both <l:gentext> and <l:template> within contexts, copy them to
> your customized l10n, and change each text attribute's 'Example' to
> 'Listing'.  It appears from your output that you have set the stylesheet
> param 'xref.with.number.and.title' from the default 1 to zero?  If so, then
> the context to use is 'xref-number' instead.
>
> Also, change the
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
>
>
> ----- Original Message ----- From: "Tomek Kaczanowski"
> <kaczanowski.tomek@gmail.com>
> To: <docbook-apps@lists.oasis-open.org>
> Sent: Tuesday, September 27, 2011 2:32 PM
> Subject: Re: [docbook-apps] changing how xrefs to listings are rendered in
> PDF
>
>
> Bob,
>
> thanks for answering.
>
> I have introduced some changes to the asciidoc file I'm working with,
> and now, docbook version which is generated, has all listings are
> included in <example> tag, as you suggested, e.g.:
>
> <example id="listing_some_id">
> <title>Some Title</title>
> <programlisting language="java" linenumbering="unnumbered">
> some code here
> </programlisting>
> </example>
>
> In PDF this is rendered as "Example 5.1" and references (xref
> linkend="listing_some_id"/>) are also rendered like "Example 5.1".
> This is almost perfect, but I would like to have "Listing 5.1"
> instead.
>
> Could you please explain how to do this?
>
> I tried to do the following:
> <l:context name="xref-number-and-title">
>       <l:template name="example" text="Listing %n"/>
> </l:context>
> but it did not help.
>
> --
> Regards / Pozdrawiam
> Tomek Kaczanowski
> http://kaczanowscy.pl/tomek
>
>
> 2011/9/27 Bob Stayton <bobs@sagehill.net>:
>>
>> Hi Tomek,
>> Are you using the <example> element in your documents? If not, you could
>> use it instead of formalpara to contain your programlistings. The example
>> element already has the machinery for titling, numbering and cross
>> referencing to those numbers. You could even generate a list of Listings
>> like a List of Figures at the front. You would need to change the gentext
>> file for all instances of example to display "Listing %n" rather than
>> "Example %n", but otherwise that's it.
>>
>> Adding numbering to formalpara in the display and the cross referencing
>> can
>> be done, but requires a lot more customization. Also, you would not be
>> able
>> to use formalpara for other purposes.
>>
>> Bob Stayton
>> Sagehill Enterprises
>> bobs@sagehill.net
>>
>>
>> ----- Original Message ----- From: "Tomek Kaczanowski"
>> <kaczanowski.tomek@gmail.com>
>> To: <docbook-apps@lists.oasis-open.org>
>> Sent: Monday, September 26, 2011 12:51 PM
>> Subject: [docbook-apps] changing how xrefs to listings are rendered in PDF
>>
>>
>>> Hi All,
>>>
>>> I'm writing a book using Docbook and have an issue with how references
>>> to listings are rendered in PDF version.
>>>
>>> For example, my docbook file contains the following fragment:
>>>
>>> <simpara>Blah blah blah as presented on listing <xref
>>> linkend="listing_shortest_test"/>.</simpara>
>>>
>>> <formalpara id="listing_shortest_test">
>>> <title>One-Liner Test</title>
>>> <para>
>>> <programlisting language="java" linenumbering="unnumbered">
>>> // some cool code here
>>> </programlisting>
>>> </para>
>>> </formalpara>
>>>
>>> In PDF version (generated with fop) xhref link to the listing is rendered
>>> as:
>>>
>>> "Blah blah blah as presented on listing One-Liner Test."
>>>
>>> I would like to look it differently, i.e. like this:
>>>
>>> "Blah blah blah as presented on listing 3.1"
>>>
>>> I have achieved similar thing with tables and figures (as discussed
>>> here http://is.gd/wAInBB) by tweaking the docbook-xsl/fo.xsl like
>>> this:
>>> <xsl:param name="local.l10n.xml" select="document('')"/>
>>> <l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0";>
>>> <l:l10n language="en">
>>> <l:context name="xref-number-and-title">
>>> <l:template name="table" text="Table %n"/>
>>> </l:context>
>>> </l:l10n>
>>> </l:i18n>
>>>
>>> I have tried to do the same with listings, using various options
>>> (well, I was just shooting in the dark, I know...):
>>>
>>> <l:context name="xref-number-and-title">
>>> <l:template name="listing" text="Listing %n"/>
>>> <l:template name="example" text="Listing %n"/>
>>> <l:template name="formalpara" text="Listing %n"/>
>>> </l:context>
>>>
>>> but without any success. I have also tried to change value of
>>> xref.with.number.and.title but
>>> this seems to be broken (nothing happens).
>>>
>>> I read http://www.sagehill.net/docbookxsl/CustomGentext.html and a lot
>>> of other docbook xsl information, but I still do not know how to do
>>> this.
>>>
>>> Could you please help?
>>>
>>> P.S. To give you the full picture, I'm using AsciiDoc, but I do not
>>> think it matters. At some point I got a valid docbook document which
>>> is converted to PDF and this is the part I'm struggling with.
>>>
>>> --
>>> Regards,
>>> Tomek Kaczanowski
>>> http://kaczanowscy.pl/tomek
>>>
>>> ---------------------------------------------------------------------
>>> 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
>
>
>
>