Die comment-Anweisung wird durch die comments-Erweiterung bereitgestellt. In jeder Quelldatei mit Endung ._comment oder ._comment_pending sollte eine solche Anweisung vorkommen, und die Anweisung sollte nirgendwo sonst vorkommen. Kommentare werden üblicherweise über das Web erzeugt, in diesem Fall erzeugt ikiwiki automatisch eine passende ._comment-Datei.

Wiki-Administratoren können Kommentar-Dateien auch direkt zum Versionskontrollsystem hinzufügen: Ihr Dateiname sollte mit der Konfigurations-Option comments_pagename beginnen (üblicherweise comment_) und mit ._comment enden, also zum Beispiel comment_42._comment.

Beispiel:

[[!comment  format=mdwn
username="foo"
subject="Bar"
date="2009-06-02T19:05:01Z"
content="""
Bla bla.
"""
]]

Verwendung

Der einzige erforderliche Parameter ist content, die übrigen fügen nur Metadaten zu dem Kommentar hinzu oder ändern diese. Viele Parameter sind Abkürzungen für Meta-Anweisungen.

  • content - Text, der in diesem Kommentar angezeigt werden soll. Anweisungen sind hier unter Umständen nicht erlaubt, abhängig von der Konfiguration der comment-Erweiterung.
  • format - Gibt die Formatierungssprache an, die für den Inhalt verwendet wird.
  • subject - Betreff des Kommentars.
  • date - Datum, an dem der Kommentar veröffentlicht wurde. Kann in beinahe beliebigem Format angegeben werden, da es von TimeDate ausgewertet wird.
  • username - Hier wird der Benutzername (oder die OpenID) eines angemeldeten Kommentators gespeichert.
  • nickname - Name der für einen angemeldeten Kommentator angezeigt wird. (Optional, wird für OpenIDs verwendet.)
  • ip - Hier kann die IP-Adresse eines Kommentators gespeichert werden, wenn der Kommentar anonym abgegeben wurde.
  • claimedauthor - Speichert den Namen, den der Benutzer angegeben hat, wenn anonyme Kommentatoren ihren (nicht verifizierten) Namen angeben dürfen.