The comment directive is supplied by the comments plugin. There should be one comment directive in each source file with extension ._comment or ._comment_pending, and the directive should not appear anywhere else. Comments are normally created via the web, in which case ikiwiki automatically creates a suitable ._comment file.

Wiki administrators can also commit comment files to the version control system directly: they should be named starting with the comments_pagename config option (usually comment_) and ending with ._comment, for instance comment_42._comment.

Beispiel:

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

Verwendung

The only required parameter is content, the others just add or override metadata for the comment. Many parameters are shortcuts for meta directives.

• 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.