summaryrefslogtreecommitdiff
path: root/ikiwiki
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki')
-rw-r--r--ikiwiki/directive.mdwn47
-rw-r--r--ikiwiki/formatting.mdwn107
-rw-r--r--ikiwiki/markdown.mdwn12
-rw-r--r--ikiwiki/openid.mdwn30
-rw-r--r--ikiwiki/pagespec.mdwn88
-rw-r--r--ikiwiki/pagespec/attachment.mdwn38
-rw-r--r--ikiwiki/pagespec/po.mdwn23
-rw-r--r--ikiwiki/pagespec/sorting.mdwn27
-rw-r--r--ikiwiki/searching.mdwn25
-rw-r--r--ikiwiki/subpage.mdwn14
-rw-r--r--ikiwiki/subpage/linkingrules.mdwn40
-rw-r--r--ikiwiki/wikilink.mdwn31
12 files changed, 482 insertions, 0 deletions
diff --git a/ikiwiki/directive.mdwn b/ikiwiki/directive.mdwn
new file mode 100644
index 0000000..cf071de
--- /dev/null
+++ b/ikiwiki/directive.mdwn
@@ -0,0 +1,47 @@
+[[!meta title="Anweisungen"]]
+[[!meta robots="noindex, follow"]]
+Anweisungen haben eine ähnliche Form wie ein [[ikiwiki/WikiLink]],
+allerdings beginnen sie mit `!` und sie können Parameter enthalten. Die
+allgemeine Form ist:
+
+ \[[!anweisung param="Wert" param="Wert"]]
+
+Dies wird expandiert, bevor der Rest der Seite verarbeitet wird, und kann
+auf unterschiedliche Weise genutzt werden, die Seite zu verändern.
+
+Die Anführungszeichen um die Werte können weggelassen werden, wenn der Wert
+ein einfaches Wort ist. Einige Anweisungen verwenden auch Parameter ohne
+Wert, zum Beispiel:
+
+ \[[!tag foo]]
+
+Eine Anweisung muss nicht ganz in einer einzelnen Zeile stehen, sie kann
+auch auf mehrere Zeilen verteilt werden:
+
+ \[[!anweisung foo="baldersnatch"
+ bar="supercalifragilisticexpialidocious" baz=11]]
+
+Außerdem können mehrere Zeilen Text *in Anführungszeichen* für einen Wert
+verwendet werden. Um Anführungszeichen innerhalb des Werts zu ermöglichen,
+trenne den Textblock durch dreifache Anführungszeichen ab:
+
+ \[[!anweisung text="""
+ 1. "foo"
+ 2. "bar"
+ 3. "baz"
+ """]]
+
+Es gibt in ikiwiki auch eine ältere Syntax für Anweisungen, die ein
+Leerzeichen in erfordert, um sie von [[Wiki-Links|ikiwiki/wikilink]] zu
+unterscheiden. Diese Syntax hat mehrere Nachteile: Sie erfordert ein
+Leerzeichen nach Anweisungen ohne Parameter (so wie `\[[pagecount ]]`), and
+sie verbietet Leerzeichen in [[Wiki-Links|ikiwiki/wikilink]]. Die oben
+gezeigte Syntax mit `!`-Präfix ist nun der Standard in ikiwiki. Die alte
+Syntax wird allerdings auch noch unterstützt, wenn die Option
+`prefix_directives` deaktiviert wird.
+
+[[!if test="enabled(listdirectives)" then="""
+Hier ist eine Liste der aktuell verfügbaren Anweisungen in diesem Wiki:
+
+[[!listdirectives ]]
+"""]]
diff --git a/ikiwiki/formatting.mdwn b/ikiwiki/formatting.mdwn
new file mode 100644
index 0000000..c2d491b
--- /dev/null
+++ b/ikiwiki/formatting.mdwn
@@ -0,0 +1,107 @@
+[[!meta title="Wiki-Seiten formatieren"]]
+[[!meta robots="noindex, follow"]]
+
+Text wird in diesem Wiki standardmäßig in einer Form geschrieben, die sehr
+stark dem ähnelt, wie man eine E-Mail schreibt. Dieser Formatierungs-Stil
+wird [[MarkDown]] genannt und funktioniert folgendermaßen:
+
+Lasse Leerzeilen zwischen Absätzen.
+
+Man kann Text *\*hervorheben\** oder **\*\*stark hervorheben\*\***, indem
+man ihn zwischen einfache oder doppelte Sternchen setzt.
+
+Um eine Liste zu erstellen, beginne jede Zeile mit einem Sternchen:
+
+* "* Dies ist meine Liste"
+* "* Noch ein Eintrag."
+
+Um eine nummerierte Liste zu erhalten, beginne jede Zeile mit einer Zahl
+(welche ist egal), auf die ein Punkt folgt:
+
+1. "1. Erste Zeile"
+2. "2. Zweite Zeile"
+2. "2. Dritte Zeile"
+
+Um eine Überschrift zu erstellen, beginne eine Zeile mit einem oder mehreren
+`#`-Zeichen gefolgt von einem Leerzeichen und dem Text der Überschrift. Die
+Anzahl der `#` steuert die Größe der Überschriften:
+
+# # h1
+## ## h2
+### ### h3
+#### #### h4
+##### ##### h5
+###### ###### h6
+
+Um eine horizontale Linie zu erzeugen, schreibe einfach drei oder mehr
+Bindestriche oder Sternchen allein in eine Zeile:
+
+----
+
+Um jemanden zu zitieren, stelle dem Zitat `>` voran:
+
+> Sein oder nicht sein,
+> das ist die Frage.
+
+Um einen Block mit Programmcode zu schreiben, rücke jede Zeile mit einem
+Tabulatorzeichen oder 4 Leerzeichen ein:
+
+ 10 PRINT "Hallo, Welt!"
+ 20 GOTO 10
+
+Um eine URL oder E-Mail-Adresse zu verlinken, kann man die
+URL einfach ein spitze Klammern schreiben: <<http://ikiwiki.info>>; man kann auch die Form \[Link-Text\]\(URL)\) verwenden.
+
+----
+
+Zusätzlich zu der einfachen HTML-Formatierung mit [[MarkDown]] können in
+diesem Wiki die folgenden zusätzlichen Funktionen verwenden werden:
+
+* Um eine andere Seite des Wikis zu verlinken, schreibe den Namen dieser
+ Seite in doppelte eckige Klammern. Zum Beispiel kann man mit
+ `\[[WikiLink]]` auf [[WikiLink]] verweisen.
+
+[[!if test="enabled(smiley) and smileys" then="""
+* [[Smileys|smileys]] und einige andere nützliche Symbole einfügen. :-)
+"""]]
+
+[[!if test="enabled(shortcut) and shortcuts" then="""
+* [[Abkürzungen|shortcuts]] verwenden, um auf gängige Quellen zu verweisen.
+
+ \[[!wikipedia War\_of\_1812]]
+"""]]
+
+[[!if test="enabled(template) and templates" then="""
+* [[Vorlagen|templates]] erstellen und ausfüllen für wiederholte Blöcke von
+ parametrisiertem Wiki-Text.
+"""]]
+
+* Unterschiedliche [[Anweisungen|directives]] in eine Seite einfügen,
+ die nützliche Aktionen durchführen.
+[[!if test="enabled(toc) or enabled(meta) or enabled(inline)" then="""
+ Zum Beispiel kann man:
+"""]]
+
+[[!if test="enabled(toc)" then="""
+ * Ein Inhaltsverzeichnis zu einer Seite hinzufügen:
+
+ \[[!toc]]
+"""]]
+
+
+[[!if test="enabled(meta)" then="""
+ * Den Titel einer Seite verändern:
+
+ \[[!meta title="Vollständiger Titel der Seite"]]
+"""]]
+
+[[!if test="enabled(inline)" then="""
+ * Einen Blog durch Einbetten mehrerer Seiten erstellen:
+
+ \[[!inline pages="blog/*"]]
+"""]]
+
+[[!if test="enabled(listdirectives)" then="""
+ Eine vollständige Liste der in diesem Wiki aktivierten [[Anweisungen|directive]]:
+ [[!listdirectives ]]
+"""]]
diff --git a/ikiwiki/markdown.mdwn b/ikiwiki/markdown.mdwn
new file mode 100644
index 0000000..4f068b3
--- /dev/null
+++ b/ikiwiki/markdown.mdwn
@@ -0,0 +1,12 @@
+[[!meta robots="noindex, follow"]]
+[Markdown](http://daringfireball.net/projects/markdown/) ist eine minimale
+Sprache für Hervorhebungen, die sich an einfachem Text orientiert, wie er in
+E-Mail-Nachrichten verwendet wird. Diese Hervorhebungssprache wird
+standardmäßig in diesem Wiki verwendet.
+
+Für die Dokumentation der Markdown-Syntax siehe [[Formatierung|formatting]]
+und [Markdown: Syntax](http://daringfireball.net/projects/markdown/syntax).
+
+Beachte dabei, dass [[WikiLinks|WikiLink]] und [[Anweisungen|directive]]
+nicht Teil der Markdown-Syntax sind: Sie sind die einzigen
+Formatierungsanweisungen, die dieses Wiki intern verarbeitet.
diff --git a/ikiwiki/openid.mdwn b/ikiwiki/openid.mdwn
new file mode 100644
index 0000000..09c066b
--- /dev/null
+++ b/ikiwiki/openid.mdwn
@@ -0,0 +1,30 @@
+[[!meta title="OpenID"]]
+[[!meta robots="noindex, follow"]]
+
+[[!if test="enabled(openid)"
+ then="In diesem Wiki ist OpenID **aktiviert**."
+ else="In diesem Wiki ist OpenID **deaktiviert**."]]
+
+[OpenID](http://openid.net) ist ein Mechanismus zur dezentralen
+Authentifizierung, der es erlaubt, sich mit einem einzigen Benutzerkonto bei
+einer wachsenden Anzahl von Webseiten anzumelden.
+
+If you have an account with some of the larger web service providers, you
+might already have an OpenID. [Directory of OpenID
+providers](http://openiddirectory.com/openid-providers-c-1.html)
+
+[[!if test="enabled(openid)" then="""
+In diesem Wiki kann man sich per OpenID anmelden, indem man einfach seine
+OpenID im entsprechenden Feld des Anmeldeformulars eingibt. Man muss in
+diesem Wiki kein Passwort setzen und auch keinen Registrierungsprozess
+durchlaufen, wenn man OpenID verwendet.
+"""]]
+
+---
+
+Außerdem ist es möglich, eine Seite dieses Wikis als OpenID-URL verwendbar
+zu machen, indem sie an einen OpenID-Server weitergereicht wird. Hier ist
+ein Beispiel, wie dies gemacht wird:
+
+ \[[!meta openid="http://yourid.myopenid.com/"
+ server="http://www.myopenid.com/server"]]
diff --git a/ikiwiki/pagespec.mdwn b/ikiwiki/pagespec.mdwn
new file mode 100644
index 0000000..303f073
--- /dev/null
+++ b/ikiwiki/pagespec.mdwn
@@ -0,0 +1,88 @@
+[[!meta robots="noindex, follow"]]
+Um eine Menge von Seiten auszuwählen (etwa Seiten, die gesperrt werden
+sollen, deren Einrechungs-Mails man abonnieren will, oder die man zu einem
+Blog kombinieren will), verwendet das Wiki eine PageSpec. Dies ist ein
+Ausdruck, der auf bestimmte Seiten passt.
+
+Die einfachste PageSpec ist eine einfache Liste von Seiten. Zum Beispiel
+passt dies auf jede der drei aufgezählten Seiten:
+
+ foo or bar or baz
+
+Häufiger wird es vorkommen, dass man Seiten erfassen will, deren Name etwas
+bestimmtes enthält. Man kann dies mit einem Muster tun: "`*`" steht für
+einen beliebigen Teil eines Seitennamens und "`?`" steht für einen
+beliebigen Buchstaben eines Seitennamens. Also passt dies alle Seiten über
+Musik, und alle [[Unterseiten|SubPage]] des Sandkastens, aber nicht auf den
+Sandkasten selbst:
+
+ *music* or SandBox/*
+
+Man kann einem Eintrag ein "`!`" voranstellen, um die betreffenden Seiten
+auszuschließen. Auf diese Weise können alle Seiten außer Diskussionsseiten
+und Sandkasten erfasst werden:
+
+ * and !SandBox and !*/Discussion
+
+Einige weitergehende Einschränkungen können hinzugefügt werden, indem die
+folgenden Funktionen verwendet werden:
+
+* "`glob(someglob)`" - matches pages and other files that match the given glob.
+ Just writing the glob by itself is actually a shorthand for this function.
+* "`page(glob)`" - like `glob()`, but only matches pages, not other files
+* "`link(page)`" - matches only pages that link to a given page (or glob)
+* "`tagged(tag)`" - matches pages that are tagged or link to the given tag (or
+ tags matched by a glob)
+* "`backlink(page)`" - matches only pages that a given page links to
+* "`creation_month(month)`" - matches only files created on the given month
+* "`creation_day(mday)`" - or day of the month
+* "`creation_year(year)`" - or year
+* "`created_after(page)`" - matches only files created after the given page
+ was created
+* "`created_before(page)`" - matches only files created before the given page
+ was created
+* "`internal(glob)`" - like `glob()`, but matches even internal-use
+ pages that globs do not usually match.
+* "`title(glob)`", "`author(glob)`", "`authorurl(glob)`",
+ "`license(glob)`", "`copyright(glob)`", "`guid(glob)`"
+ - match pages that have the given metadata, matching the specified glob.
+* "`user(username)`" - tests whether a modification is being made by a
+ user with the specified username. If openid is enabled, an openid can also
+ be put here. Glob patterns can be used in the username. For example,
+ to match all openid users, use `user(*://*)`
+* "`admin()`" - tests whether a modification is being made by one of the
+ wiki admins.
+* "`ip(address)`" - tests whether a modification is being made from the
+ specified IP address.
+* "`comment(glob)`" - matches comments to a page matching the glob.
+* "`comment_pending(glob)`" - matches unmoderated, pending comments.
+* "`postcomment(glob)`" - matches only when comments are being
+ posted to a page matching the specified glob
+
+Zum Beispiel können alle Seiten eines Blogs ausgewählt werden, die einen
+Link zu einer Seite über Musik enthalten und 2005 geschrieben wurden:
+
+ blog/* and link(music) and creation_year(2005)
+
+Beachte die Verwendung von `and` im obigen Beispiel: Dies bewirkt, dass nur
+die Seiten auf den gesamten Ausdruck passen, die auf alle drei Teilausdrücke
+passen. Verwende `and` um Ausdrücke so zu kombinieren und `or` wenn eine
+Seite nur auf einen der Ausdrücke passen soll. Beachte dass es sinnlos ist,
+`index and SandBox` zu sagen, da keine Seite auf beide Ausdrücke passen
+kann.
+
+Es können auch komplexere Ausdrücke erstellt werden, indem Klammern zur
+Gruppierung verwendet werden. Zum Beispiel passt der folgende Ausdruck auf
+Blog-Seiten, die mit einem der beiden angegebenen Tags versehen sind:
+
+ blog/* and (tagged(foo) or tagged(bar))
+
+Beachte, dass Seitennamen in PageSpecs auf den absoluten Dateinamen der
+Seiten im Wiki passen müssen: Die PageSpec `foo` auf der Seite `a/b` wird
+weder auf `a/foo` noch auf `a/b/foo` passen. Um relative Pfade zum
+Verzeichnis der Seite, die die PageSpec enthält, zu verwenden, kannst du
+`./` verwenden. Zum Beispiel passt `./foo` auf der Seite `a/b` auf `a/foo`.
+
+To indicate the name of the page the PageSpec is used in, you can use a
+single dot. For example, `link(.)` matches all the pages linking to the page
+containing the PageSpec.
diff --git a/ikiwiki/pagespec/attachment.mdwn b/ikiwiki/pagespec/attachment.mdwn
new file mode 100644
index 0000000..4985585
--- /dev/null
+++ b/ikiwiki/pagespec/attachment.mdwn
@@ -0,0 +1,38 @@
+[[!meta title="Anhänge"]]
+[[!meta robots="noindex, follow"]]
+[[!if test="enabled(attachment)"
+ then="In diesem Wiki sind Anhänge **aktiviert**."
+ else="In diesem Wiki sind Anhänge **deaktiviert**."]]
+
+Wenn Anhänge aktiviert sind, kann der Administrator des Wikis bestimmen,
+welche Arten von Anhängen akzeptiert werden, indem er die Einstellung
+`allowed_attachments` verändert.
+
+For example, to limit most users to uploading small images, and nothing
+else, while allowing larger mp3 files to be uploaded by joey into a specific
+directory, and check all attachments for viruses, something like this could
+be used:
+
+ virusfree() and ((user(joey) and podcast/*.mp3 and mimetype(audio/mpeg) and maxsize(15mb)) or (mimetype(image/*) and maxsize(50kb)))
+
+Die reguläre [[ikiwiki/PageSpec]]-Syntax ist um die folgenden zusätzlichen
+Tests erweitert:
+
+* "`maxsize(size)`" - prüft ob der Anhang nicht größer ist als
+ angegeben. Die Größe wird standardmäßig in Bytes angegeben, aber `kb`,
+ `mb`, `gb` und so weiter kann verwendet werden, um die Einheit anzugeben.
+
+* "`minsize(size)`" - prüft ob der Anhang nicht kleiner ist als angegeben.
+
+* "`ispage()`" - prüft ob der Anhang von ikiwiki als Wiki-Seite behandelt
+ wird. Dies ist der Fall, wenn er die Endung `.mdwn` oder die eines anderen
+ aktivierten Seitenformats hat.
+
+ Wenn man also verhindern will, dass Wiki-Seiten als Anhang hochgeladen
+ werden, kann `!ispage()` verwendet werden; wenn nur Wiki-Seiten
+ hochgeladen werden können sollen, geht dies mit `ispage()`.
+
+* "`mimetype(foo/bar)`" - prüft den MIME-Typ des Anhangs. Man kann ein
+ Muster für den Typen verwenden, zum Beispiel `mimetype(image/*)`.
+
+* "`virusfree()`" - prüft den Anhang mit einem Virenscanner.
diff --git a/ikiwiki/pagespec/po.mdwn b/ikiwiki/pagespec/po.mdwn
new file mode 100644
index 0000000..0cd1ec9
--- /dev/null
+++ b/ikiwiki/pagespec/po.mdwn
@@ -0,0 +1,23 @@
+[[!if test="enabled(po)"
+ then="In diesem Wiki ist die po-Unterstützung **aktiviert**."
+ else="In diesem Wiki ist die po-Unterstützung **deaktiviert**."]]
+
+Wenn die [[!iki plugins/po desc=po]]-Erweiterung aktiviert ist, ist die
+reguläre [[ikiwiki/PageSpec]]-Syntax um die folgenden zusätzlichen Tests
+erweitert, die zur Verbesserung der Benutzernavigation in mehrsprachigen
+Wikis verwendet werden kann:
+
+* "`lang(LL)`" - prüft ob eine Seite in der angegebenen Sprache geschrieben
+ ist. Die Sprache wird als (zweibuchstabiger) Sprachcode nach ISO639-1
+ angegeben.
+* "`currentlang()`" - prüft, ob eine Seite in der gleichen Sprache
+ geschrieben ist wie die aktuelle Seite.
+* "`needstranslation()`" - tests whether a page needs translation work. Only
+ slave pages match this PageSpec. A minimum target translation percentage
+ can optionally be passed as an integer parameter: "`needstranslation(50)`"
+ matches only pages less than 50% translated.
+
+Beachte, dass als Sprache jeder nicht-po-Seite `po_master_language`
+angenommen wird, wie in `ikiwiki.setup` angegeben.
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/pagespec/sorting.mdwn b/ikiwiki/pagespec/sorting.mdwn
new file mode 100644
index 0000000..5dfe086
--- /dev/null
+++ b/ikiwiki/pagespec/sorting.mdwn
@@ -0,0 +1,27 @@
+[[!meta title="Sortierung"]]
+Bei einigen der [[Anweisungen|ikiwiki/directive]], die
+[[PageSpecs|ikiwiki/pagespec]] verwenden, kann eine Reihenfolge angegeben
+werden, in der die ausgewählten Seiten angezeigt werden. Die folgenden
+Sortierreihenfolgen können angegeben werden:
+
+* `age` - Zeige die Seiten von der zuletzt angelegten zur ältesten.
+
+* `mtime` - Zeige die Seiten mit der zuletzt veränderten zuerst.
+
+* `title` - Order by title (page name).
+[[!if test="enabled(sortnaturally)" then="""
+* `title_natural` - Orders by title, but numbers in the title are treated as
+ such, ("1 2 9 10 20" instead of "1 10 2 20 9")
+"""]]
+[[!if test="enabled(meta)" then="""
+* `meta(title)` - Order according to the `\[[!meta title="foo"
+ sortas="bar"]]` or `\[[!meta title="foo"]]` [[ikiwiki/directive]], or the
+ page name if no full title was set. `meta(author)`, `meta(date)`,
+ `meta(updated)`, etc. also work.
+"""]]
+
+In addition, you can combine several sort orders and/or reverse the order of
+sorting, with a string like `age -title` (which would sort by age, then by
+title in reverse order if two pages have the same age).
+
+[[!meta robots="noindex, follow"]]
diff --git a/ikiwiki/searching.mdwn b/ikiwiki/searching.mdwn
new file mode 100644
index 0000000..14a6ded
--- /dev/null
+++ b/ikiwiki/searching.mdwn
@@ -0,0 +1,25 @@
+[[!meta robots="noindex, follow"]]
+[[!meta title="Suchen"]]
+
+[[!if test="enabled(search)"
+then="In diesem Wiki ist Suchen **aktiviert**."
+else="In diesem Wiki ist Suchen **deaktiviert**."]]
+
+Wenn Suchen aktiviert ist, kann man wie erwartet Suchausdrücke in das
+Suchfeld eintragen. Es gibt einige spezielle Ausdrücke, um mächtigere Suchen
+zu erstellen.
+
+* Um nach einer Phrase aus mehreren Wörtern zu suchen, schreibe sie in
+ Anführungszeichen.
+* `AND` kann verwendet werden, um nach Dokumenten mit zwei Ausdrücken zu
+ suchen.
+* `OR` kann verwendet werden, um nach Dokumenten mit einem der beiden
+ Ausdrücke zu suchen.
+* Klammern können verwendet werden, um komplexere Suchausdrücke
+ aufzubauen. Zum Beispiel `(foo AND bar) OR (ich AND du)`.
+* Stelle einem Suchausdruck `-` voran, damit er nicht in den Ergebnissen
+ auftaucht. Zum Beispiel wird `-Diskussion`alle Seiten mit "Diskussion"
+ ausschließen.
+* Um nach einer Seite mit einem bestimmten Titel zu suchen, verwende
+ `title:foo`.
+* Um nach Seiten mit einem Link auf "bar" zu suchen, verwende `link:bar`.
diff --git a/ikiwiki/subpage.mdwn b/ikiwiki/subpage.mdwn
new file mode 100644
index 0000000..85a3b11
--- /dev/null
+++ b/ikiwiki/subpage.mdwn
@@ -0,0 +1,14 @@
+[[!meta title="Unterseiten"]]
+[[!meta robots="noindex, follow"]]
+In ikiwiki werden Seiten in einem Verzeichnisbaum angeordnet. Zum Beispiel
+gibt es unterhalb dieser Seite, [[SubPage]], einige verwandte Seiten, etwa
+[[SubPage/LinkingRules]]. Dies ist eine nützliche Möglichkeit, Ordnung in
+ein Wiki zu bringen und nicht nur ein riesiges Verzeichnis voller Seiten zu
+haben.
+
+To add a SubPage, just make a subdirectory and put pages in it. For example,
+this page is subpage.mdwn in this wiki's source, and there is also a subpage
+subdirectory, which contains subpage/linkingrules.mdwn. Subpages can be
+nested as deeply as you'd like.
+
+Wie Links auf Unterseiten gesetzt werden, wird in [[LinkingRules]] erklärt.
diff --git a/ikiwiki/subpage/linkingrules.mdwn b/ikiwiki/subpage/linkingrules.mdwn
new file mode 100644
index 0000000..8df3968
--- /dev/null
+++ b/ikiwiki/subpage/linkingrules.mdwn
@@ -0,0 +1,40 @@
+[[!meta title="Regeln für Links"]]
+[[!meta robots="noindex, follow"]]
+Um einen Link von oder zu einer [[Unterseite|SubPage]] anzulegen, kann man
+normalerweise einfache WikiLinks verwenden, ohne dass diese den Namen des
+Verzeichnisses enthalten, in dem die [[Unterseite|SubPage]] liegt. Ikiwiki
+läuft dann die Verzeichnishierarchie ab und sucht nach einer Seite, die zu
+dem angegebenen Link passt.
+
+Wenn zum Beispiel `FooBar/UnterSeite` einen Link auf `AndereSeite` enthält,
+wird ikiwiki bevorzugt auf `FooBar/UnterSeite/AndereSeite` verweisen, wenn
+diese existiert, dann auf `FooBar/AndereSeite` und schließlich auf
+`AndereSeite` im Wurzelverzeichnis des Wikis.
+
+Insbesondere bedeutet dies, dass wenn ein Link auf `FooBar/EineSeite` auf
+`AndereSeite` momentan auf `AndereSeite` im Wurzelverzeichnis des Wikis
+verweist, und `FooBar/AndereSeite` erstellt wird, dann _ändert_ sich das
+Ziel des Links auf `FooBar/AndereSeite`. Andererseits würde ein Link von
+`BazBar` auf `AndereSeite` durch das Anlegen einer [[Unterseite|SubPage]]
+von `FooBar` unverändert bleiben.
+
+Man kann auch einen Link mit Verzeichnisnamen angeben, etwa
+`FooBar/AndereSeite`, um genauer anzugeben auf welche Seite verwiesen werden
+soll. Nur so kann auf eine [[Unterseite|SubPage]] einer anderen Seite
+verwiesen werden.
+
+Man kann dies zum Beispiel dazu verwenden, um einen Link von `BazBar` auf
+`FooBar/UnterSeite` oder von `BazBar/UnterSeite` auf `FooBar/UnterSeite`
+anzulegen.
+
+Man kann auch `/` am Anfang des Links verwenden, um die Zielseite genau zu
+spezifizieren, wenn es mehrere Seiten mit ähnlichen Namen gibt und der Link
+standardmäßig zur falschen geht. Zum Beispiel zeigt der Link `/AndereSeite`
+auf der Seite `FooBar/UnterSeite` auf `AndereSeite` im Wurzelverzeichnis des
+Wikis, selbst wenn es eine `FooBar/AndereSeite` gibt.
+
+Wenn das Wiki mit einem `userdir` konfiguriert ist, kann man außerdem die
+Seiten im Benutzerverzeichnis direkt verlinken, ohne einen Pfad
+anzugeben. Dadurch können leichter Links auf die Seite eines Benutzers
+gesetzt werden, etwa beim Signieren eines Kommentars. Diese Links werden als
+letzte von allen in Betracht gezogen.
diff --git a/ikiwiki/wikilink.mdwn b/ikiwiki/wikilink.mdwn
new file mode 100644
index 0000000..705392e
--- /dev/null
+++ b/ikiwiki/wikilink.mdwn
@@ -0,0 +1,31 @@
+[[!meta robots="noindex, follow"]]
+WikiLinks ermöglichen es, auf einfache Weise Links zwischen Seiten im Wiki
+zu setzen. Um einen [[WikiLink]] zu erstellen, setze einfach den Namen der
+Zielseite in doppelte eckige Klammern, zum Beispiel `\[[WikiLink]]`.
+
+Wenn man irgendwann einmal etwas wie `\[[WikiLink]]` schreiben will, ohne
+einen WikiLink zu erzeugen, stellt man einfach ein `\` voran, wie in
+`\\[[WikiLink]]`.
+
+Es gibt einige spezielle [[Regeln für Links|SubPage/LinkingRules]], die beim
+setzen von Links zwischen [[Unterseiten|SubPage]] ins Spiel kommen.
+
+WikiLinks werden unabhängig von der Groß- und Kleinschreibung gefunden, man
+braucht sich also keine Gedanken über identische Schreibweise zu machen und
+kann zum Beispiel das erste Wort eines Satzes groß schreiben.
+
+Es ist auch möglich einen WikiLink zu schreiben, der etwas anderes als den
+Seitennamen als Text für den Link verwendet. Zum Beispiel verweist
+`\[[foo_bar|SandBox]]` auf die Sandkasten-Seite, aber der Link erscheint als
+[[foo_bar|SandBox]].
+
+Um auf ein Ziel innerhalb einer Seite zu verweisen, kann man etwas wie
+`\[[WikiLink#foo]]` verwenden.
+
+If the file linked to by a WikiLink looks like an image, it will be
+displayed inline on the page.
+
+---
+
+You can also put an url in a WikiLink, to link to an external page. Email
+addresses can also be used to generate a mailto link.