Hyperlinks (hyperref)

hyperref verwandelt Querverweise, Zitate, Inhaltsverzeichniseinträge und URLs in anklickbare Links im PDF und richtet sogar Lesezeichen (die PDF-Gliederung) sowie Metadaten wie den Titel ein. Geladen wird es mit einer einzigen Zeile — \usepackage{hyperref} —, aber dazu gehört eine eiserne Regel: fast zuletzt laden. Diese Seite führt durch diese Regel, Linkfarben und -rahmen, Links mit \href und \url sowie korrekte japanische Lesezeichen.

Laden und Reihenfolge

Die Verwendung ist wirklich einfach: Schreibe nur \usepackage{hyperref} in die Präambel. Danach werden Querverweise (\ref), Zitate (\cite), Inhaltsverzeichniseinträge, Fußnoten und Ähnliches automatisch zu Links; ein Klick im PDF-Betrachter springt zum Ziel. Ganz ohne Konfiguration ist also bereits jeder Verweis im Dokument ein funktionierender Link.

Achten musst du vor allem darauf, wo es geladen wird. hyperref definiert intern viele Befehle neu — \ref, \cite, \section und mehr —, um sie zu Links zu machen. Wird es nicht nach anderen Paketen geladen, die dieselben Befehle anfassen, werden seine Neudefinitionen überschrieben. Die Faustregel ist klar: hyperref fast zuletzt in die Präambel setzen, nach den meisten anderen Paketen.

„Zuletzt“ hat allerdings ein paar Ausnahmen. Die wichtigste ist cleveref: Es erkennt die Definitionen von hyperref und muss deshalb nach hyperref geladen werden. Wenn du auch varioref verwendest, lautet die Reihenfolge varioref → hyperref → cleveref. Eine falsche Reihenfolge kann Verweise beschädigen, ohne dass im Log eine Warnung erscheint (Details zu cleveref stehen auf der Seite zu Querverweisen).

% プリアンブルのほぼ最後で読み込む / load almost last
\usepackage{graphicx}
\usepackage{amsmath}
% ... 他のパッケージ ... / ... other packages ...
\usepackage{hyperref}   % ほぼ最後 / almost last
\usepackage{cleveref}   % hyperref の後（数少ない例外）/ after hyperref (an exception)

Linkdarstellung — Farben und Rahmen

Standardmäßig wird ein Link durch einen farbigen Kasten (Rahmen) um den Text angezeigt. Auf dem Bildschirm ist das gut erkennbar, im Druck wird aber nur der Rahmen sichtbar, was oft unschön ist und daher nicht gewünscht wird. Die Darstellung steuerst du entweder mit Optionen beim Laden oder flexibler mit \hypersetup{...}, wobei key=value-Paare durch Kommas getrennt werden. \hypersetup darf überall in der Präambel stehen.

Die am häufigsten verwendete Option ist colorlinks=true. Sie entfernt den Rahmen und färbt stattdessen den Linktext selbst (druckt sauber und bleibt am Bildschirm lesbar). Farben lassen sich nach Art festlegen: linkcolor (interne Links wie \ref), citecolor (Literaturzitate), urlcolor (URLs aus \url/\href) und filecolor (Links zu lokalen Dateien). Die Standardfarben sind der Reihe nach Rot, Grün, Magenta und Cyan.

Für den Druck ist hidelinks praktisch: Es setzt weder Farbe noch Rahmen, sodass Links optisch völlig verschwinden, aber weiterhin anklickbar bleiben. Wenn du umgekehrt die Kastendarstellung beibehältst (colorlinks=false) und alle Rahmenfarben auf einmal ändern willst, setzt allbordercolors alle Rahmenfarben gemeinsam.

Links erstellen — \href und \url

