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.

Example:

[[!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 - Text to display for the comment. Note that directives may not be allowed, depending on the configuration of the comment plugin.
  • format - Specifies the markup used for the content.
  • subject - Subject for the comment.
  • date - Date the comment was posted. Can be entered in nearly any format, since it's parsed by [[!cpan TimeDate]]
  • username - Used to record the username (or OpenID) of a logged in commenter.
  • nickname - Name to display for a logged in commenter. (Optional; used for OpenIDs.)
  • ip - Can be used to record the IP address of a commenter, if they posted anonymously.
  • claimedauthor - Records the name that the user entered, if anonymous commenters are allowed to enter their (unverified) name.