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] 1.77.0 bug with index building?


Hi Bob,

Thanks for the hint.

This wasn't the problem (we were already looking for id or name), but it was a markup difference. We're also looking for the element with class="title" and apparently this is now <h1> rather than <h2>.  Looking for both of them solved the problem.


On Jun 1, 2012, at 11:17 AM, Bob Stayton wrote:

> One thing you might look at that changed between 1.76.1 and 1.77.0 is the effect of the 'generate.id.attributes' parameter.  From the Release Notes:
> 
> Generate id attributes
> 
> The stylesheet param generate.id.attributes already existed but was incompletely implemented. Now when it is set to 1, only id attributes should be output, not <a name> named anchors.
> 
> If you have set generate.id.attributes=1, then the indexterm markers placed in the text changed from:
> 
> <a name="it4" class="indexterm"/> in 1.76.1
> 
> to
> 
> <a id="it4" class="indexterm"/> in 1.77.0
> 
> If your script is looking for a 'name' attribute, it will no longer succeed.  If you did not set that param to 1, then this suggestion would not apply because you should still get name attributes.
> 
> Bob Stayton
> Sagehill Enterprises
> bobs@sagehill.net
> 
> 
> ----- Original Message ----- From: "Stefan Hinz" <stefan.hinz@oracle.com>
> To: <docbook-apps@lists.oasis-open.org>
> Sent: Friday, June 01, 2012 6:46 AM
> Subject: Re: [docbook-apps] 1.77.0 bug with index building?
> 
> 
>> Hallo Thomas,
>> 
>> Good catch, thanks a lot!
>> 
>> In fact, the "cannot find top" string comes from one of our Perl (!) scripts that analyzes index terms to create an index navigation bar for long indexes, like the one you can see on http://dev.mysql.com/doc/refman/5.5/en/ix01.html.
>> 
>> Not sure why the script works flawlessly with the 1.76.1 style sheets but dies with the 1.77.0 ones, but this should be fairly easy to find out. If our findings yield anything of general interest, I'll post it to this list. Of course, I'll also do so in case this still turns out to be a 1.77.0 bug.
>> 
>> Again, thanks much for your reply, and schönes Wochenende!
>> 
>> Cheers,
>> 
>> Stefan
>> 
>> On 01.06.2012 13:25, Thomas Schraitle wrote:
>>> Hi Stefan,
>>> 
>>> On Fri, 01 Jun 2012 11:28:12 +0200
>>> Stefan Hinz<stefan.hinz@oracle.com>  wrote:
>>> 
>>>> We're building customized XHTML output for OTN (Oracle Technology
>>>> Network), for many books. Using the 1.76.1 style sheets, all works
>>>> fine, but switching to the 1.77.0 style sheets gives an error like
>>>> this:
>>>> 
>>>> XML_CATALOG_FILES="../../../mysqldoc-toolset//catalog.xml
>>>> ../../../mysqldoc-toolset/xsl.d/docbook-xsl-1.77.0/catalog.xml"
>>>> xsltproc --xinclude --novalid  \
>>>>          --stringparam l10n.gentext.default.language en \
>>>>          --stringparam html.stylesheet "mysql-html.css" \
>>>>          --stringparam generate.toc "book toc,title" \
>>>>          --param chunk.section.depth 1 \
>>>>          --output user.xhtml-otn-tmp/ \
>>>>          ../../../mysqldoc-toolset/xsl.d/mysql-xhtml-otn.xsl \
>>>>          user-prepped.xml
>>>> ../../../mysqldoc-toolset/tools/add-index-navlinks.pl
>>>> user.xhtml-otn-tmp/*.html
>>>> Cannot find top of index 0, file user.xhtml-otn-tmp/ix01.html
>>>> make: *** [user.xhtml-otn] Fehler 25 (German for "error 25")
>>> 
>>> I've searched for the string "Cannot find top" in the stylesheets and
>>> couldn't find it. I even grepped the complete SVN repository with the
>>> same result. So I guess it might be somewhere in your Makefiles or Perl
>>> scripts.
>>> 
>>> To debug it further, grep/search for this string in your build
>>> mechanics. Maybe you can locate it there. Another option could be to
>>> try remake[1] instead of make. It's an "improved error reporting,
>>> tracing, and a debugger for make". Frank, my colleague, uses it to
>>> debug his Makefiles. The output is a bit... challenging to read, but it
>>> could give you some important hints.
>>> 
>>> Hope this helps. :)
>>> 
>>> 
>>> -----
>>> [1] http://bashdb.sourceforge.net/remake/
>>> 
>> 
>> 
>> -- 
>> 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
>> 
>> 
> 
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
> 



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