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.

Exemple :

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

Usage

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

  • content - Texte du commentaire à afficher. Les directives sont autorisées, ou non, selon la configuration du greffon « comment ».
  • format - Indique le balisage utilisé par le commentaire.
  • subject` - Sujet du commentaire.
  • date - Indique la date du commentaire. Cette date peut utiliser presque tous les formats, puisqu'elle est analysée par TimeDate.
  • username - Sert pour l'enregistrement du nom (ou OpenID) d'un commentateur présent.
  • nickname - Name to display for a logged in commenter. (Optional; used for OpenIDs.)
  • ip - Permet d'enregistrer l'adresse IP d'un commentateur, s'il envoie son commentaire de façon anonyme.
  • claimedauthor - Enregistre le nom donné par l'utilisateur, si les commentateurs anonymes ont la possibilité d'indiquer un nom (invérifié).