diff options
| author | Karl Berry <karl@freefriends.org> | 2006-12-14 00:56:47 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2006-12-14 00:56:47 +0000 |
| commit | 13328a265ebe4ef58c26ab99e0c071edb0ca0195 (patch) | |
| tree | 604fbea81411a5bda1ff25d9cd6ee5dd75acd761 /Master/texmf-doc/doc/english/FAQ-en/html/FAQ-breaklinks.html | |
| parent | da29691fd87e0073830e9d11a1dccd9725f01cc6 (diff) | |
3.16c+html
git-svn-id: svn://tug.org/texlive/trunk@2723 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-breaklinks.html')
| -rw-r--r-- | Master/texmf-doc/doc/english/FAQ-en/html/FAQ-breaklinks.html | 33 |
1 files changed, 25 insertions, 8 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-breaklinks.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-breaklinks.html index a4abc5c3e8e..224d26ffa3d 100644 --- a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-breaklinks.html +++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-breaklinks.html @@ -1,9 +1,10 @@ <head> <title>UK TeX FAQ -- question label breaklinks</title> </head><body> -<h3>Link text doesn't break at end line</h3> +<h3>Link text doesn’t break at end line</h3> +<!-- hyperref overfull link --> <p>When using the <i>hyperref</i> package, you make a block of text -"active" when you define a hyper-link (when the user clicks on +“active” when you define a hyper-link (when the user clicks on that text, the reader program will divert to the <em>target</em> of the link). <p>The <i>hyperref</i> package uses a <em>driver</em> (in the same way @@ -13,14 +14,30 @@ all that hyper-stuff. to distill the resulting PostScript), limitations in the way <i>dvips</i> deals with the <code>\</code><code>special</code> commands mean that <i>hyperref</i> must prevent link anchors from breaking at the end of lines. Other -drivers (notably those for PDFTeX and for <i>dvipdfm</i>) don't +drivers (notably those for PDFTeX and for <i>dvipdfm</i>) don’t suffer from this problem. -<p>The only known solution to this problem is to use the -<i>breakurl</i> package. This package provides a very simple -solution: in place of the single link, the <code>\</code><code>burl</code> command produces -a sequences of small pieces, between each of which a line break is -permitted. Each sequence of pieces, that ends up together in one +<p>The problem may occur in a number of different circumstances. For a +couple of them, there are work-arounds: +<p>First, if you have an URL which is active (so that clicking on +it will activate your web browser to “go to” the URL). In +this case <i>hyperref</i> employs the <i>url</i> package to +split up the URL (as described in +<a href="FAQ-setURL.html">typesetting URLs</a>), but the +<i>dvips</i> driver then suppresses the breaks. The way out is +the <i>breakurl</i> package, which modifies the <code>\</code><code>url</code> command +to produce several smaller pieces, between each of which a line break +is permitted. Each group of pieces, that ends up together in one line, is converted to a single clickable link. +<p>Second, if you have a table of contents, list of figure or tables, or +the like, <i>hyperref</i> will ordinarily make the titles in the +table of contents, or captions in the lists, active. If the title or +caption is long, it will need to break within the table, but the +<i>dvips</i> driver will prevent that. In this case, load +<i>hyperref</i> with the option <code>linktocpage</code>, and only +the page number will be made active. +<p>Otherwise, if you have a lengthy piece of text that you want active, +you have at present no simple solution: you have to rewrite your text, +or to use a different PDF generation mechanism. <dl> <dt><tt><i>breakurl.sty</i></tt><dd><a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/breakurl.zip">macros/latex/contrib/breakurl</a> (<a href="ftp://cam.ctan.org/tex-archive/macros/latex/contrib/breakurl.tar.gz">gzipped tar</a>, <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/breakurl/">browse</a>) </dl> |