Links zu externen URLs erstellst du mit zwei Befehlen. \href{URL}{display text} hängt einen Link an beliebigen Text (schreibst du \href{https://www.ctan.org/}{CTAN}, wird das Wort „CTAN“ zum Link). \url{URL} dagegen setzt die URL selbst in einer Festbreitenschrift und macht sie zugleich zum Link. Verwende \url, wenn die URL im Text sichtbar sein soll, und \href, wenn sie hinter anderen Wörtern verborgen sein soll.

URLs enthalten oft LaTeX-Sonderzeichen wie %, #, ~ und _. Der Vorteil von \url und \href ist, dass du diese im URL-Teil wörtlich schreiben kannst (kein Escaping nötig, auch wenn das Argument von \url ein paar Einschränkungen hat). Wenn du eine URL in Festbreitenschrift zeigen, aber keinen Link setzen willst, verwende \nolinkurl{URL} (derselbe Satz wie \url, nur ohne Hyperlink).

詳しくは\href{https://www.ctan.org/pkg/hyperref}{hyperref のページ}を参照。
% 「hyperref のページ」がリンクになる / the words become the link

ダウンロードは \url{https://www.ctan.org/} から。
% URL がそのまま組版され、かつリンクになる / URL is typeset and linked

リンクなしで URL を見せる: \nolinkurl{https://example.com/a_b#c}
% 等幅で表示、リンクは張らない / monospaced, no link

PDF-Metadaten

hyperref setzt auch die Dokumentinformationen (Metadaten) der PDF — die Felder, die im PDF-Betrachter unter „Dokumenteigenschaften“ erscheinen und von Such- und Bibliothekswerkzeugen genutzt werden. Du gibst sie über \hypersetup mit diesen Schlüsseln an: pdftitle (Titel), pdfauthor (Autor), pdfsubject (Betreff) und pdfkeywords (Schlagwörter).

Enthält ein Wert ein Komma oder Gleichheitszeichen, kollidiert er mit den Trennzeichen der Schlüssel. Am sichersten ist es daher, jeden Wert in geschweifte Klammern {} zu setzen (z. B. pdftitle={Foundations of Linear Algebra}). Beachte, dass dies unabhängig vom dokumenteigenen \title ist, der nicht in die Metadaten kopiert wird; wenn beides übereinstimmen soll, schreibe dieselbe Zeichenkette von Hand oder verwende einen Mechanismus wie pdfusetitle.

Lesezeichen (die PDF-Gliederung)

Lesezeichen (die Gliederung) sind die einklappbare Liste von Überschriften, die ein PDF-Betrachter neben der Seite zeigt — unverzichtbar für die Navigation in langen Dokumenten. hyperref erzeugt sie automatisch aus den Überschriften des Dokuments (Kapitel, Abschnitte usw.; bookmarks=true ist der Standard). Um Abschnittsnummern in die Lesezeichen aufzunehmen, verwende bookmarksnumbered=true; um den Baum anfangs geöffnet zu zeigen, bookmarksopen=true.

Für robustere Handhabung gibt es das Paket bookmark (nach hyperref laden). Es ersetzt den älteren Lesezeichen-Code von hyperref, erlaubt die Einstellung von Stil und Farbe der Lesezeichen und stabilisiert die Verarbeitung der Hilfsdatei .out. Mit \bookmarksetup{...} lässt sich das Verhalten fein abstimmen. Das ist die Standardlösung, wenn Lesezeichen in komplexen Dokumenten Probleme machen.

Japanische Lesezeichen und Zeichensalat vermeiden

Da Lesezeichen und Metadaten als Zeichenketten im PDF geschrieben werden, kann Japanisch (CJK) zu Zeichensalat führen. Entscheidend ist, sie als Unicode zu schreiben. Bei modernen Engines (LuaLaTeX / XeLaTeX) ist unicode standardmäßig aktiv, sodass japanische Lesezeichen normalerweise ohne Zusatzkonfiguration korrekt erscheinen. Wenn du es ausdrücklich setzen willst, lade \usepackage[unicode]{hyperref} oder setze \hypersetup{unicode}.

In der traditionellen Umgebung pLaTeX / upLaTeX + dvipdfmx ist das Standardrezept, hyperref als \usepackage[dvipdfmx]{hyperref} zu laden und das Paket pxjahyper hinzuzufügen. pxjahyper ist genau dafür da, in (u)pLaTeX japanische Lesezeichen ohne Zeichensalat zu erzeugen, und wird mit TeX Live ausgeliefert. Je nach Engine hilft es, die Ausgabe entsprechend dem internen Kanji-Code nach Unicode zu konvertieren (ähnlich wie pdfencoding=auto).

pdfencoding=auto entscheidet automatisch: Zeichenketten bleiben unverändert, wenn sie in ASCII passen (bei Unicode-Engines im ASCII-Bereich), sonst wird auf Unicode umgeschaltet (hauptsächlich für die pdfTeX-Familie; bei Unicode-Engines ist Unicode ohnehin der Standard und meist unnötig). Im Zweifel reicht diese Regel: Bei LuaLaTeX keine Zusatzkonfiguration; bei (u)pLaTeX pxjahyper hinzufügen.

% --- pLaTeX / upLaTeX + dvipdfmx の場合 / for pLaTeX-upLaTeX + dvipdfmx ---
\usepackage[dvipdfmx]{hyperref}
\usepackage{pxjahyper}   % 日本語しおりの文字化けを防ぐ / fix Japanese bookmarks

% --- LuaLaTeX の場合は unicode が既定 / on LuaLaTeX, unicode is the default ---
% \usepackage{hyperref}

Von hyperref hinzugefügte Verweisbefehle — \autoref und \nameref

Mit hyperref erhältst du außerdem zwei Befehle, die Querverweise unterstützen. \autoref{key} wird anstelle von \ref verwendet: Es stellt automatisch das Wort für die Art des Ziels voran — etwa „section 3.4“, „Figure 3“ usw. — und macht das Ganze zu einem Link. Das vorangestellte Wort lässt sich durch Neudefinition von \figureautorefname, \sectionautorefname und Ähnlichem ändern; so lokalisiert man es auch für Japanisch.

Der andere Befehl, \nameref{key}, fügt nicht eine Nummer, sondern den Titeltext des Ziels ein (verweist du auf das Label von \section{Introduction}, wird „Introduction“ ausgegeben). Nutze ihn, wenn du nach Titel statt nach Nummer verweisen willst. Das Gesamtbild der Verweisbefehle (\ref, \eqref, \cref usw.) wird auf der Seite zu Querverweisen ausführlich behandelt.

Eine ausgearbeitete Konfiguration

Eine in der Praxis häufig verwendete Konfiguration sieht so aus. Sie schaltet mit colorlinks=true den Rahmen aus und färbt den Text, legt unterschiedliche Farben je Art fest, erzeugt nummerierte Lesezeichen mit bookmarksnumbered und füllt die Metadaten. Für druckorientierte Dokumente ersetze die Zeile colorlinks=true durch hidelinks; dann werden die Links unsichtbar, bleiben aber anklickbar.

\usepackage{hyperref}
\hypersetup{
  colorlinks=true,        % 枠ではなく文字に色 / color text, not boxes
  linkcolor=blue,         % 内部リンク / internal links
  citecolor=teal,         % 文献引用 / citations
  urlcolor=magenta,       % URL
  bookmarksnumbered=true, % しおりに節番号 / numbered bookmarks
  pdftitle={線形代数の基礎},
  pdfauthor={山田 太郎},
  pdfsubject={講義ノート},
  pdfkeywords={LaTeX, 線形代数, ベクトル空間},
}
% 印刷向けなら colorlinks の行を hidelinks に置き換える
% for print, swap the colorlinks line for: hidelinks