Ein Schnipsel steht auf jeder Seite — auf der Startseite und auf einer Seite drei Ebenen tiefer. Ein
Link darin muss von überall stimmen. Dafür gibt es {{root}}.
<a href="{{root}}/ueber">Über diese Site</a>| Von welcher Seite | Wird daraus |
|---|---|
| Startseite | ./ueber |
3-platzierung/index | ../ueber |
3-platzierung/02-die-reihenfolge | ../ueber |
a/b/c | ../../ueber |
Gezählt werden die Segmente des Slugs minus eins. 3-platzierung/index und
3-platzierung/02-die-reihenfolge haben beide zwei Segmente und stehen deshalb gleich tief — dass
die eine eine Ordnerseite ist und die andere nicht, ändert daran nichts.
Warum nicht einfach /ueber
Ein führender Schrägstrich zeigt auf die Wurzel des Servers. Solange die Site dort liegt, geht das gut. Sobald sie unter einem Unterpfad liegt, zeigt er daran vorbei:
| Adresse der Site | /ueber landet bei | {{root}}/ueber landet bei |
|---|---|---|
example.org | example.org/ueber ✓ | dasselbe ✓ |
boxi-os.github.io/quartz-layout-box | boxi-os.github.io/ueber ✗ | …/quartz-layout-box/ueber ✓ |
Der zweite Fall ist der Normalfall bei GitHub Pages — und der Grund, warum diese Website ihre eigenen Links so schreibt.
Der Fehler zeigt sich erst nach dem Veröffentlichen
Lokal läuft die Vorschau auf
localhostohne Unterpfad, dort funktioniert der Schrägstrich. Er bricht erst da, wo niemand mehr zusieht.
Bilder ebenso
<img class="img-light" src="{{root}}/static/logo-hell.png" alt="" />
<img class="img-dark" src="{{root}}/static/logo-dunkel.png" alt="" />Die zwei Klassen sind Teil des Plugins: img-light erscheint im hellen Farbschema, img-dark im
dunklen. Das Plugin setzt für beide selbst das display — deshalb im eigenen CSS keine
display-Regel für sie schreiben. Sie schlüge die des Plugins, und dann stünden beide Bilder
gleichzeitig da. Ausführlich unter 5.2 – Gestalten.
Absolute Adressen bleiben absolut
{{baseUrl}} gibt die konfigurierte Adresse der Site zurück — für Fälle, in denen ein Link
absolut sein muss und nicht relativ: ein og:url, ein Feed, eine Zeile zum Kopieren.