You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
63 lines
1.7 KiB
63 lines
1.7 KiB
7 years ago
|
External references
|
||
|
|
-------------------
|
||
|
|
|
||
|
|
Long URLs should be wrapped in the PDF.
|
||
|
|
This can be achieved with the \url command which is used by the LaTeX writer
|
||
|
|
whenever the content (name) of a reference node equals the link URL.
|
||
|
|
|
||
|
|
Example:
|
||
|
|
a long URL that should wrap in the output
|
||
|
|
http://docutils.sourceforge.net/docs/user/latex.html#id79
|
||
|
|
|
||
|
|
|
||
|
|
If the argument contains any "%", "#", or "^^", or ends with ``\``, it can't
|
||
|
|
be used in the argument to another command. The argument must not contain
|
||
|
|
unbalanced braces.
|
||
|
|
|
||
|
|
The characters ^, {, }, and ``\`` are invalid in a "http:" or "ftp:" URL
|
||
|
|
and not recognized as part of it:
|
||
|
|
|
||
|
|
| http://www.example.org/strange^^name
|
||
|
|
| http://www.example.org\\using\\DOS\\paths\\
|
||
|
|
| http://www.example.org/XML/strange{n}ame
|
||
|
|
|
||
|
|
They can, however be used in paths and/or filenames.
|
||
|
|
|
||
|
|
Handling by the LaTeX writer:
|
||
|
|
|
||
|
|
* ``#``, ``\`` and ``%`` are escaped:
|
||
|
|
|
||
|
|
| `URL with # <http://www.w3.org/XML/Schema#dev>`__
|
||
|
|
http://www.w3.org/XML/Schema#dev
|
||
|
|
| `URL with % <http://www.w3.org/XML/Schema%dev>`__
|
||
|
|
http://example.org/Schema%dev
|
||
|
|
| `file with DOS path`__ `A:DOS\\path\\`__
|
||
|
|
|
||
|
|
.. note:: These URLs are typeset inside a LaTeX command without error.
|
||
|
|
|
||
|
|
| http://www.w3.org/XML/Schema#dev
|
||
|
|
| http://example.org/Schema%dev
|
||
|
|
| `A:DOS\\path\\`__
|
||
|
|
|
||
|
|
__
|
||
|
|
__
|
||
|
|
__ A:DOS\\path\\
|
||
|
|
|
||
|
|
|
||
|
|
* ^^ LaTeX's special syntax for characters results in "strange" replacements
|
||
|
|
(both with \href and \url). A warning is given.
|
||
|
|
|
||
|
|
`file with ^^ <../strange^^name>`__:
|
||
|
|
`<../strange^^name>`__
|
||
|
|
|
||
|
|
* Unbalanced braces, { or }, will fail (both with \href and \url)::
|
||
|
|
|
||
|
|
`file with { <../strange{name>`__
|
||
|
|
`<../strange{name>`__
|
||
|
|
|
||
|
|
while balanced braces are suported:
|
||
|
|
|
||
|
|
| `<../strange{n}ame>`__
|
||
|
|
| `<../st{r}ange{n}ame>`__
|
||
|
|
| `<../{st{r}ange{n}ame}>`__
|