blob: 553c4cab84d2bea2068353048cc6a6175c9edeca (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
[[!if test="enabled(comment)"
then="In diesem Wiki ist die Direktive: comment **aktiviert**."
else="In diesem Wiki ist die Direktive: comment **nicht aktiv**; falls dies gewünscht wird, den Admin benachrichtigen."]]
---
The `comment` directive is supplied by the
[[!iki plugins/comments desc=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|ikiwiki/directive]]
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.
[[!meta robots="noindex, follow"]]
|
