diff options
author | Jonas Smedegaard <dr@jones.dk> | 2010-10-14 13:38:27 +0200 |
---|---|---|
committer | Jonas Smedegaard <dr@jones.dk> | 2010-10-14 13:38:27 +0200 |
commit | 46d295eff558e247b05e61038bd82d5c5b8155a7 (patch) | |
tree | 13d82b647d5fb5e7f67ba4e7fde9f9206acce302 /ikiwiki/directive/cutpaste.mdwn |
Diffstat (limited to 'ikiwiki/directive/cutpaste.mdwn')
-rw-r--r-- | ikiwiki/directive/cutpaste.mdwn | 56 |
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]]"]] + + [… und später …] + + \[[!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"]] |