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.mdwn | 17 ++++++ 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 +++++++++++ index.mdwn | 8 +++ recentchanges.mdwn | 7 +++ sandbox.mdwn | 32 ++++++++++++ shortcuts.mdwn | 87 +++++++++++++++++++++++++++++++ templates.mdwn | 80 ++++++++++++++++++++++++++++ 18 files changed, 713 insertions(+) create mode 100644 ikiwiki.mdwn 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 create mode 100644 index.mdwn create mode 100644 recentchanges.mdwn create mode 100644 sandbox.mdwn create mode 100644 shortcuts.mdwn create mode 100644 templates.mdwn diff --git a/ikiwiki.mdwn b/ikiwiki.mdwn new file mode 100644 index 0000000..460ded3 --- /dev/null +++ b/ikiwiki.mdwn @@ -0,0 +1,17 @@ +[[!meta robots="noindex, follow"]] +Dieses Wiki basiert auf [ikiwiki](http://ikiwiki.info/). +[[!if test="enabled(version)" + then="(Es läuft Version [[!version ]].)" +]] + +Dokumentation zur Verwendung von ikiwiki: + +* [[Formatierung|ikiwiki/formatting]] +* [[ikiwiki/wikilink]] +* [[Unterseiten|ikiwiki/subpage]] +* [[ikiwiki/pagespec]] +* [[Anweisungen|ikiwiki/directive]] +* [[ikiwiki/markdown]] +* [[ikiwiki/openid]] +* [[Suchen|ikiwiki/searching]] +* [[templates]] 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. diff --git a/index.mdwn b/index.mdwn new file mode 100644 index 0000000..29d0069 --- /dev/null +++ b/index.mdwn @@ -0,0 +1,8 @@ +Willkommen in Ihrem neuen Wiki. + +Alle Wikis sollten einen [[Sandkasten|SandBox]] haben, also hat dieses auch +einen. + +---- + +Dieses Wiki wird mit [[ikiwiki]] betrieben. diff --git a/recentchanges.mdwn b/recentchanges.mdwn new file mode 100644 index 0000000..2fe112b --- /dev/null +++ b/recentchanges.mdwn @@ -0,0 +1,7 @@ +[[!if test="enabled(meta)" then=""" +[[!meta title="Letzte Änderungen"]] +"""]] +Die letzten Änderungen an diesem Wiki: + +[[!inline pages="internal(recentchanges/change_*) and !*/Discussion" +template=recentchanges show=0]] diff --git a/sandbox.mdwn b/sandbox.mdwn new file mode 100644 index 0000000..bb41a0d --- /dev/null +++ b/sandbox.mdwn @@ -0,0 +1,32 @@ +This is the SandBox, a page anyone can edit to learn how to use the wiki. + +---- + +Dies ist ein Absatz. + +Dies ist noch ein Absatz mit *hervorgehobenem* Text. + +# Überschrift + +## Unterüberschrift + +> Dies ist ein zitierter Absatz. +> +> Dies ist die erste Zitatebene. +> +> > Dies ist ein verschachteltes Zitat. +> +> Zurück zur ersten Ebene. + +Nummerierte Aufzählung + +1. Erster Eintrag +1. Noch einer. +1. Und noch einer ... + +Einfache Aufzählung + +* *Eintrag* +* Eintrag + +[[ikiwiki/WikiLink]] diff --git a/shortcuts.mdwn b/shortcuts.mdwn new file mode 100644 index 0000000..7cc30c0 --- /dev/null +++ b/shortcuts.mdwn @@ -0,0 +1,87 @@ +[[!meta title="Abkürzungen"]] +[[!if test="enabled(shortcut)" + then="In diesem Wiki sind Abkürzungen **aktiviert**." + else="In diesem Wiki sind Abkürzungen **deaktiviert**."]] + +Abkürzungen können unter anderem so benutzt werden: + + \[[!google foo]] + \[[!wikipedia War_of_1812]] + \[[!debbug 12345]] + Betrachte die \[[!cia ikiwiki desc="CIA-Seite für %s"]]. + +Diese Seite bestimmt, welche Abkürzungen das Wiki unterstützt. + +* [[!shortcut name=google url="https://encrypted.google.com/search?q=%s"]] +* [[!shortcut name=archive url="http://web.archive.org/*/%S"]] +* [[!shortcut name=gmap url="http://maps.google.com/maps?q=%s"]] +* [[!shortcut name=gmsg url="http://groups.google.com/groups?selm=%s"]] +* [[!shortcut name=wikipedia + url="https://secure.wikimedia.org/wikipedia/en/wiki/%s"]] +* [[!shortcut name=wikitravel url="https://wikitravel.org/en/%s"]] +* [[!shortcut name=wiktionary + url="https://secure.wikimedia.org/wiktionary/en/wiki/%s"]] +* [[!shortcut name=debbug url="http://bugs.debian.org/%S" desc="Debian bug + #%s"]] +* [[!shortcut name=deblist url="http://lists.debian.org/debian-%s" + desc="debian-%s@lists.debian.org"]] +* [[!shortcut name=debpkg url="http://packages.debian.org/%s"]] +* [[!shortcut name=debpkgsid url="http://packages.debian.org/sid/%s"]] +* [[!shortcut name=debpts url="http://packages.qa.debian.org/%s"]] +* [[!shortcut name=debmsg url="http://lists.debian.org/msgid-search/%s"]] +* [[!shortcut name=debrt + url="https://rt.debian.org/Ticket/Display.html?id=%s"]] +* [[!shortcut name=debss url="http://snapshot.debian.net/package/%s"]] + * Verwendung: `\[[!debss Paket]]`, `\[[!debss Paket#Version]]`, or `\[[!debss Paket/Version]]`. Details unter http://snapshot.debian.net. +* [[!shortcut name=debwiki url="http://wiki.debian.org/%s"]] +* [[!shortcut name=fdobug url="https://bugs.freedesktop.org/show_bug.cgi?id=%s" desc="freedesktop.org bug #%s"]] +* [[!shortcut name=fdolist url="http://lists.freedesktop.org/mailman/listinfo/%s" desc="%s@lists.freedesktop.org"]] +* [[!shortcut name=gnomebug url="http://bugzilla.gnome.org/show_bug.cgi?id=%s" desc="GNOME bug #%s"]] +* [[!shortcut name=linuxbug url="http://bugzilla.kernel.org/show_bug.cgi?id=%s" desc="Linux bug #%s"]] +* [[!shortcut name=mozbug url="https://bugzilla.mozilla.org/show_bug.cgi?id=%s" desc="Mozilla bug #%s"]] +* [[!shortcut name=gnulist url="http://lists.gnu.org/mailman/listinfo/%s" desc="%s@gnu.org"]] +* [[!shortcut name=marcmsg url="http://marc.info/?i=%s"]] +* [[!shortcut name=marclist url="http://marc.info/?l=%s"]] +* [[!shortcut name=gmane url="http://dir.gmane.org/gmane.%s" desc="gmane.%s"]] +* [[!shortcut name=gmanemsg url="http://mid.gmane.org/%s"]] +* [[!shortcut name=cpan url="http://search.cpan.org/search?mode=dist&query=%s"]] +* [[!shortcut name=ctan url="http://tug.ctan.org/cgi-bin/ctanPackageInformation.py?id=%s"]] +* [[!shortcut name=hoogle url="http://haskell.org/hoogle/?q=%s"]] +* [[!shortcut name=iki url="http://ikiwiki.info/%S/"]] +* [[!shortcut name=ljuser url="http://%s.livejournal.com/"]] +* [[!shortcut name=rfc url="http://www.ietf.org/rfc/rfc%s.txt" desc="RFC %s"]] +* [[!shortcut name=c2 url="http://c2.com/cgi/wiki?%s"]] +* [[!shortcut name=meatballwiki url="http://www.usemod.com/cgi-bin/mb.pl?%s"]] +* [[!shortcut name=emacswiki url="http://www.emacswiki.org/cgi-bin/wiki/%s"]] +* [[!shortcut name=haskellwiki url="http://haskell.org/haskellwiki/%s"]] +* [[!shortcut name=dict url="http://www.dict.org/bin/Dict?Form=Dict1&Strategy=*&Database=*&Query=%s"]] +* [[!shortcut name=imdb url="http://imdb.com/find?q=%s"]] +* [[!shortcut name=gpg url="http://pgpkeys.mit.edu:11371/pks/lookup?op=vindex&exact=on&search=0x%s"]] +* [[!shortcut name=perldoc url="http://perldoc.perl.org/search.html?q=%s"]] +* [[!shortcut name=whois url="http://reports.internic.net/cgi/whois?whois_nic=%s&type=domain"]] +* [[!shortcut name=cve url="http://cve.mitre.org/cgi-bin/cvename.cgi?name=%s"]] +* [[!shortcut name=cia url="http://cia.vc/stats/project/%s"]] +* [[!shortcut name=ciauser url="http://cia.vc/stats/user/%s"]] +* [[!shortcut name=flickr url="http://www.flickr.com/photos/%s"]] +* [[!shortcut name=man url="http://linux.die.net/man/%s"]] +* [[!shortcut name=ohloh url="http://www.ohloh.net/projects/%s"]] +* [[!shortcut name=cpanrt url="https://rt.cpan.org/Ticket/Display.html?id=%s" desc="CPAN RT#%s"]] +* [[!shortcut name=novellbug url="https://bugzilla.novell.com/show_bug.cgi?id=%s" desc="bug %s"]] + +Um eine neue Abkürzung hinzuzufügen, verwende die +shortcut-[[Anweisung|ikiwiki/directive]]. In der URL wird `%s` durch den der +Abkürzung übergebenen Text in URL-Kodierung ersetzt. Außerdem wird `%S` +durch den unveränderten Text ersetzt. Der optionale Parameter `desc` +steuert die Beschriftung der Verknüpfung. + +Denke daran, dass der angegebene `name` eine neue +[[Anweisung|ikiwiki/directive]] wird. Deshalb sollte man es vermeiden, +einen Namen zu verwenden, der mit einer bestehenden +[[Anweisung|ikiwiki/directive]] in Konflikt steht. Diese Anweisungen +akzeptieren einen optionalen Parameter `desc`, der statt des Werts aus der +Definition verwendet wird. + +Wenn Sie eine Idee für eine Abkürzung haben, die auch andere nützlich finden +könnten, können Sie diese auf der [Abkürzungs-Seite des +ikiwiki-Wiki](http://ikiwiki.info/shortcuts/) eintragen, damit künftige +Versionen von ikiwiki diese Abkürzung standardmäßig zur Verfügung stellen. diff --git a/templates.mdwn b/templates.mdwn new file mode 100644 index 0000000..ae4012b --- /dev/null +++ b/templates.mdwn @@ -0,0 +1,80 @@ +[[Ikiwiki]] uses many templates for many purposes. By editing its templates, +you can fully customise this site. + +Templates are located in `/usr/share/ikiwiki/templates` by default; the +`templatedir` setting can be used to make another directory be searched +first. Customised templates can also be placed inside the "templates/" +directory in your wiki's source. + +Ikiwiki uses the HTML::Template module as its template engine. This supports +things like conditionals and loops in templates and is pretty easy to +learn. All you really need to know to modify templates is this: + +* To insert the value of a template variable, use ``. +* To make a block of text conditional on a variable being set use `text`. +* To use one block of text if a variable is set and a second if it's not, + use `textother text` + +[[!if test="enabled(template)" then=""" +## template pages + +The [[!iki ikiwiki/directive/template desc="template directive"]] allows +wiki pages to be used as templates, filled out and inserted into other pages +in the wiki. +"""]] + +[[!if test="enabled(edittemplate)" then=""" +## default content for new pages + +The [[!iki ikiwiki/directive/edittemplate desc="edittemplate directive"]] +can be used to make new pages default to containing text from a template +page, which can be filled out as the page is edited. +"""]] + +[[!if test="(enabled(template) or enabled(edittemplate)) +and enabled(inline)" then=""" +[[!inline pages="templates/* and !*.tmpl and !templates/*/* and !*/discussion" +feeds=no archive=yes sort=title template=titlepage +rootpage=templates postformtext="Add a new template named:"]] +"""]] + +## wiki templates + +These templates are used to build the wiki. The aim is to keep almost all +html out of ikiwiki and in the templates. + +* `page.tmpl` - Used for displaying all regular wiki pages. This is the key + template to customise. [[!if test="enabled(pagetemplate)" then=""" + (The [[!iki ikiwiki/directive/pagetemplate desc="pagetemplate directive"]] + can be used to make a page use a different template than `page.tmpl`.)"""]] +* `rsspage.tmpl` - Used for generating rss feeds for blogs. +* `rssitem.tmpl` - Used for generating individual items on rss feeds. +* `atompage.tmpl` - Used for generating atom feeds for blogs. +* `atomitem.tmpl` - Used for generating individual items on atom feeds. +* `inlinepage.tmpl` - Used for displaying a post in a blog. +* `archivepage.tmpl` - Used for listing a page in a blog archive page. +* `titlepage.tmpl` - Used for listing a page by title in a blog archive page. +* `microblog.tmpl` - Used for showing a microblogging post inline. +* `blogpost.tmpl` - Used for a form to add a post to a blog (and rss/atom links) +* `feedlink.tmpl` - Used to add rss/atom links if `blogpost.tmpl` is not used. +* `aggregatepost.tmpl` - Used by the aggregate plugin to create + a page for a post. +* `searchform.tmpl`, `googleform.tmpl` - Used by the search plugin + and google plugin to add search forms to wiki pages. +* `searchquery.tmpl` - This is a Omega template, used by the + search plugin. +* `comment.tmpl` - Used by the comments plugin to display a comment. +* `change.tmpl` - Used to create a page describing a change made to the wiki. +* `recentchanges.tmpl` - Used for listing a change on the RecentChanges page. +* `autoindex.tmpl` - Filled in by the autoindex plugin to make index pages. +* `autotag.tmpl` - Filled in by the tag plugin to make tag pages. +* `calendarmonth.tmpl`, `calendaryear.tmpl` - Used by ikiwiki-calendar to + make calendar archive pages. +* `editpage.tmpl`, `editconflict.tmpl`, `editcreationconflict.tmpl`, + `editfailedsave.tmpl`, `editpagegone.tmpl`, `pocreatepage.tmpl`, + `editcomment.tmpl` `commentmoderation.tmpl`, `renamesummary.tmpl`, + `passwordmail.tmpl`, `openid-selector.tmpl` - Parts of ikiwiki's user + interface; do not normally need to be customised. + +[[!meta robots="noindex, follow"]] -- cgit v1.2.3