Re: DOCBOOK-APPS: page numbers in dsssl xrefs

[Kevin Dunn <kdunn@hsc.edu>]

---------- Original Message ----------------------------------
From: Adam DiCarlo <adam@onshored.com>
Date:  Thu, 13 Mar 2003 03:14:53 -0600

>Kevin Dunn <kdunn@hsc.edu> writes:
>
>> The problem is that the page numbers are occasionally wrong when a
>> floating figure or equation is bumped to the next page. The mandrake
>> documentation project solved this problem for the LOT by printing
>> the page number of, for example, the title of an equation rather
>> than of the equation itself.
>
>I don't get it.  Wouldn't it be a bug if the equation title is on a
>different page than the equation itself?  Or are these deliberately
>multi-page equations?
>

This is a LONGSTANDING bug in the dsl stylesheets, dating back to before they moved to sourceforge. When the tex backend bumps a formal object (figure, eqn, etc.) to the start of a new page, the object itself starts at the bottom of, say page 7, but the figure and its title actually appear at the top of page 8. The result is that hyperlinks to those objects work fine in both html and pdf. But the page number listed as page 7 in the TOC. The mandrake customization gets around this by linking LOT entries to the object titles rather than to the objects themselves.

I solved my page reference problem in the same way. I made a few minor changes to common/dbl1en.dsl and now I can get correct page references simply by xref to a title or anchor.


>Hmm, I believe we can adjust where the actual anchor for the link is
>placed.
>
>Is is possible to provide a sample generic DocBook (XML or SGML, XML
>preferred) document showing the problem?
>

I'll do that and send you my customizations. I'm sure that they are crude, but they solve my problems.

BTW, thanks for your work on dsssl 1.78. It is much appreciated.

--
Kevin M. Dunn
Professor of Chemistry
Hampden-Sydney College
--