[racket] scribble secref does not render consistently between HTML and PDF
I'm writing some general documentation with scribble and have, so far,
been generating HTML output.
I'm now moving to PDF/Latex output, and the @secref calls are not being
rendered consistently between my output formats. In --html, --htmls and
--text rendering modes, secref renders the title of the section. But with
--latex and --pdf, the link destination is rendered as the section number
"section n.n" (this string is not hyperlinked, either -- something I can
half tolerate, since it's going to printed media).
Scribble's secref documentation states:
> Inserts the hyperlinked title of the section tagged tag, but elements in
^^^^^^^^^^^^^^^^^
> the title content with the 'aux style property are omitted in the
> hyperlink label.
My latex is:
-----------------------------------------------------------------------
$ pdflatex tim.tex
This is pdfTeX, Version 3.1415926-1.40.11 (TeX Live 2010)
restricted \write18 enabled.
entering extended mode
-----------------------------------------------------------------------
Is this a problem with scribble/latex/their interaction or my reading of
the documentation?
Help much appreciated. Thanks,
Tim
Scribble source:
-----------------------------------------------------------------------
#lang scribble/base
@section[#:tag "s-1"]{First Section}
@section[#:tag "s-2"]{Second Section}
Check out @secref{s-1} for more info!
@(version)
-----------------------------------------------------------------------
Text output:
-----------------------------------------------------------------------
1. First Section
2. Second Section
Check out First Section for more info!
5.1
-----------------------------------------------------------------------
HTML output (snippet):
-----------------------------------------------------------------------
<div class="main">
<h3>1<tt> </tt><a name="(part._s-1)"></a>First Section</h3>
<h3>2<tt> </tt><a name="(part._s-2)"></a>Second Section</h3>
<p>Check out <a href="#(part._s-1)" pltdoc="x">First Section</a>
for more info!</p><p>5.1</p></div></div>
<div id="contextindicator"> </div>
-----------------------------------------------------------------------
.tex output (from --latex):
-----------------------------------------------------------------------
% ...
% Generated by `secref'; first arg is section number, second is section title:
\newcommand{\BookRef}[2]{\emph{#2}}
\newcommand{\ChapRef}[2]{\SecRef{#1}{#2}}
\newcommand{\SecRef}[2]{section~#1}
% Generated by `Secref':
\newcommand{\BookRefUC}[2]{\BookRef{#1}{#2}}
\newcommand{\ChapRefUC}[2]{\SecRefUC{#1}{#2}}
\newcommand{\SecRefUC}[2]{Section~#1}
% ...
%%% [snip]
% ...
\section[First Section]{First Section}\label{t:x28part_x22sx2d1x22x29}
\sectionNewpage
\section[Second Section]{Second Section}\label{t:x28part_x22sx2d2x22x29}
Check out \ChapRef{1}{First Section} for more info!
5.1
-----------------------------------------------------------------------
BUT:.pdf output (cut and paste from acroread):
-----------------------------------------------------------------------
1 First Section
2 Second Section
Check out section 1 for more info!
5.1
-----------------------------------------------------------------------
--
Tim Brown <tim.brown at cityc.co.uk> | City Computing Limited |
T: +44 20 8770 2110 | City House, Sutton Park Road |
F: +44 20 8770 2130 | Sutton, Surrey, SM1 2AE, GB |
-----------------------------------------------------------------------|
BEAUTY: What's in your eye when you have a bee in your hand |
-----------------------------------------------------------------------'
City Computing Limited registered in London No. 1767817.
Registered Office: City House, Sutton Park Road, Sutton, Surrey, SM1 2AE
VAT number 372 8290 34.