summaryrefslogtreecommitdiff
path: root/po/directives.pot
diff options
context:
space:
mode:
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 ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:53
+#: ikiwiki/directive/meta.mdwn:65
#, no-wrap
msgid ""
" Specifies a permanent link to the page, if different than the page\n"
@@ -1421,12 +1719,12 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:55
+#: ikiwiki/directive/meta.mdwn:67
msgid "date"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:58
+#: ikiwiki/directive/meta.mdwn:70
#, no-wrap
msgid ""
" Specifies the creation date of the page. The date can be entered in\n"
@@ -1434,12 +1732,12 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:60
+#: ikiwiki/directive/meta.mdwn:72
msgid "stylesheet"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:64
+#: ikiwiki/directive/meta.mdwn:76
#, no-wrap
msgid ""
" Adds a stylesheet to a page. The stylesheet is treated as a wiki link to\n"
@@ -1448,7 +1746,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:67
+#: ikiwiki/directive/meta.mdwn:79
#, no-wrap
msgid ""
"\t\\[[!meta stylesheet=somestyle rel=\"alternate stylesheet\"\n"
@@ -1456,28 +1754,43 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:69
+#: ikiwiki/directive/meta.mdwn:81
msgid "openid"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:74
+#: ikiwiki/directive/meta.mdwn:84
#, no-wrap
msgid ""
" Adds html &lt;link&gt; tags to perform OpenID delegation to an external\n"
-" OpenID server (for `openid` and `openid2`). An optional `xrds-location`\n"
+" OpenID server. This lets you use an ikiwiki page as your OpenID.\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/meta.mdwn:87
+#, no-wrap
+msgid ""
+" By default this will delegate for both `openid` and `openid2`. To only\n"
+" delegate for one, add a parameter such as `delegate=openid`.\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/meta.mdwn:91
+#, no-wrap
+msgid ""
+" An optional `xrds-location`\n"
" parameter lets you specify the location of any [eXtensible Resource\n"
" DescriptorS](http://www.windley.com/archives/2007/05/using_xrds.shtml).\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:76
+#: ikiwiki/directive/meta.mdwn:93
#, no-wrap
-msgid " This lets you use an ikiwiki page as your OpenID. Example:\n"
+msgid " Example:\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:80
+#: ikiwiki/directive/meta.mdwn:97
#, no-wrap
msgid ""
"\t\\\\[[!meta openid=\"http://joeyh.myopenid.com/\"\n"
@@ -1486,12 +1799,12 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:82
+#: ikiwiki/directive/meta.mdwn:99
msgid "link"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:86
+#: ikiwiki/directive/meta.mdwn:103
#, no-wrap
msgid ""
" Specifies a link to another page. This can be used as a way to make the\n"
@@ -1501,19 +1814,19 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:88
+#: ikiwiki/directive/meta.mdwn:105
#, no-wrap
msgid " \\[[!meta link=otherpage]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:90
+#: ikiwiki/directive/meta.mdwn:107
#, no-wrap
msgid " It can also be used to insert a html &lt;link&gt; tag. For example:\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:92
+#: ikiwiki/directive/meta.mdwn:109
#, no-wrap
msgid ""
" \\[[!meta link=\"http://joeyh.myopenid.com/\" "
@@ -1521,7 +1834,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:96 ikiwiki/directive/meta.mdwn:113
+#: ikiwiki/directive/meta.mdwn:113 ikiwiki/directive/meta.mdwn:130
#, no-wrap
msgid ""
" However, this latter syntax won't be allowed if the \n"
@@ -1531,24 +1844,24 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:98
+#: ikiwiki/directive/meta.mdwn:115
msgid "redir"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:100
+#: ikiwiki/directive/meta.mdwn:117
#, no-wrap
msgid " Causes the page to redirect to another page in the wiki.\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:102
+#: ikiwiki/directive/meta.mdwn:119
#, no-wrap
msgid " \t\\[[!meta redir=otherpage]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:105
+#: ikiwiki/directive/meta.mdwn:122
#, no-wrap
msgid ""
" Optionally, a delay (in seconds) can be specified. The default is to\n"
@@ -1556,19 +1869,19 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:107
+#: ikiwiki/directive/meta.mdwn:124
#, no-wrap
msgid " It can also be used to redirect to an external url. For example:\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:109
+#: ikiwiki/directive/meta.mdwn:126
#, no-wrap
msgid " \t\\[[!meta redir=\"http://example.com/\"]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:116
+#: ikiwiki/directive/meta.mdwn:133
#, no-wrap
msgid ""
" For both cases, an anchor to jump to inside the destination page may also "
@@ -1577,24 +1890,24 @@ msgid ""
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:118
+#: ikiwiki/directive/meta.mdwn:135
msgid "robots"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:120
+#: ikiwiki/directive/meta.mdwn:137
#, no-wrap
msgid " Causes the robots meta tag to be written:\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:122
+#: ikiwiki/directive/meta.mdwn:139
#, no-wrap
msgid " \\[[!meta robots=\"index, nofollow\"]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:127
+#: ikiwiki/directive/meta.mdwn:144
#, no-wrap
msgid ""
" Valid values for the attribute are: \"index\", \"noindex\", \"follow\", "
@@ -1606,18 +1919,18 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:129
+#: ikiwiki/directive/meta.mdwn:146
#, no-wrap
msgid " The value is escaped, but its contents are not otherwise checked.\n"
msgstr ""
#. type: Bullet: '* '
-#: ikiwiki/directive/meta.mdwn:131
+#: ikiwiki/directive/meta.mdwn:148
msgid "guid"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:137
+#: ikiwiki/directive/meta.mdwn:154
#, no-wrap
msgid ""
" Specifies a globally unique ID for a page. This guid should be a URI\n"
@@ -1629,7 +1942,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:141
+#: ikiwiki/directive/meta.mdwn:158
#, no-wrap
msgid ""
" This is mostly useful when a page has moved, to keep the guids for\n"
@@ -1637,8 +1950,27 @@ msgid ""
" (see [[!iki tips/howto_avoid_flooding_aggregators]]).\n"
msgstr ""
+#. type: Bullet: '* '
+#: ikiwiki/directive/meta.mdwn:160
+msgid "updated"
+msgstr ""
+
#. type: Plain text
-#: ikiwiki/directive/meta.mdwn:146
+#: ikiwiki/directive/meta.mdwn:167
+#, no-wrap
+msgid ""
+" Specifies a fake modification time for a page, to be output into RSS and\n"
+" Atom feeds. This is useful to avoid flooding aggregators that sort by\n"
+" modification time, like Planet: for instance, when editing an old blog "
+"post\n"
+" to add tags, you could set `updated` to be one second later than the "
+"original\n"
+" value. The date/time can be given in any format that\n"
+" [[!cpan TimeDate]] can understand, just like the `date` field.\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/meta.mdwn:172
msgid ""
"If the field is not one of the above predefined fields, the metadata will be "
"written to the generated html page as a &lt;meta&gt; header. However, this "
@@ -1761,28 +2093,91 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/pagestats.mdwn:8
-msgid "Here's how to use it to create a [[tag]] cloud:"
+#: ikiwiki/directive/pagestats.mdwn:9
+msgid ""
+"Here's how to use it to create a [[tag]] cloud, with tags sized based on "
+"frequency of use:"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/pagestats.mdwn:10
+#: ikiwiki/directive/pagestats.mdwn:11
#, no-wrap
msgid "\t\\[[!pagestats pages=\"tags/*\"]]\n"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/pagestats.mdwn:12
+#: ikiwiki/directive/pagestats.mdwn:14
+msgid ""
+"Here's how to create a list of tags, sized by use as they would be in a "
+"cloud."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:16
+#, no-wrap
+msgid "\t\\[[!pagestats style=\"list\" pages=\"tags/*\"]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:18
msgid "And here's how to create a table of all the pages on the wiki:"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/pagestats.mdwn:14
+#: ikiwiki/directive/pagestats.mdwn:20
#, no-wrap
msgid "\t\\[[!pagestats style=\"table\"]]\n"
msgstr ""
#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:24
+msgid ""
+"The optional `among` parameter limits the pages whose outgoing links are "
+"considered. For instance, to display a cloud of tags used on blog entries, "
+"while ignoring other pages that use those tags, you could use:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:26
+#, no-wrap
+msgid "\t\\[[!pagestats pages=\"tags/*\" among=\"blog/posts/*\"]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:28
+msgid "Or to display a cloud of tags related to Linux, you could use:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:30
+#, no-wrap
+msgid ""
+"\t\\[[!pagestats pages=\"tags/* and not tags/linux\" "
+"among=\"tagged(linux)\"]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:34
+msgid ""
+"The optional `show` parameter limits display to the specified number of "
+"pages. For instance, to show a table of the top ten pages with the most "
+"links:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:36
+#, no-wrap
+msgid "\t\\[[!pagestats style=\"table\" show=\"10\"]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagestats.mdwn:39
+msgid ""
+"The optional `class` parameter can be used to control the class of the "
+"generated tag cloud `div` or page stats `table`."
+msgstr ""
+
+#. type: Plain text
#: ikiwiki/directive/pagetemplate.mdwn:2
msgid ""
"The `pagetemplate` directive is supplied by the [[!iki plugins/pagetemplate "
@@ -1790,9 +2185,15 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/pagetemplate.mdwn:8
+#: ikiwiki/directive/pagetemplate.mdwn:5
+msgid ""
+"This directive allows a page to be displayed using a different "
+"[[template|templates]] than the default `page.tmpl` template."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/pagetemplate.mdwn:10
msgid ""
-"This directive allows a page to be created using a different wikitemplates. "
"The page text is inserted into the template, so the template controls the "
"overall look and feel of the wiki page. This is in contrast to the "
"[[ikiwiki/directive/template]] directive, which allows inserting templates "
@@ -1801,14 +2202,6 @@ msgstr ""
#. type: Plain text
#: ikiwiki/directive/pagetemplate.mdwn:12
-msgid ""
-"This directive can only reference templates that are already installed by "
-"the system administrator, typically into the `/usr/share/ikiwiki/templates` "
-"directory. Example:"
-msgstr ""
-
-#. type: Plain text
-#: ikiwiki/directive/pagetemplate.mdwn:14
#, no-wrap
msgid "\t\\[[!pagetemplate template=\"my_fancy.tmpl\"]]\n"
msgstr ""
@@ -1972,15 +2365,9 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/postsparkline.mdwn:16 ikiwiki/directive/sparkline.mdwn:24
-#, no-wrap
-msgid "# usage\n"
-msgstr ""
-
-#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:20
msgid ""
-"All options aside fron the `pages`, `max`, `formula`, `time`, and `color` "
+"All options aside from the `pages`, `max`, `formula`, `time`, and `color` "
"options are the same as in [[sparkline]] directive."
msgstr ""
@@ -1997,7 +2384,7 @@ msgstr ""
#: ikiwiki/directive/postsparkline.mdwn:28
msgid ""
"The `formula` parameter controls the formula used to generate data points. "
-"Available forumlae:"
+"Available formulae:"
msgstr ""
#. type: Bullet: '* '
@@ -2024,15 +2411,15 @@ msgstr ""
#. type: Bullet: '* '
#: ikiwiki/directive/postsparkline.mdwn:37
msgid ""
-"`peryear` - Each point represents a day; the height represents how many "
+"`peryear` - Each point represents a year; the height represents how many "
"posts were made that year."
msgstr ""
#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:41
msgid ""
-"The `time` parameter has a default value of \"ctime\", since forumae use the "
-"creation times of pages by default. If you instead want them to use the "
+"The `time` parameter has a default value of \"ctime\", since formulae use "
+"the creation times of pages by default. If you instead want them to use the "
"modification times of pages, set it to \"mtime\"."
msgstr ""
@@ -2106,6 +2493,52 @@ msgid ""
msgstr ""
#. type: Plain text
+#: ikiwiki/directive/sidebar.mdwn:2
+msgid ""
+"The `sidebar` directive is supplied by the [[!iki plugins/sidebar "
+"desc=sidebar]] plugin."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/sidebar.mdwn:5
+msgid ""
+"This directive can specify a custom sidebar to display on the page, "
+"overriding any sidebar that is displayed globally."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/sidebar.mdwn:9
+msgid ""
+"If no custom sidebar content is specified, it forces the sidebar page to be "
+"used as the sidebar, even if the `global_sidebars` setting has been used to "
+"disable use of the sidebar page by default."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/sidebar.mdwn:12
+#, no-wrap
+msgid "\t\\[[!sidebar content=\"\"\"\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/sidebar.mdwn:14
+#, no-wrap
+msgid "\tThis is my custom sidebar for this page.\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/sidebar.mdwn:16
+#, no-wrap
+msgid "\t\\[[!calendar pages=\"posts/*\"]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/sidebar.mdwn:19
+#, no-wrap
+msgid "\t\\[[!sidebar]]\n"
+msgstr ""
+
+#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:2
msgid ""
"The `sparkline` directive is supplied by the [[!iki plugins/sparkline "
@@ -2116,7 +2549,7 @@ msgstr ""
#: ikiwiki/directive/sparkline.mdwn:6
msgid ""
"This directive allows for embedding sparklines into wiki pages. A sparkline "
-"is a small word-size graphic chart, that is designed to be displayes "
+"is a small word-size graphic chart, that is designed to be displayed "
"alongside text."
msgstr ""
@@ -2253,8 +2686,8 @@ msgstr ""
#: ikiwiki/directive/table.mdwn:13
#, no-wrap
msgid ""
-"\tCustomer|Amount\n"
-"\tFulanito|134,34\n"
+"\tCustomer |Amount\n"
+"\tFulanito |134,34\n"
"\tMenganito|234,56\n"
"\tMenganito|234,56\n"
msgstr ""
@@ -2328,6 +2761,15 @@ msgid ""
msgstr ""
#. type: Plain text
+#: ikiwiki/directive/table.mdwn:49
+msgid ""
+"For tab-delimited tables (often obtained by copying and pasting from HTML or "
+"a spreadsheet), `delimiter` must be set to a literal tab character. These "
+"are difficult to type in most web browsers - copying and pasting one from "
+"the table data is likely to be the easiest way."
+msgstr ""
+
+#. type: Plain text
#: ikiwiki/directive/tag.mdwn:2
msgid ""
"The `tag` and `taglink` directives are supplied by the [[!iki plugins/tag "
@@ -2371,26 +2813,35 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/tag.mdwn:23
+#: ikiwiki/directive/tag.mdwn:24
msgid ""
"Note that if the wiki is configured to use a tagbase, then the tags will be "
"located under a base directory, such as \"tags/\". This is a useful way to "
"avoid having to write the full path to tags, if you want to keep them "
-"grouped together out of the way."
+"grouped together out of the way. Also, since ikiwiki then knows where to put "
+"tags, it will automatically create tag pages when new tags are used."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/tag.mdwn:28
+msgid ""
+"Bear in mind that specifying a tagbase means you will need to incorporate it "
+"into the `link()` [[ikiwiki/PageSpec]] you use: e.g., if your tagbase is "
+"`tag`, you would match pages tagged \"foo\" with `link(tag/foo)`."
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/tag.mdwn:26
+#: ikiwiki/directive/tag.mdwn:31
msgid ""
"If you want to override the tagbase for a particular tag, you can use "
"something like this:"
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/tag.mdwn:29
+#: ikiwiki/directive/tag.mdwn:34
#, no-wrap
msgid ""
-"\t\\[[!tag ./foo]]\n"
+"\t\\[[!tag /foo]]\n"
"\t\\[[!taglink /foo]]\n"
msgstr ""
@@ -2410,14 +2861,27 @@ msgstr ""
#. type: Plain text
#: ikiwiki/directive/template.mdwn:7
msgid ""
-"[[Templates]] are files that can be filled out and inserted into pages in "
-"the wiki, by using the template directive. The directive has an `id` "
-"parameter that identifies the template to use. The remaining parameters are "
-"used to fill out the template."
+"The template directive allows wiki pages to be used as templates. These "
+"templates can be filled out and inserted into other pages in the wiki using "
+"the directive. The [[templates]] page lists templates that can be used with "
+"this directive."
msgstr ""
#. type: Plain text
#: ikiwiki/directive/template.mdwn:11
+msgid ""
+"The directive has an `id` parameter that identifies the template to use. The "
+"remaining parameters are used to fill out the template."
+msgstr ""
+
+#. type: Title ##
+#: ikiwiki/directive/template.mdwn:12
+#, no-wrap
+msgid "Example"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:15
#, no-wrap
msgid ""
"\t\\[[!template id=note text=\"\"\"Here is the text to insert into my "
@@ -2425,17 +2889,156 @@ msgid ""
msgstr ""
#. type: Plain text
-#: ikiwiki/directive/template.mdwn:14
+#: ikiwiki/directive/template.mdwn:18
msgid ""
"This fills out the `note` template, filling in the `text` field with the "
"specified value, and inserts the result into the page."
msgstr ""
+#. type: Title ##
+#: ikiwiki/directive/template.mdwn:19
+#, no-wrap
+msgid "Using a template"
+msgstr ""
+
#. type: Plain text
-#: ikiwiki/directive/template.mdwn:17
+#: ikiwiki/directive/template.mdwn:25
msgid ""
-"For a list of available templates, and details about how to create more, see "
-"the [[templates]] page."
+"Generally, a value can include any markup that would be allowed in the wiki "
+"page outside the template. Triple-quoting the value even allows quotes to be "
+"included in it. Combined with multi-line quoted values, this allows for "
+"large chunks of marked up text to be embedded into a template:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:26
+#, no-wrap
+msgid ""
+" \\[[!template id=foo name=\"Sally\" color=\"green\" age=8 "
+"notes=\"\"\"\n"
+msgstr ""
+
+#. type: Bullet: ' * '
+#: ikiwiki/directive/template.mdwn:30
+msgid "\\[[Charley]]'s sister."
+msgstr ""
+
+#. type: Bullet: ' * '
+#: ikiwiki/directive/template.mdwn:30
+msgid "\"I want to be an astronaut when I grow up.\""
+msgstr ""
+
+#. type: Bullet: ' * '
+#: ikiwiki/directive/template.mdwn:30
+msgid "Really 8 and a half."
+msgstr ""
+
+#. type: Title ##
+#: ikiwiki/directive/template.mdwn:32
+#, no-wrap
+msgid "Creating a template"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:36
+msgid ""
+"The template is a regular wiki page, located in the `templates/` "
+"subdirectory inside the source directory of the wiki."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:42
+msgid ""
+"(Alternatively, templates can be stored in a directory outside the wiki, as "
+"files with the extension \".tmpl\". By default, these are searched for in "
+"`/usr/share/ikiwiki/templates`; the `templatedir` setting can be used to "
+"make another directory be searched first.)"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:47
+msgid ""
+"The template uses the syntax used by the [[!cpan HTML::Template]] perl "
+"module, which allows for some fairly complex things to be done. Consult its "
+"documentation for the full syntax, but all you really need to know are a few "
+"things:"
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/template.mdwn:59
+msgid ""
+"Each parameter you pass to the template directive will generate a template "
+"variable. There are also some pre-defined variables like PAGE and BASENAME."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/template.mdwn:59
+msgid ""
+"To insert the value of a variable, use `<TMPL_VAR variable>`. Wiki markup in "
+"the value will first be converted to html."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/template.mdwn:59
+msgid ""
+"To insert the raw value of a variable, with wiki markup not yet converted to "
+"html, use `<TMPL_VAR raw_variable>`."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/template.mdwn:59
+msgid ""
+"To make a block of text conditional on a variable being set use `<TMPL_IF "
+"variable>text</TMPL_IF>`."
+msgstr ""
+
+#. type: Bullet: '* '
+#: ikiwiki/directive/template.mdwn:59
+msgid ""
+"To use one block of text if a variable is set and a second if it's not, use "
+"`<TMPL_IF variable>text<TMPL_ELSE>other text</TMPL_IF>`"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:61
+msgid "Here's a sample template:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:75
+#, no-wrap
+msgid ""
+" <span class=\"infobox\">\n"
+" Name: \\[[<TMPL_VAR raw_name>]]<br />\n"
+" Age: <TMPL_VAR age><br />\n"
+" <TMPL_IF color>\n"
+" Favorite color: <TMPL_VAR color><br />\n"
+" <TMPL_ELSE>\n"
+" No favorite color.<br />\n"
+" </TMPL_IF>\n"
+" <TMPL_IF notes>\n"
+" <hr />\n"
+" <TMPL_VAR notes>\n"
+" </TMPL_IF>\n"
+" </span>\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:80
+msgid ""
+"The filled out template will be formatted the same as the rest of the page "
+"that contains it, so you can include WikiLinks and all other forms of wiki "
+"markup in the template. Note though that such WikiLinks will not show up as "
+"backlinks to the page that uses the template."
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/template.mdwn:85
+msgid ""
+"Note the use of \"raw_name\" inside the [[ikiwiki/WikiLink]] generator in "
+"the example above. This ensures that if the name contains something that "
+"might be mistaken for wiki markup, it's not converted to html before being "
+"processed as a [[ikiwiki/WikiLink]]."
msgstr ""
#. type: Plain text
@@ -2534,7 +3137,7 @@ msgstr ""
#. type: Plain text
#: ikiwiki/directive/teximg.mdwn:18
msgid ""
-"If no height is choosen the default height 12 is used. Valid heights are: 8, "
+"If no height is chosen the default height 12 is used. Valid heights are: 8, "
"9, 10, 11, 12, 14, 17, 20. If another height is entered, the closest "
"available height is used."
msgstr ""
@@ -2591,6 +3194,20 @@ msgstr ""
#. type: Plain text
#: ikiwiki/directive/toc.mdwn:20
msgid ""
+"To create a table of contents that only shows headers starting with a given "
+"level, use the `startlevel` parameter. For example, to show only h2 and "
+"smaller headers:"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/toc.mdwn:22
+#, no-wrap
+msgid "\t\\[[!toc startlevel=2]]\n"
+msgstr ""
+
+#. type: Plain text
+#: ikiwiki/directive/toc.mdwn:26
+msgid ""
"The table of contents will be created as an ordered list. If you want an "
"unordered list instead, you can change the list-style in your local style "
"sheet."