Bug#321942: [debiandoc-sgml-pkgs] Bug#321942: Coordinating upload of teTeX-3.0 to unstable

[Frank Küster]

Frank Küster <frank at kuesterei.ch> wrote:

> Jens Seidel <jensseidel at users.sf.net> wrote:
>
>> Please note that bug #214249 was the reason that I introduced
>>
>> \ifx\pdfoutput\undefined
>> \usepackage[hypertex,colorlinks=true]{hyperref}
>> \else
>> \usepackage[pdftex,colorlinks=true]{hyperref}
>> \fi
>>
[...]
> Indeed, I missed the problem with breaklinks and dvips vs. hypertex.
> I'll investigate this, and maybe we'll find a fix that does not need to
> differentiate between PDF and DVI output.
>
> However, for the time being, you should use ifpdf.sty instead:
>
> \usepackage{ifpdf}
> \ifpdf
> \usepackage[hypertex,colorlinks=true]{hyperref}
> \else
> \usepackage[pdftex,colorlinks=true]{hyperref}
> \fi

Instead I suggest

\usepackage{ifpdf}
\ifpdf
\usepackage[hypertex]{hyperref}
\else
\usepackage[colorlinks=true]{hyperref}
\fi

Background:

- the breaklinks option *does* work, but it only has an effect on
  document-internal links, i.e. ordinary text like in the table of
  contents that links to the pages of the respective section headings.
  It has no effect on the line breaking in external hyperlinks like the
  ones on page 7 of the Debian-reference which was mentioned in
  #214249. 

- If you produce a pdf with \usepackage[hypertex]{hyperref}
  (i.e. without the breaklinks option) with the sequence latex; dvips;
  ps2pdf, the external links are broken over the line but still work,
  but the internal links do not work (because it is the wrong driver).

- If you produce a pdf with \usepackage{hyperref} with the same sequence
  latex; dvips; ps2pdf, the external links are not broken over the line,
  but the internal links do work (because it takes the correct driver).

In summary, I would suggest *not* to use the sequence latex; dvips;
ps2pdf at all to produce pdf files, simply because dvips has some
limitations here.  Instead, use "latex; dvips" only when you want to
provide a ps file for printing, and use pdflatex directly when you want
to make pdf files.  With the setup above, both ways work fine, and the
links are not colored in the PS file which I consider nicer - the color
doesn't signify anything in the printout.  Alternatively, you could use
something like

[hypertex,colorlinks=true,linkcolor=black,urlcolor=blue] to get only
URLs colored (see "texdoc hyperref/manual", section 5.4 (3.4 in
teTeX-3.0)).

Regards, Frank
-- 
Frank Küster
Inst. f. Biochemie der Univ. Zürich
Debian Developer