Comprehensive TeX Archive Network

Direc­tory macros/latex/contrib/breakurl

README for breakurl, version 1.40 (2013/04/10)


The breakurl is an extension to hyperref package that allows line-breakable
\url-like links when compiling via latex + dvips + ps2pdf.


This package provides a command much like hyperref's \url that typesets a URL
using a typewriter-like font.  However, if the dvips driver is being used, the
original \url doesn't allow line breaks in the middle of the created link: the
link comes in one atomic piece.  This package allows such line breaks in the
generated links.

Note that this package is intended only for those using the dvips driver.
Users of the pdflatex driver already have this feature.


Eventually breakurl may be pre-configured on your system. These instructions
are relevant only if your LaTeX system complains about missing `breakurl.sty'.

If you use MiKTeX, the utility "MiKTeX Package Manager" (Start menu > Programs
> MiKTeX > Browse Packages or MiKTeX Package Manager) is your friend. Just
select `breakurl' and click on Task > Install.

Some Linux systems provide an easy way to install breakurl. As far as I know,
recent Debian and Ubuntu distros provide the "texlive-latex-extra" system
package in the default repository.

If you need to do a manual installation (eventually needed under Unix-like
systems), following instructions may come in handy:

a) Download the package files from CTAN or the TUG server.

b) Generate the `breakurl.sty' file:

     latex breakurl.ins

c) Install the file `breakurl.sty' into your TDS tree:

     mkdir [prefix]/texmf/tex/latex/breakurl
     cp breakurl.sty [prefix]/texmf/tex/latex/breakurl/

   where `[prefix]' is the prefix of your TDS tree.

d) Update the databases if necessary, eg. for teTeX:

     mktexlsr [prefix]/texmf


Please see the breakurl.pdf for a more comprehensive description of the
package, its options, issues, etc. Or generate a dvi version using the

     latex breakurl.dtx


This file may be distributed and/or modified under the conditions of the LaTeX
Project Public License, either version 1.2 of this license or (at your option)
any later version.  The latest version of this license is in:


and version 1.2 or later is part of all distributions of LaTeX version
1999/12/01 or later.

Vilar da Camara Neto
Manaus, Amazonas, Brazil

Down­load the con­tents of this pack­age in one zip archive (117.1k).

breakurl – Line-break­able \url-like links in hy­per­ref when com­pil­ing via dvips/ps2pdf

This pack­age pro­vides a com­mand much like hy­per­ref’s \url that type­sets a URL us­ing a type­writer-like font. How­ever, if the dvips driver is be­ing used, the orig­i­nal \url doesn’t al­low line breaks in the mid­dle of the cre­ated link: the link comes in one atomic piece. This pack­age al­lows such line breaks in the gen­er­ated links.

Li­cense The Project Public Li­cense
Copy­right2005–2009 Vi­lar da Ca­mara Neto
Main­tainer Vi­lar da Ca­mara Neto
Con­tained inTeX Live as breakurl
MiKTeX as breakurl
Topics sup­port for hy­per­text
See also hyperref
Guest Book Sitemap Contact Contact Author