From 54651a405a863fd4a31b092650e85171b37622bd Mon Sep 17 00:00:00 2001 From: Jonas Smedegaard Date: Thu, 14 Oct 2010 13:38:25 +0200 Subject: Sync with ikiwiki 3.20100926. --- ikiwiki/directive.mdwn | 47 +++++++++++++++++ ikiwiki/formatting.mdwn | 107 ++++++++++++++++++++++++++++++++++++++ ikiwiki/markdown.mdwn | 12 +++++ ikiwiki/openid.mdwn | 30 +++++++++++ ikiwiki/pagespec.mdwn | 88 +++++++++++++++++++++++++++++++ ikiwiki/pagespec/attachment.mdwn | 38 ++++++++++++++ ikiwiki/pagespec/po.mdwn | 23 ++++++++ ikiwiki/pagespec/sorting.mdwn | 27 ++++++++++ ikiwiki/searching.mdwn | 25 +++++++++ ikiwiki/subpage.mdwn | 14 +++++ ikiwiki/subpage/linkingrules.mdwn | 40 ++++++++++++++ ikiwiki/wikilink.mdwn | 31 +++++++++++ 12 files changed, 482 insertions(+) create mode 100644 ikiwiki/directive.mdwn create mode 100644 ikiwiki/formatting.mdwn create mode 100644 ikiwiki/markdown.mdwn create mode 100644 ikiwiki/openid.mdwn create mode 100644 ikiwiki/pagespec.mdwn create mode 100644 ikiwiki/pagespec/attachment.mdwn create mode 100644 ikiwiki/pagespec/po.mdwn create mode 100644 ikiwiki/pagespec/sorting.mdwn create mode 100644 ikiwiki/searching.mdwn create mode 100644 ikiwiki/subpage.mdwn create mode 100644 ikiwiki/subpage/linkingrules.mdwn create mode 100644 ikiwiki/wikilink.mdwn (limited to 'ikiwiki') 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: <>; 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. -- cgit v1.2.3