summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/cutpaste.mdwn
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:27 +0200
committerJonas Smedegaard <dr@jones.dk>2010-10-14 13:38:27 +0200
commit46d295eff558e247b05e61038bd82d5c5b8155a7 (patch)
tree13d82b647d5fb5e7f67ba4e7fde9f9206acce302 /ikiwiki/directive/cutpaste.mdwn
Sync with ikiwiki 3.20100926.HEADmasterikiwiki
Diffstat (limited to 'ikiwiki/directive/cutpaste.mdwn')
-rw-r--r--ikiwiki/directive/cutpaste.mdwn56
1 files changed, 56 insertions, 0 deletions
diff --git a/ikiwiki/directive/cutpaste.mdwn b/ikiwiki/directive/cutpaste.mdwn
new file mode 100644
index 0000000..c3fd548
--- /dev/null
+++ b/ikiwiki/directive/cutpaste.mdwn
@@ -0,0 +1,56 @@
+Die `copy`- `cut`- und `paste`-Anweisungen werden durch die [[!iki
+plugins/cutpaste desc=cutpaste]]-Erweiterung bereitgestellt.
+
+Mit diesen Anweisungen kann man Textabschnitte innerhalb einer Seite
+speichern und wieder abrufen:
+
+ * `\[[!cut id=name text="text"]]` merkt sich den Text und erlaubt es, ihn
+ über die angegebene id wieder abzurufen. Der Text taucht an dieser Stelle
+ nicht in der Ausgabe auf.
+ * `\[[!copy id=name text="text"]]` merkt sich den Text und erlaubt es, ihn
+ über die angegebene id wieder abzurufen. Der Text *wird* an dieser Stelle
+ ausgegeben.
+ * `\[[!paste id=name]]` wird durch den zuvor gemerkten Text ersetzt.
+
+Der ausgeschnittene, kopierte und eingefügte Text kann beliebige
+Wiki-Formatierungsanweisungen enthalten, inklusive weiterer Aufrufe von
+`cut`, `copy` und `paste`.
+
+Man muss sich einen Text nicht vor seiner Verwendung merken: Eine
+`cut`-Anweisung kann auch erst nach der `paste`-Anweisung kommen, die ihren
+Text verwendet. Dies ist ein durchaus nützlich, um größere Blöcke von Text
+wie lange Anmerkungen erst später anzugeben und so für einen natürlicheren
+Textfluss zu sorgen. Zum Beispiel:
+
+ \[[!toggleable id="cut" text="[[!paste id=beschreibungcut]]"]]
+ \[[!toggleable id="copy" text="[[!paste id=beschreibungcopy]]"]]
+ \[[!toggleable id="paste" text="[[!paste id=beschreibungpaste]]"]]
+
+ [&hellip; und später &hellip;]
+
+ \[[!cut id=beschreibungcut text="""
+ bla bla bla
+ """]]
+ \[[!cut id=beschreibungcopy text="""
+ bla bla bla
+ """]]
+ \[[!cut id=beschreibungpaste text="""
+ bla bla bla
+ """]]
+
+Auf diese Weise können möglicherweise Schleifen erzeugt werden, aber ikiwiki
+ist schlau und bricht diese auf.
+
+Da man `paste` ohne Anführungszeichen verwenden kann, können mit `copy` und
+`paste` Anweisungen ineinander geschachtelt werden, die mehrzeilige
+Parameter benötigen:
+
+ \[[!toggleable id=foo text="""
+ [[!toggleable id=bar text="[[!paste id=baz]]"]]
+ """]]
+
+ \[[!cut id=baz text="""
+ mehrzeiliger Parameter!
+ """]]
+
+[[!meta robots="noindex, follow"]]