[racket] Scribble secref unlinked in PDF output

From: Tim Jervis (tim at timjervis.com)
Date: Thu Dec 5 08:45:48 EST 2013

Hi Matthew,

Perhaps it is related to how figures are moved about during rendering.

I'm attaching an example source file, test.scrbl, and the PDF output after running "scribble --pdf test.scrbl". 

-------------- next part --------------
A non-text attachment was scrubbed...
Name: test.scrbl
Type: application/octet-stream
Size: 11201 bytes
Desc: not available
URL: <http://lists.racket-lang.org/users/archive/attachments/20131205/62646944/attachment-0001.obj>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: test.pdf
Type: application/pdf
Size: 26427 bytes
Desc: not available
URL: <http://lists.racket-lang.org/users/archive/attachments/20131205/62646944/attachment-0001.pdf>
-------------- next part --------------



When I open the PDF on my system with Preview, the links to figures 1 and 2 take me to the wrong pages.

When I remove the padding text in the source and re-run scribble, the links go to the right place in the resulting PDF.

Kind regards,



Tim

On 5 Dec 2013, at 13:25, Matthew Flatt <mflatt at cs.utah.edu> wrote:

> I wonder whether it's a limitation of \hyperref and figures. When the
> link goes to the wrong place, does it go to the place where the figure
> would be in the source of the document, as opposed to where it's moved
> to in the output?
> 
> At Thu, 5 Dec 2013 09:24:53 +0000, Tim Jervis wrote:
>> Thanks Matthew. As it happens I did get so far as to adjust the \FigureRef 
>> macro as you have in your change, but the results on some of my PDF outputs 
>> have the links going to the wrong pages.
>> 
>> For example, I have a PDF with a link on page 5 of 115 to a figure on page 6 
>> of 116. However, a hover over the link in Preview says "Go to page 4", while 
>> clicking on the link takes me to page 5 of 115. But, some of the figures in 
>> the document do link correctly.
>> 
>> I appreciate this isn't much to go on; I will try to get a clearer example of 
>> the issue.
>> 
>> On 5 Dec 2013, at 02:22, Matthew Flatt <mflatt at cs.utah.edu> wrote:
>> 
>>> Yes, it's about the same, where it's just a matter of adjusting the
>>> \FigureRef Latex macro.
>>> 
>>> I've pushed the change.
>>> 
>>> At Thu, 5 Dec 2013 01:50:53 +0000, Tim Jervis wrote:
>>>> Dear Matthew,
>>>> 
>>>> Is there a similarly easy change to tweak the Figure package to do the same 
>>>> thing for references to figures?
>>>> 
>>>> I've started to hack away but I have not got to the bottom of decoding the 
>>>> link mechanism.
>>>> 
>>>> Kind regards,
>>>> 
>>>> 
>>>> 
>>>> Tim
>>>> 
>>>> On 3 Nov 2013, at 17:11, Matthew Flatt <mflatt at cs.utah.edu> wrote:
>>>> 
>>>>> I've change Scribble to hyperlink section references by default in
>>>>> LaTeX/PDF output.
>>>>> 
>>>>> The change turned out to be easy, due to improvements back in July that
>>>>> deliver a LaTeX-level label to macros that render section links (when
>>>>> the referenced section is within the same document).
>>>>> 
>>>>> At Wed, 23 Oct 2013 23:02:27 +0100, Tim Jervis wrote:
>>>>>> Dear Racket Users,
>>>>>> 
>>>>>> I have been writing a document in Scribble, without output to PDF. The 
>>>> table 
>>>>>> of contents of the PDF nicely links the entries in the table to the 
>>>> sections 
>>>>>> in the document, so that when viewing the PDF on screen rather than 
>> paper, 
>>>> one 
>>>>>> can click or tap on a line in the table of contents to quickly navigate 
>> to 
>>>> the 
>>>>>> relevant section. Unfortunately, if I add a secref element in the body of 
>>>> the 
>>>>>> document, it is not rendered in the same way and the secref elements are 
>>>> not 
>>>>>> clickable on screen.
>>>>>> 
>>>>>> My investigation into this so far has revealed to me that the table of 
>>>>>> contents linking appears to be handled with the LaTeX Hyperref package, 
>> and 
>>>> is 
>>>>>> taken out of Scribble's hands.
>>>>>> 
>>>>>> For HTML output, Scribble seems able to render links just fine. I wonder 
>> if 
>>>>>> Scribble has been written without the notion that PDF output might be 
>>>> viewed 
>>>>>> on screen, so the link elements have been neglected.
>>>>>> 
>>>>>> In any event, is there a way to render a PDF with "live" secref links, to 
>>>> give 
>>>>>> similar functionality to the table of contents?
>>>>>> 
>>>>>> Kind regards,
>>>>>> 
>>>>>> 
>>>>>> 
>>>>>> Tim
>>>>>> 
>>>>>> Tim Jervis
>>>>>> 
>>>>>> http://timjervis.com/
>>>>>> 
>>>>>> ____________________
>>>>>> Racket Users list:
>>>>>> http://lists.racket-lang.org/users
>>>> 
>>>> 
>>>> 
>>>> Tim Jervis
>>>> 
>>>> http://timjervis.com/
>> 
>> 
>> 
>> Tim Jervis
>> 
>> http://timjervis.com/



Tim Jervis

http://timjervis.com/


Posted on the users mailing list.