summaryrefslogtreecommitdiff
path: root/ikiwiki/directive/tag.mdwn
diff options
context:
space:
mode:
Diffstat (limited to 'ikiwiki/directive/tag.mdwn')
-rw-r--r--ikiwiki/directive/tag.mdwn39
1 files changed, 39 insertions, 0 deletions
diff --git a/ikiwiki/directive/tag.mdwn b/ikiwiki/directive/tag.mdwn
new file mode 100644
index 0000000..1299efb
--- /dev/null
+++ b/ikiwiki/directive/tag.mdwn
@@ -0,0 +1,39 @@
+Die `tag`- und `taglink`-Anweisungen werden durch die [[!iki plugins/tag
+desc=tag]]-Erweiterung bereitgestellt.
+
+Diese Anweisungen erlauben es, Seiten mit einer Markierung (englisch *tag*)
+zu versehen. Diese werden wie folgt angegeben:
+
+ \[[!tag tech life linux]]
+
+Die Markierungen verhalten sich genauso, wie wenn ein (versteckter)
+[[ikiwiki/WikiLink]] für jede Markierung vorhanden wäre. Man kann also zum
+Beispiel eine [[ikiwiki/PageSpec]] verwenden, um alle Seiten zu erfassen,
+die eine bestimmte Markierung tragen. In Blogeinträgen werden die
+Markierungen auch am Ende der markierten Seiten und in RSS- und Atom-Feeds
+angezeigt.
+
+Wenn gleichzeitig mit dem Tag ein sichtbarer [[ikiwiki/WikiLink]] erzeugt
+werden soll, kann stattdessen `taglink` verwendet werden:
+
+ \[[!taglink foo]]
+ \[[!taglink markiert_als_foo|foo]]
+
+Note that if the wiki is configured to use a tagbase, then the tags will be
+located under a base directory, such as "tags/". This is a useful way to
+avoid having to write the full path to tags, if you want to keep them
+grouped together out of the way. Also, since ikiwiki then knows where to put
+tags, it will automatically create tag pages when new tags are used.
+
+In der `link()`-[[ikiwiki/PageSpec]] muss diese `tagbase` allerdings
+angegeben werden. Wenn zum Beispiel `tag` als `tagbase` verwendet wird,
+können die mit "foo" markierten Seiten durch `link(tag/foo)` ausgewählt
+werden.
+
+Wenn für eine einzelne Markierung eine abweichende `tagbase` verwendet
+werden soll, kann etwas wie das Folgende verwendet werden:
+
+ \[[!tag /foo]]
+ \[[!taglink /foo]]
+
+[[!meta robots="noindex, follow"]]