summaryrefslogtreecommitdiff
path: root/po/directives.pot
diff options
context:
space:
mode:
authorJonas Smedegaard <dr@jones.dk>2010-07-19 17:19:33 +0200
committerJonas Smedegaard <dr@jones.dk>2010-07-19 17:19:33 +0200
commit65f726be35253058b9d00408a28d95122b25cd9c (patch)
tree2096f78414e658b3c47c23d565abc4998a867ee2 /po/directives.pot
parent92b300411942e76fd997619596051caf0a6ee6bc (diff)
parent077f4b7319c36f2c8bc243b462a992f10e896573 (diff)
Merge branch 'master' into _clean
Diffstat (limited to 'po/directives.pot')
-rw-r--r--po/directives.pot1017
1 files changed, 817 insertions, 200 deletions
diff --git a/po/directives.pot b/po/directives.pot
index 2d69710..e9cc931 100644
--- a/po/directives.pot
+++ b/po/directives.pot
@@ -6,8 +6,8 @@
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: ikiwiki directives 2.62.1\n"
-"POT-Creation-Date: 2009-05-25 23:07+0300\n"
+"Project-Id-Version: ikiwiki directives 3.20100704\n"
+"POT-Creation-Date: 2010-07-16 13:42+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -62,60 +62,69 @@ msgid "\t\\[[!inline pages=\"internal(example/*)\"]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/aggregate.mdwn:22 ikiwiki/directive/calendar.mdwn:26 ikiwiki/directive/img.mdwn:8 ikiwiki/directive/inline.mdwn:41 ikiwiki/directive/table.mdwn:32
+#: ikiwiki/directive/aggregate.mdwn:26
+msgid ""
+"Note the use of `internal()` in the [[ikiwiki/PageSpec]] to match aggregated "
+"pages. By default, aggregated pages are internal pages, which prevents them "
+"from showing up directly in the wiki, and so this special [[PageSpec]] is "
+"needed to match them."
+msgstr ""
+
+#. type: Title ##
+#: ikiwiki/directive/aggregate.mdwn:27 ikiwiki/directive/calendar.mdwn:37 ikiwiki/directive/comment.mdwn:17 ikiwiki/directive/img.mdwn:8 ikiwiki/directive/inline.mdwn:41 ikiwiki/directive/postsparkline.mdwn:16 ikiwiki/directive/sparkline.mdwn:24 ikiwiki/directive/table.mdwn:32
#, no-wrap
-msgid "## usage\n"
+msgid "usage"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/aggregate.mdwn:26
+#: ikiwiki/directive/aggregate.mdwn:31
msgid ""
"Here are descriptions of all the supported parameters to the `aggregate` "
"directive:"
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid "`name` - A name for the feed. Each feed must have a unique name. Required."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid ""
"`url` - The url to the web page for the feed that's being aggregated. "
"Required."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid ""
"`dir` - The directory in the wiki where pages should be saved. Optional, if "
"not specified, the directory is based on the name of the feed."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid ""
"`feedurl` - The url to the feed. Optional, if it's not specified ikiwiki "
"will look for feeds on the `url`. RSS and atom feeds are supported."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid ""
"`updateinterval` - How often to check for new posts, in minutes. Default is "
"15 minutes."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid ""
"`expireage` - Expire old items from this feed if they are older than a "
"specified number of days. Default is to never expire on age."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid ""
"`expirecount` - Expire old items from this feed if there are more than the "
"specified number total. Oldest items will be expired first. Default is to "
@@ -123,7 +132,7 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid ""
"`tag` - A tag to tag each post from the feed with. A good tag to use is the "
"name of the feed. Can be repeated multiple times. The [[tag]] plugin must be "
@@ -131,14 +140,14 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/aggregate.mdwn:47
+#: ikiwiki/directive/aggregate.mdwn:52
msgid ""
"`template` - Template to use for creating the aggregated pages. Defaults to "
"aggregatepost."
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/aggregate.mdwn:51
+#: ikiwiki/directive/aggregate.mdwn:56
msgid ""
"Note that even if you are using subversion or another revision control "
"system, pages created by aggregation will *not* be checked into revision "
@@ -146,7 +155,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/aggregate.mdwn:52 ikiwiki/directive/brokenlinks.mdwn:14 ikiwiki/directive/calendar.mdwn:46 ikiwiki/directive/color.mdwn:25 ikiwiki/directive/copy.mdwn:3 ikiwiki/directive/cut.mdwn:3 ikiwiki/directive/cutpaste.mdwn:50 ikiwiki/directive/edittemplate.mdwn:36 ikiwiki/directive/fortune.mdwn:8 ikiwiki/directive/graph.mdwn:23 ikiwiki/directive/haiku.mdwn:15 ikiwiki/directive/if.mdwn:48 ikiwiki/directive/img.mdwn:38 ikiwiki/directive/inline.mdwn:106 ikiwiki/directive/linkmap.mdwn:24 ikiwiki/directive/listdirectives.mdwn:20 ikiwiki/directive/map.mdwn:19 ikiwiki/directive/meta.mdwn:147 ikiwiki/directive/more.mdwn:16 ikiwiki/directive/orphans.mdwn:15 ikiwiki/directive/pagecount.mdwn:10 ikiwiki/directive/pagestats.mdwn:15 ikiwiki/directive/pagetemplate.mdwn:15 ikiwiki/directive/paste.mdwn:3 ikiwiki/directive/ping.mdwn:18 ikiwiki/directive/poll.mdwn:25 ikiwiki/directive/polygen.mdwn:11 ikiwiki/directive/postsparkline.mdwn:45 ikiwiki/directive/progress.mdwn:18 ikiwiki/directive/shortcut.mdwn:9 ikiwiki/directive/sparkline.mdwn:52 ikiwiki/directive/table.mdwn:45 ikiwiki/directive/tag.mdwn:30 ikiwiki/directive/taglink.mdwn:3 ikiwiki/directive/template.mdwn:18 ikiwiki/directive/testpagespec.mdwn:24 ikiwiki/directive/teximg.mdwn:23 ikiwiki/directive/toc.mdwn:21 ikiwiki/directive/toggle.mdwn:34 ikiwiki/directive/toggleable.mdwn:3 ikiwiki/directive/version.mdwn:12
+#: ikiwiki/directive/aggregate.mdwn:57 ikiwiki/directive/brokenlinks.mdwn:14 ikiwiki/directive/calendar.mdwn:60 ikiwiki/directive/color.mdwn:25 ikiwiki/directive/comment.mdwn:40 ikiwiki/directive/copy.mdwn:3 ikiwiki/directive/cut.mdwn:3 ikiwiki/directive/cutpaste.mdwn:50 ikiwiki/directive/date.mdwn:16 ikiwiki/directive/edittemplate.mdwn:36 ikiwiki/directive/format.mdwn:29 ikiwiki/directive/fortune.mdwn:8 ikiwiki/directive/graph.mdwn:23 ikiwiki/directive/haiku.mdwn:15 ikiwiki/directive/if.mdwn:48 ikiwiki/directive/img.mdwn:39 ikiwiki/directive/inline.mdwn:118 ikiwiki/directive/linkmap.mdwn:29 ikiwiki/directive/listdirectives.mdwn:20 ikiwiki/directive/map.mdwn:21 ikiwiki/directive/meta.mdwn:173 ikiwiki/directive/more.mdwn:16 ikiwiki/directive/orphans.mdwn:15 ikiwiki/directive/pagecount.mdwn:10 ikiwiki/directive/pagestats.mdwn:40 ikiwiki/directive/pagetemplate.mdwn:13 ikiwiki/directive/paste.mdwn:3 ikiwiki/directive/ping.mdwn:18 ikiwiki/directive/poll.mdwn:25 ikiwiki/directive/polygen.mdwn:11 ikiwiki/directive/postsparkline.mdwn:45 ikiwiki/directive/progress.mdwn:18 ikiwiki/directive/shortcut.mdwn:9 ikiwiki/directive/sidebar.mdwn:20 ikiwiki/directive/sparkline.mdwn:52 ikiwiki/directive/table.mdwn:50 ikiwiki/directive/tag.mdwn:35 ikiwiki/directive/taglink.mdwn:3 ikiwiki/directive/template.mdwn:87 ikiwiki/directive/testpagespec.mdwn:24 ikiwiki/directive/teximg.mdwn:23 ikiwiki/directive/toc.mdwn:27 ikiwiki/directive/toggle.mdwn:34 ikiwiki/directive/toggleable.mdwn:3 ikiwiki/directive/version.mdwn:12
#, no-wrap
msgid "[[!meta robots=\"noindex, follow\"]]\n"
msgstr ""
@@ -174,7 +183,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/brokenlinks.mdwn:11 ikiwiki/directive/inline.mdwn:7 ikiwiki/directive/template.mdwn:9
+#: ikiwiki/directive/brokenlinks.mdwn:11 ikiwiki/directive/comment.mdwn:7 ikiwiki/directive/inline.mdwn:7
msgid "Example:"
msgstr ""
@@ -185,104 +194,132 @@ msgid "\t\\[[!brokenlinks pages=\"* and !recentchanges\"]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/calendar.mdwn:3
+#: ikiwiki/directive/calendar.mdwn:2
msgid ""
"The `calendar` directive is supplied by the [[!iki plugins/calendar "
-"desc=calendar]] plugin. This plugin requires extra setup. See the plugin "
-"documentation for details."
+"desc=calendar]] plugin."
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/calendar.mdwn:6
+#: ikiwiki/directive/calendar.mdwn:5
msgid ""
"This directive displays a calendar, similar to the typical calendars shown "
"on some blogs."
msgstr ""
-#. type: Plain text
-#: ikiwiki/directive/calendar.mdwn:7 ikiwiki/directive/postsparkline.mdwn:6 ikiwiki/directive/sparkline.mdwn:7
+#. type: Title ##
+#: ikiwiki/directive/calendar.mdwn:6 ikiwiki/directive/color.mdwn:9 ikiwiki/directive/postsparkline.mdwn:6 ikiwiki/directive/sidebar.mdwn:10 ikiwiki/directive/sparkline.mdwn:7 ikiwiki/directive/table.mdwn:6 ikiwiki/directive/teximg.mdwn:5
#, no-wrap
-msgid "# examples\n"
+msgid "examples"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/calendar.mdwn:10
+#: ikiwiki/directive/calendar.mdwn:9
#, no-wrap
msgid "\t\\[[!calendar ]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/calendar.mdwn:12
+#: ikiwiki/directive/calendar.mdwn:11
#, no-wrap
msgid "\t\\[[!calendar type=\"month\" pages=\"blog/* and !*/Discussion\"]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/calendar.mdwn:14
+#: ikiwiki/directive/calendar.mdwn:13
#, no-wrap
msgid ""
"\t\\[[!calendar type=\"year\" year=\"2005\" pages=\"blog/* and "
"!*/Discussion\"]]\n"
msgstr ""
+#. type: Title ##
+#: ikiwiki/directive/calendar.mdwn:14
+#, no-wrap
+msgid "setup"
+msgstr ""
+
#. type: Plain text
-#: ikiwiki/directive/calendar.mdwn:18
+#: ikiwiki/directive/calendar.mdwn:22
msgid ""
"The calendar is essentially a fancy front end to archives of previous pages, "
"usually used for blogs. It can produce a calendar for a given month, or a "
-"list of months for a given year."
+"list of months for a given year. The month format calendar simply links to "
+"any page posted on each day of the month. The year format calendar links to "
+"archive pages, with names like `archives/2007` (for all of 2007) and "
+"`archives/2007/01` (for January, 2007)."
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/calendar.mdwn:25
+#: ikiwiki/directive/calendar.mdwn:27
msgid ""
-"The month format calendar simply links to any page posted on each day of the "
-"month. The year format calendar links to archive pages, with names like "
-"`archives/2007` (for all of 2007) and `archives/2007/01` (for January, "
-"2007). For this to work, you'll need to create these archive pages. They "
-"typically use [[inline]] to display or list pages created in the given time "
-"frame."
+"While you can insert calendar directives anywhere on your wiki, including in "
+"the sidebar, you'll also need to create these archive pages. They typically "
+"use this directive to display a calendar, and also use [[inline]] to display "
+"or list pages created in the given time frame."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/calendar.mdwn:32
+msgid ""
+"The `ikiwiki-calendar` command can be used to automatically generate the "
+"archive pages. It also refreshes the wiki, updating the calendars to "
+"highlight the current day. This command is typically run at midnight from "
+"cron. An example crontab:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/calendar.mdwn:34
+msgid "An example crontab:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/calendar.mdwn:36
+#, no-wrap
+msgid "\t0 0 * * * ikiwiki-calendar ~/ikiwiki.setup \"posts/* and !*/Discussion\"\n"
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/calendar.mdwn:45
+#: ikiwiki/directive/calendar.mdwn:59
msgid ""
"`type` - Used to specify the type of calendar wanted. Can be one of "
"\"month\" or \"year\". The default is a month view calendar."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/calendar.mdwn:45
+#: ikiwiki/directive/calendar.mdwn:59
msgid ""
"`pages` - Specifies the [[ikiwiki/PageSpec]] of pages to link to from the "
"month calendar. Defaults to \"*\"."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/calendar.mdwn:45
+#: ikiwiki/directive/calendar.mdwn:59
msgid ""
-"`archivebase` - Configures the base of the archives hierarchy. The default "
+"`archivebase` - Configures the base of the archives hierarchy. The default "
"is \"archives\". Note that this default can also be overridden for the whole "
-"wiki by setting `archivebase` in ikiwiki's setup file."
+"wiki by setting `archivebase` in ikiwiki's setup file. Calendars link to "
+"pages under here, with names like \"2010/04\" and \"2010\". These pages can "
+"be automatically created using the `ikiwiki-calendar` program."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/calendar.mdwn:45
+#: ikiwiki/directive/calendar.mdwn:59
msgid ""
"`year` - The year for which the calendar is requested. Defaults to the "
-"current year."
+"current year. Can also use -1 to refer to last year, and so on."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/calendar.mdwn:45
+#: ikiwiki/directive/calendar.mdwn:59
msgid ""
"`month` - The numeric month for which the calendar is requested, in the "
"range 1..12. Used only for the month view calendar, and defaults to the "
-"current month."
+"current month. Can also use -1 to refer to last month, and so on."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/calendar.mdwn:45
+#: ikiwiki/directive/calendar.mdwn:59
msgid ""
"`week_start_day` - A number, in the range 0..6, which represents the day of "
"the week that the month calendar starts with. 0 is Sunday, 1 is Monday, and "
@@ -290,9 +327,9 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/calendar.mdwn:45
+#: ikiwiki/directive/calendar.mdwn:59
msgid ""
-"`months_per_row` - In the annual calendar, number of months to place in each "
+"`months_per_row` - In the year calendar, number of months to place in each "
"row. Defaults to 3."
msgstr ""
@@ -318,12 +355,6 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/color.mdwn:9 ikiwiki/directive/table.mdwn:6 ikiwiki/directive/teximg.mdwn:5
-#, no-wrap
-msgid "## examples\n"
-msgstr ""
-
-#. type: Plain text
#: ikiwiki/directive/color.mdwn:13
msgid ""
"Here the foreground color is defined as a word, while the background color "
@@ -367,6 +398,100 @@ msgid ""
msgstr ""
#. type: Plain text
+#: ikiwiki/directive/comment.mdwn:5
+msgid ""
+"The `comment` directive is supplied by the [[!iki plugins/comments "
+"desc=comments]] plugin, and is used to add a comment to a page. Typically, "
+"the directive is the only thing on a comment page, and is filled out by the "
+"comment plugin when a user posts a comment."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/comment.mdwn:12
+#, no-wrap
+msgid ""
+"\t\\[[!comment format=mdwn\n"
+"\tusername=\"foo\"\n"
+"\tsubject=\"Bar\"\n"
+"\tdate=\"2009-06-02T19:05:01Z\"\n"
+"\tcontent=\"\"\"\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/comment.mdwn:14
+#, no-wrap
+msgid ""
+"\tBlah blah.\n"
+"\t\"\"\"\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/comment.mdwn:16
+#, no-wrap
+msgid "\t]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/comment.mdwn:21
+msgid ""
+"The only required parameter is `content`, the others just add or override "
+"metadata of the comment."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/comment.mdwn:39
+msgid ""
+"`content` - Text to display for the comment. Note that "
+"[[directives|ikiwiki/directive]] may not be allowed, depending on the "
+"configuration of the comment plugin."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/comment.mdwn:39
+msgid "`format` - Specifies the markup used for the content."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/comment.mdwn:39
+msgid "`subject` - Subject for the comment."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/comment.mdwn:39
+msgid ""
+"`date` - Date the comment was posted. Can be entered in nearly any format, "
+"since it's parsed by [[!cpan TimeDate]]"
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/comment.mdwn:39
+msgid ""
+"`username` - Used to record the username (or OpenID) of a logged in "
+"commenter."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/comment.mdwn:39
+msgid ""
+"`nickname` - Name to display for a logged in commenter. (Optional; used for "
+"OpenIDs.)"
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/comment.mdwn:39
+msgid ""
+"`ip` - Can be used to record the IP address of a commenter, if they posted "
+"anonymously."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/comment.mdwn:39
+msgid ""
+"`claimedauthor` - Records the name that the user entered, if anonymous "
+"commenters are allowed to enter their (unverified) name."
+msgstr ""
+
+#. type: Plain text
#: ikiwiki/directive/copy.mdwn:1 ikiwiki/directive/cut.mdwn:1 ikiwiki/directive/paste.mdwn:1
#, no-wrap
msgid "[[!meta redir=/ikiwiki/directive/cutpaste]]\n"
@@ -423,15 +548,15 @@ msgstr ""
#: ikiwiki/directive/cutpaste.mdwn:23
#, no-wrap
msgid ""
-"\t\\[[!toggleable id=\"cut\" text=\"\\[[!paste id=cutlongdesc]]\"]]\n"
-"\t\\[[!toggleable id=\"copy\" text=\"\\[[!paste id=copylongdesc]]\"]]\n"
-"\t\\[[!toggleable id=\"paste\" text=\"\\[[!paste id=pastelongdesc]]\"]]\n"
+"\t\\[[!toggleable id=\"cut\" text=\"[[!paste id=cutlongdesc]]\"]]\n"
+"\t\\[[!toggleable id=\"copy\" text=\"[[!paste id=copylongdesc]]\"]]\n"
+"\t\\[[!toggleable id=\"paste\" text=\"[[!paste id=pastelongdesc]]\"]]\n"
msgstr ""
#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:25
#, no-wrap
-msgid "\t\\[...some time later...]\n"
+msgid "\t[...some time later...]\n"
msgstr ""
#. type: Plain text
@@ -481,7 +606,7 @@ msgstr ""
#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:44
#, no-wrap
-msgid "\t \\[[!toggleable id=bar text=\"\\[[!paste id=baz]]\"]]\n"
+msgid "\t [[!toggleable id=bar text=\"[[!paste id=baz]]\"]]\n"
msgstr ""
#. type: Plain text
@@ -497,6 +622,42 @@ msgid "\tmultiline parameter!\n"
msgstr ""
#. type: Plain text
+#: ikiwiki/directive/date.mdwn:2
+msgid ""
+"The `date` directive is supplied by the [[!iki plugins/date desc=date]] "
+"plugin."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/date.mdwn:7
+msgid ""
+"This directive can be used to display a date on a page, using the same "
+"display method that is used to display the modification date in the page "
+"footer, and other dates in the wiki. This can be useful for consistency of "
+"display, or if you want to embed parseable dates into the page source."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/date.mdwn:10
+msgid ""
+"Like the dates used by the [[meta]] directive, the date can be entered in "
+"nearly any format, since it's parsed by [[!cpan TimeDate]]."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/date.mdwn:13
+msgid ""
+"For example, an update to a page with an embedded date stamp could look "
+"like:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/date.mdwn:15
+#, no-wrap
+msgid "\tUpdated \\[[!date \"Wed, 25 Nov 2009 01:11:55 -0500\"]]: mumble mumble\n"
+msgstr ""
+
+#. type: Plain text
#: ikiwiki/directive/edittemplate.mdwn:2
msgid ""
"The `edittemplate` directive is supplied by the [[!iki plugins/edittemplate "
@@ -550,18 +711,12 @@ msgstr ""
#, no-wrap
msgid ""
"The template page can also contain [[!cpan HTML::Template]] directives,\n"
-"similar to other ikiwiki [[templates]]. Currently only one variable is\n"
+"like other ikiwiki [[templates]]. Currently only one variable is\n"
"set: `<TMPL_VAR name>` is replaced with the name of the page being\n"
"created.\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/edittemplate.mdwn:28
-#, no-wrap
-msgid "----\n"
-msgstr ""
-
-#. type: Plain text
#: ikiwiki/directive/edittemplate.mdwn:35
msgid ""
"It's generally not a good idea to put the `edittemplate` directive in the "
@@ -572,6 +727,67 @@ msgid ""
msgstr ""
#. type: Plain text
+#: ikiwiki/directive/format.mdwn:3
+msgid ""
+"The `format` directive is supplied by the [[!iki plugins/format "
+"desc=format]] plugin."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/format.mdwn:8
+msgid ""
+"The directive allows formatting a chunk of text using any available page "
+"format. It takes two parameters. First is the type of format to use, ie the "
+"extension that would be used for a standalone file of this type. Second is "
+"the text to format."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/format.mdwn:11
+msgid ""
+"For example, this will embed an otl outline inside a page using mdwn or some "
+"other format:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/format.mdwn:12
+#, no-wrap
+msgid "\t\\[[!format otl \"\"\"\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/format.mdwn:19
+#, no-wrap
+msgid ""
+"\tfoo\n"
+"\t\t1\n"
+"\t\t2\n"
+"\tbar\n"
+"\t\t3\n"
+"\t\t4\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/format.mdwn:24
+msgid ""
+"Note that if the highlight plugin is enabled, this directive can also be "
+"used to display syntax highlighted code. Many languages and formats are "
+"supported. For example:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/format.mdwn:25
+#, no-wrap
+msgid "\t\\[[!format perl \"\"\"\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/format.mdwn:27
+#, no-wrap
+msgid "\tprint \"hello, world\\n\";\n"
+msgstr ""
+
+#. type: Plain text
#: ikiwiki/directive/fortune.mdwn:2
msgid ""
"The `fortune` directive is supplied by the [[!iki plugins/fortune "
@@ -835,31 +1051,32 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/img.mdwn:24
+#: ikiwiki/directive/img.mdwn:25
msgid ""
-"You can also pass `alt`, `title`, `class` and `id` parameters. These are "
-"passed through unchanged to the html img tag. If you include a `caption` "
-"parameter, the caption will be displayed centered beneath the image."
+"You can also pass `alt`, `title`, `class`, `align`, `id`, `hspace`, and "
+"`vspace` parameters. These are passed through unchanged to the html img "
+"tag. If you include a `caption` parameter, the caption will be displayed "
+"centered beneath the image."
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/img.mdwn:29
+#: ikiwiki/directive/img.mdwn:30
msgid ""
-"The `link` parameter is used to control whether the scaled down image links "
-"to the full size version. By default it does; set \"link=somepage\" to link "
-"to another page instead, or \"link=no\" to disable the link, or "
+"The `link` parameter is used to control whether the scaled image links to "
+"the full size version. By default it does; set \"link=somepage\" to link to "
+"another page instead, or \"link=no\" to disable the link, or "
"\"link=http://url\" to link to a given url."
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/img.mdwn:32
+#: ikiwiki/directive/img.mdwn:33
msgid ""
"You can also set default values that will be applied to all later images on "
"the page, unless overridden. Useful when including many images on a page."
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/img.mdwn:37
+#: ikiwiki/directive/img.mdwn:38
#, no-wrap
msgid ""
"\t\\[[!img defaults size=200x200 alt=\"wedding photo\"]]\n"
@@ -1014,7 +1231,7 @@ msgstr ""
#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid ""
-"`rootpage` - Enable the postform, and allows controling where newly posted "
+"`rootpage` - Enables the postform, and allows controling where newly posted "
"pages should go, by specifiying the page that they should be a [[SubPage]] "
"of."
msgstr ""
@@ -1025,7 +1242,7 @@ msgid "Here are some less often needed parameters:"
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`actions` - If set to \"yes\" add links to the bottom of the inlined pages "
"for editing and discussion (if they would be shown at the top of the page "
@@ -1033,7 +1250,7 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`rss` - controls generation of an rss feed. If the wiki is configured to "
"generate rss feeds by default, set to \"no\" to disable. If the wiki is "
@@ -1041,7 +1258,7 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`atom` - controls generation of an atom feed. If the wiki is configured to "
"generate atom feeds by default, set to \"no\" to disable. If the wiki is "
@@ -1049,25 +1266,33 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`feeds` - controls generation of all types of feeds. Set to \"no\" to "
"disable generating any feeds."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
+msgid ""
+"`emptyfeeds` - Set to \"no\" to disable generation of empty feeds. Has no "
+"effect if `rootpage` or `postform` is set."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`template` - Specifies the template to fill out to display each inlined "
"page. By default the `inlinepage` template is used, while the `archivepage` "
"template is used for archives. Set this parameter to use some other, custom "
-"template, such as the `titlepage` template that only shows post titles. Note "
-"that you should still set `archive=yes` if your custom template does not "
-"include the page content."
+"template, such as the `titlepage` template that only shows post titles or "
+"the `microblog` template, optimised for microblogging. Note that you should "
+"still set `archive=yes` if your custom template does not include the page "
+"content."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`raw` - Rather than the default behavior of creating a blog, if raw is set "
"to \"yes\", the page will be included raw, without additional markup around "
@@ -1075,65 +1300,84 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
-"`sort` - Controls how inlined pages are sorted. The default, \"age\" is to "
-"sort newest created pages first. Setting it to \"title\" will sort pages by "
-"title, and \"mtime\" sorts most recently modified pages first."
+"`sort` - Controls how inlined pages are [[sorted|pagespec/sorting]]. The "
+"default is to sort the newest created pages first."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid "`reverse` - If set to \"yes\", causes the sort order to be reversed."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`feedshow` - Specify the maximum number of matching pages to include in the "
"rss/atom feeds. The default is the same as the `show` value above."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`feedonly` - Only generate the feed, do not display the pages inline on the "
"page."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`quick` - Build archives in quick mode, without reading page contents for "
-"metadata. By default, this also turns off generation of any feeds."
+"metadata. This also turns off generation of any feeds."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`timeformat` - Use this to specify how to display the time or date for pages "
"in the blog. The format string is passed to the strftime(3) function."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`feedpages` - A [[PageSpec]] of inlined pages to include in the rss/atom "
"feeds. The default is the same as the `pages` value above, and only pages "
-"matches by that value are included, but some of those can be excluded by "
+"matched by that value are included, but some of those can be excluded by "
"specifying a tighter [[PageSpec]] here."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/inline.mdwn:105
+#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`guid` - If a URI is given here (perhaps a UUID prefixed with `urn:uuid:`), "
"the Atom feed will have this as its `<id>`. The default is to use the URL of "
"the page containing the `inline` directive."
msgstr ""
+#. type: Bullet: '* '
+#: ikiwiki/directive/inline.mdwn:117
+msgid ""
+"`feedfile` - Can be used to change the name of the file generated for the "
+"feed. This is particularly useful if a page contains multiple feeds. For "
+"example, set \"feedfile=feed\" to cause it to generate `page/feed.atom` "
+"and/or `page/feed.rss`. This option is not supported if the wiki is "
+"configured not to use `usedirs`."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/inline.mdwn:117
+msgid ""
+"`pagenames` - If given instead of `pages`, this is interpreted as a "
+"space-separated list of links to pages (with the same "
+"[[SubPage/LinkingRules]] as in a [[ikiwiki/WikiLink]]), and they are inlined "
+"in exactly the order given: the `sort` and `pages` parameters cannot be used "
+"in conjunction with this one."
+msgstr ""
+
#. type: Plain text
-#: ikiwiki/directive/inline.mdwn:109
+#: ikiwiki/directive/inline.mdwn:121
msgid ""
"A related directive is the [[ikiwiki/directive/edittemplate]] directive, "
"which allows default text for a new page to be specified."
@@ -1160,37 +1404,51 @@ msgid "\t\\[[!linkmap pages=\"* and !blog/* and !*/Discussion\"]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/linkmap.mdwn:15
+#: ikiwiki/directive/linkmap.mdwn:11
msgid ""
"Only links between mapped pages will be shown; links pointing to or from "
"unmapped pages will be omitted. If the pages to include are not specified, "
-"the links between all pages (and other files) in the wiki are mapped. For "
-"best results, only a small set of pages should be mapped, since otherwise "
-"the map can become very large, unweildy, and complicated. Also, the map is "
-"rebuilt whenever one of the mapped pages is changed, which can make the wiki "
-"a bit slow."
+"the links between all pages (and other files) in the wiki are mapped."
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/linkmap.mdwn:18
+#: ikiwiki/directive/linkmap.mdwn:14
msgid ""
"Here are descriptions of all the supported parameters to the `linkmap` "
"directive:"
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/linkmap.mdwn:23
+#: ikiwiki/directive/linkmap.mdwn:22
msgid "`pages` - A [[ikiwiki/PageSpec]] of the pages to map."
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/linkmap.mdwn:23
+#: ikiwiki/directive/linkmap.mdwn:22
msgid ""
"`height`, `width` - Limit the size of the map to a given height and width, "
"in inches. Both must be specified for the limiting to take effect, otherwise "
"the map's size is not limited."
msgstr ""
+#. type: Bullet: '* '
+#: ikiwiki/directive/linkmap.mdwn:22
+msgid ""
+"`connected` - Controls whether to include pages on the map that link to no "
+"other pages (connected=no, the default), or to only show pages that link to "
+"others (connected=yes)."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/linkmap.mdwn:28
+msgid ""
+"For best results, only a small set of pages should be mapped, since "
+"otherwise the map can become very large, unwieldy, and complicated. If too "
+"many pages are included, the map may get so large that graphviz cannot "
+"render it. Using the `connected` parameter is a good way to prune out pages "
+"that clutter the map."
+msgstr ""
+
#. type: Plain text
#: ikiwiki/directive/listdirectives.mdwn:2
msgid ""
@@ -1275,7 +1533,13 @@ msgid "\t\\[[!map pages=\"* and !blog/* and !*/Discussion\" show=title]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/map.mdwn:18
+#: ikiwiki/directive/map.mdwn:17
+#, no-wrap
+msgid "\t\\[[!map pages=\"* and !blog/* and !*/Discussion\" show=description]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/map.mdwn:20
msgid ""
"Hint: To limit the map to displaying pages less than a certain level deep, "
"use a [[ikiwiki/PageSpec]] like this: `pages=\"* and !*/*/*\"`"
@@ -1346,13 +1610,33 @@ msgid ""
" differently in this case.\n"
msgstr ""
+#. type: Plain text
+#: ikiwiki/directive/meta.mdwn:28
+#, no-wrap
+msgid ""
+" An optional `sortas` parameter will be used preferentially when\n"
+" [[ikiwiki/pagespec/sorting]] by `meta(title)`:\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/meta.mdwn:30
+#, no-wrap
+msgid "\t\\[[!meta title=\"The Beatles\" sortas=\"Beatles, The\"]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/meta.mdwn:32
+#, no-wrap
+msgid "\t\\[[!meta title=\"David Bowie\" sortas=\"Bowie, David\"]]\n"
+msgstr ""
+
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:27
+#: ikiwiki/directive/meta.mdwn:34
msgid "license"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:30
+#: ikiwiki/directive/meta.mdwn:37
#, no-wrap
msgid ""
" Specifies a license for the page, for example, \"GPL\". Can contain\n"
@@ -1360,12 +1644,12 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:32
+#: ikiwiki/directive/meta.mdwn:39
msgid "copyright"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:35
+#: ikiwiki/directive/meta.mdwn:42
#, no-wrap
msgid ""
" Specifies the copyright of the page, for example, \"Copyright 2007 by\n"
@@ -1373,47 +1657,61 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:37
+#: ikiwiki/directive/meta.mdwn:44
msgid "author"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:39
+#: ikiwiki/directive/meta.mdwn:46
#, no-wrap
msgid " Specifies the author of a page.\n"
msgstr ""
+#. type: Plain text
+#: ikiwiki/directive/meta.mdwn:49
+#, no-wrap
+msgid ""
+" An optional `sortas` parameter will be used preferentially when\n"
+" [[ikiwiki/pagespec/sorting]] by `meta(author)`:\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/meta.mdwn:51
+#, no-wrap
+msgid "\t\\[[!meta author=\"Joey Hess\" sortas=\"Hess, Joey\"]]\n"
+msgstr ""
+
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:41
+#: ikiwiki/directive/meta.mdwn:53
msgid "authorurl"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:43
+#: ikiwiki/directive/meta.mdwn:55
#, no-wrap
msgid " Specifies an url for the author of a page.\n"
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:45
+#: ikiwiki/directive/meta.mdwn:57
msgid "description"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:48
+#: ikiwiki/directive/meta.mdwn:60
#, no-wrap
msgid ""
-" Specifies a \"description\" of the page. You could use this to provide\n"
-" a summary, for example, to be picked up by the [[map]] directive.\n"
+" Specifies a short description for the page. This will be put in\n"
+" the html header, and can also be displayed by eg, the [[map]] directive.\n"
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:50
+#: ikiwiki/directive/meta.mdwn:62
msgid "permalink"
msgstr ""