summaryrefslogtreecommitdiff
path: root/ikiwiki/formatting.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/formatting.mdwn')
-rw-r--r--ikiwiki/formatting.mdwn107
1 files changed, 107 insertions, 0 deletions
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 ]]
+"""]]