po/directives.pot



# LOCALE translation of directives pages for ikiwiki.
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the ikiwiki package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"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"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit"

#. type: Plain text
#: ikiwiki/directive/aggregate.mdwn:4
msgid ""
"The `aggregate` directive is supplied by the [[!iki plugins/aggregate "
"desc=aggregate]] plugin.  This plugin requires extra setup, specifically, a "
"cron job. See the plugin's documentation for details."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/aggregate.mdwn:7
msgid ""
"This directive allows content from other feeds to be aggregated into the "
"wiki.  Aggregate a feed as follows:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/aggregate.mdwn:11
#, no-wrap
msgid ""
"\t\\[[!aggregate name=\"example blog\" dir=\"example\"\n"
"\tfeedurl=\"http://example.com/index.rss\"\n"
"\turl=\"http://example.com/\" updateinterval=\"15\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/aggregate.mdwn:16
msgid ""
"That example aggregates posts from the specified RSS feed, updating no more "
"frequently than once every 15 minutes (though possibly less frequently, if "
"the cron job runs less frequently than that), and puts a page per post under "
"the example/ directory in the wiki."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/aggregate.mdwn:19
msgid ""
"You can then use ikiwiki's [[inline]] directive to create a blog of one or "
"more aggregated feeds. For example:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/aggregate.mdwn:21
#, no-wrap
msgid "\t\\[[!inline pages=\"internal(example/*)\"]]\n"
msgstr ""

#. type: Plain text
#: 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"
msgstr ""

#. type: Plain text
#: 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:52
msgid "`name` - A name for the feed. Each feed must have a unique name.  Required."
msgstr ""

#. type: Bullet: '* '
#: 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: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: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:52
msgid ""
"`updateinterval` - How often to check for new posts, in minutes. Default is "
"15 minutes."
msgstr ""

#. type: Bullet: '* '
#: 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: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 "
"never expire on count."
msgstr ""

#. type: Bullet: '* '
#: 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 "
"enabled for this to work."
msgstr ""

#. type: Bullet: '* '
#: 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: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 "
"control."
msgstr ""

#. type: Plain text
#: 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 ""

#. type: Plain text
#: ikiwiki/directive/brokenlinks.mdwn:2
msgid ""
"The `brokenlinks` directive is supplied by the [[!iki plugins/brokenlinks "
"desc=brokenlinks]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/brokenlinks.mdwn:6
msgid ""
"This directive generates a list of broken links on pages in the wiki. This "
"is a useful way to find pages that still need to be written, or links that "
"are written wrong."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/brokenlinks.mdwn:9
msgid ""
"The optional parameter \"pages\" can be a [[ikiwiki/PageSpec]] specifying "
"the pages to search for broken links, default is search them all."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/brokenlinks.mdwn:11 ikiwiki/directive/comment.mdwn:7 ikiwiki/directive/inline.mdwn:7
msgid "Example:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/brokenlinks.mdwn:13
#, no-wrap
msgid "\t\\[[!brokenlinks pages=\"* and !recentchanges\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/calendar.mdwn:2
msgid ""
"The `calendar` directive is supplied by the [[!iki plugins/calendar "
"desc=calendar]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/calendar.mdwn:5
msgid ""
"This directive displays a calendar, similar to the typical calendars shown "
"on some blogs."
msgstr ""

#. 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"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/calendar.mdwn:9
#, no-wrap
msgid "\t\\[[!calendar ]]\n"
msgstr ""

#. type: Plain text
#: 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: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: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. 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:27
msgid ""
"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: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: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:59
msgid ""
"`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.  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:59
msgid ""
"`year` - The year for which the calendar is requested. Defaults to the "
"current year. Can also use -1 to refer to last year, and so on."
msgstr ""

#. type: Bullet: '* '
#: 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. Can also use -1 to refer to last month, and so on."
msgstr ""

#. type: Bullet: '* '
#: 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 "
"so on. Defaults to 0, which is Sunday."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/calendar.mdwn:59
msgid ""
"`months_per_row` - In the year calendar, number of months to place in each "
"row. Defaults to 3."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:2
msgid ""
"The `color` directive is supplied by the [[!iki plugins/color desc=color]] "
"plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:5
msgid ""
"This directive can be used to color a piece of text on a page.  It can be "
"used to set the foreground and/or background color of the text."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:8
msgid ""
"You can use a color name (e.g. `white`) or HTML code (e.g. `#ffffff`)  to "
"define colors."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:13
msgid ""
"Here the foreground color is defined as a word, while the background color "
"is defined as a HTML color code:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:15
#, no-wrap
msgid ""
"\t\\[[!color foreground=white background=#ff0000 text=\"White text on red "
"background\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:18
msgid ""
"The background color is missing, so the text is displayed on default "
"background:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:20
#, no-wrap
msgid ""
"\t\\[[!color foreground=white text=\"White text on default color "
"background\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:22
msgid "The foreground is missing, so the text has the default foreground color:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/color.mdwn:24
#, no-wrap
msgid ""
"\t\\[[!color background=#ff0000 text=\"Default color text on red "
"background\"]]\n"
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"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:3
msgid ""
"The `copy`, `cut` and `paste` directives are supplied by the [[!iki "
"plugins/cutpaste desc=cutpaste]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:5
msgid "With these directives you can store and recall pieces of text in a page:"
msgstr ""

#. type: Bullet: ' * '
#: ikiwiki/directive/cutpaste.mdwn:11
msgid ""
"`\\[[!cut id=name text=\"text\"]]` memorizes the text allowing to recall it "
"using the given ID.  The text being cut is not included in the output."
msgstr ""

#. type: Bullet: ' * '
#: ikiwiki/directive/cutpaste.mdwn:11
msgid ""
"`\\[[!copy id=name text=\"text\"]]` memorizes the text allowing to recall it "
"using the given ID.  The text being cut *is* included in the output."
msgstr ""

#. type: Bullet: ' * '
#: ikiwiki/directive/cutpaste.mdwn:11
msgid "`\\[[!paste id=name]]` is replaced by the previously memorized text."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:14
msgid ""
"The text being cut, copied and pasted can freely include wiki markup, "
"including more calls to cut, copy and paste."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:19
msgid ""
"You do not need to memorize the text before using it: a cut directive can "
"follow the paste directive that uses its text.  In fact, this is quite "
"useful to postpone big blocks of text like long annotations and have a more "
"natural flow.  For example:"
msgstr ""

#. type: Plain text
#: 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"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:25
#, no-wrap
msgid "\t[...some time later...]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:26
#, no-wrap
msgid "\t\\[[!cut id=cutlongdesc text=\"\"\"\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:28 ikiwiki/directive/cutpaste.mdwn:31 ikiwiki/directive/cutpaste.mdwn:34
#, no-wrap
msgid "\t   blah blah blah\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:29
#, no-wrap
msgid "\t\\[[!cut id=copylongdesc text=\"\"\"\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:32
#, no-wrap
msgid "\t\\[[!cut id=pastelongdesc text=\"\"\"\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:38
msgid ""
"This can potentially be used to create loops, but ikiwiki is clever and "
"breaks them."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:41
msgid ""
"Since you can paste without using double quotes, copy and paste can be used "
"to nest directives that require multiline parameters inside each other:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:42
#, no-wrap
msgid "\t\\[[!toggleable id=foo text=\"\"\"\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:44
#, no-wrap
msgid "\t  [[!toggleable id=bar text=\"[[!paste id=baz]]\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:46
#, no-wrap
msgid "\t\\[[!cut id=baz text=\"\"\"\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/cutpaste.mdwn:48
#, no-wrap
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 "
"desc=edittemplate]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/edittemplate.mdwn:6
msgid ""
"This directive allows registering template pages, that provide default "
"content for new pages created using the web frontend. To register a "
"template, insert a [[ikiwiki/directive/template]] directive on some other "
"page."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/edittemplate.mdwn:8
#, no-wrap
msgid "\t\\[[!edittemplate template=\"bugtemplate\" match=\"bugs/*\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/edittemplate.mdwn:13
msgid ""
"In the above example, the page named \"bugtemplate\" is registered as a "
"template to be used when any page named \"bugs/*\" is created. To avoid the "
"directive displaying a note about the template being registered, add "
"\"silent=yes\"."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/edittemplate.mdwn:17
msgid ""
"Often the template page contains a simple skeleton for a particular type of "
"page. For the bug report pages in the above example, it might look something "
"like:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/edittemplate.mdwn:22
#, no-wrap
msgid ""
"\tPackage: \n"
"\tVersion: \n"
"\tReproducible: y/n\n"
"\tDetails:\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/edittemplate.mdwn:27
#, no-wrap
msgid ""
"The template page can also contain [[!cpan HTML::Template]] directives,\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:35
msgid ""
"It's generally not a good idea to put the `edittemplate` directive in the "
"template page itself, since the directive would then be included as part of "
"the template on new pages, which would then in turn be registered as "
"templates. If multiple pages are registered as templates for a new page, an "
"arbitrary one is chosen, so that could get confusing."
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 "
"desc=fortune]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/fortune.mdwn:5
msgid ""
"This just uses the `fortune` program to insert a fortune cookie into the "
"page.  Usage:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/fortune.mdwn:7
#, no-wrap
msgid "\t\\[[!fortune ]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/graph.mdwn:2
msgid ""
"The `graph` directive is supplied by the [[!iki plugins/graphviz "
"desc=graphviz]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/graph.mdwn:5
msgid ""
"This directive allows embedding [graphviz](http://www.graphviz.org/) graphs "
"in a page.  Example usage:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/graph.mdwn:7
#, no-wrap
msgid "\t\\[[!graph src=\"a -> b -> c; a -> c;\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/graph.mdwn:11
msgid ""
"Note that graphs will only show up in previews if your browser has "
"[[!wikipedia data: URI]] support, or if the same graph already exists on "
"that page."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/graph.mdwn:13
msgid "The `graph` directive supports the following parameters:"
msgstr ""

#. type: Bullet: '- '
#: ikiwiki/directive/graph.mdwn:22
msgid "`src` - The graphviz source to render."
msgstr ""

#. type: Bullet: '- '
#: ikiwiki/directive/graph.mdwn:22
msgid ""
"`type` - The type of graph to render: `graph` or `digraph`.  Defaults to "
"`digraph`."
msgstr ""

#. type: Bullet: '- '
#: ikiwiki/directive/graph.mdwn:22
msgid ""
"`prog` - The graphviz program to render with: `dot`, `neato`, `fdp`, "
"`twopi`, or `circo`.  Defaults to `dot`."
msgstr ""

#. type: Bullet: '- '
#: ikiwiki/directive/graph.mdwn:22
msgid ""
"`height`, `width` - Limit the size of the graph to a given height and width, "
"in inches. You must specify both to limit the size; otherwise, graphviz will "
"choose a size, without any limit."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/haiku.mdwn:2
msgid ""
"The `haiku` directive is supplied by the [[!iki plugins/haiku desc=haiku]] "
"plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/haiku.mdwn:5
msgid ""
"This directive allows inserting a randomly generated haiku into a wiki "
"page.  Just type:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/haiku.mdwn:7
#, no-wrap
msgid "\t\\[[!haiku hint=\"argument\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/haiku.mdwn:8
#, no-wrap
msgid "[[!haiku hint=\"argument test\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/haiku.mdwn:14
msgid ""
"The hint parameter can be omitted, it only provides the generator a hint of "
"what to write the haiku about. If no hint is given, it might base it on the "
"page name. Since the vocabulary it knows is very small, many hints won't "
"affect the result at all."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:2
msgid ""
"The `if` directive is supplied by the [[!iki plugins/conditional "
"desc=conditional]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:5
msgid ""
"With this directive, you can make text be conditionally displayed on a "
"page.  For example:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:9
#, no-wrap
msgid ""
"\t\\[[!if test=\"enabled(smiley)\"\n"
"\t      then=\"The smiley plugin is enabled :-)\"\n"
"\t      else=\"No smiley plugin here..\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:12
msgid ""
"If the specified `test` succeeds, the `then` text will be displayed, "
"otherwise the `else` text will be displayed. The `else` part is optional."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:16
msgid ""
"The `then` and `else` values can include any markup that would be allowed in "
"the wiki page outside the template. Triple-quoting the values even allows "
"quotes to be included."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:21
msgid ""
"The `test` is a [[ikiwiki/PageSpec]]; if it matches any page in the wiki "
"then it succeeds. So you can do things like testing for the existence of a "
"page or pages, testing to see if any pages were created in a given month, "
"and so on."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:25
msgid ""
"If you want the [[ikiwiki/PageSpec]] to only match against the page that "
"contains the conditional, rather than matching against all pages in the "
"wiki, set the \"all\" parameter to \"no\"."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:28
msgid ""
"In an `if` directive, the regular [[ikiwiki/PageSpec]] syntax is expanded "
"with the following additional tests:"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/if.mdwn:30
msgid "enabled(plugin)"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:32
#, no-wrap
msgid "  Tests whether the specified plugin is enabled.\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/if.mdwn:34
msgid "sourcepage(glob)"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:37
#, no-wrap
msgid ""
"  Tests whether the glob matches the name of the page that contains the\n"
"  conditional.\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/if.mdwn:39
msgid "destpage(glob)"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:43
#, no-wrap
msgid ""
"  Tests whether the glob matches the name of the page that is being built.\n"
"  That might be different than the name of the page that contains the\n"
"  conditional, if it's being inlined into another page.\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/if.mdwn:45
msgid "included()"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/if.mdwn:47
#, no-wrap
msgid "  Tests whether the page is being included onto another page.\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/img.mdwn:2
msgid "The `img` directive is supplied by the [[!iki plugins/img desc=img]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/img.mdwn:7
msgid ""
"This is an image handling directive.  While ikiwiki supports inlining "
"full-size images by making a [[ikiwiki/WikiLink]] that points to the image, "
"using this directive you can easily scale down an image for inclusion onto a "
"page, providing a link to a full-size version."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/img.mdwn:11
#, no-wrap
msgid "\t\\[[!img image1.jpg size=\"200x200\" alt=\"clouds\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/img.mdwn:14
msgid ""
"The image file will be searched for using the same rules as used to find the "
"file pointed to by a [[ikiwiki/WikiLink]]."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/img.mdwn:20
msgid ""
"The `size` parameter is optional, defaulting to full size. Note that the "
"original image's aspect ratio is always preserved, even if this means making "
"the image smaller than the specified size. You can also specify only the "
"width or the height, and the other value will be calculated based on it: "
"\"200x\", \"x200\""
msgstr ""

#. type: Plain text
#: ikiwiki/directive/img.mdwn:25
msgid ""
"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:30
msgid ""
"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: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:38
#, no-wrap
msgid ""
"\t\\[[!img defaults size=200x200 alt=\"wedding photo\"]]\n"
"\t\\[[!img photo1.jpg]]\n"
"\t\\[[!img photo2.jpg]]\n"
"\t\\[[!img photo3.jpg size=200x600]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:2
msgid ""
"The `inline` directive is supplied by the [[!iki plugins/inline "
"desc=inline]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:5
msgid ""
"This is a directive that allows including one wiki page inside another.  The "
"most common use of inlining is generating blogs and RSS or Atom feeds."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:9
#, no-wrap
msgid ""
"\t\\[[!inline pages=\"blog/* and !*/Discussion\" show=\"10\" "
"rootpage=\"blog\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:15
msgid ""
"Any pages that match the specified [[PageSpec]] (in the example, any "
"[[SubPage]] of \"blog\") will be part of the blog, and the newest 10 of them "
"will appear in the page. Note that if files that are not pages match the "
"[[PageSpec]], they will be included in the feed using RSS enclosures, which "
"is useful for podcasting."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:19
msgid ""
"The optional `rootpage` parameter tells the wiki that new posts to this blog "
"should default to being [[SubPages|SubPage]] of \"blog\", and enables a form "
"at the top of the blog that can be used to add new items."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:22
msgid ""
"If you want your blog to have an archive page listing every post ever made "
"to it, you can accomplish that like this:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:24
#, no-wrap
msgid "\t\\[[!inline pages=\"blog/* and !*/Discussion\" archive=\"yes\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:27
msgid ""
"You can even create an automatically generated list of all the pages on the "
"wiki, with the most recently added at the top, like this:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:29
#, no-wrap
msgid "\t\\[[!inline pages=\"* and !*/Discussion\" archive=\"yes\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:34
msgid ""
"If you want to be able to add pages to a given blog feed by tagging them, "
"you can do that too. To tag a page, just make it link to a page or pages "
"that represent its tags. Then use the special `link()` [[PageSpec]] to match "
"all pages that have a given tag:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:36
#, no-wrap
msgid "\t\\[[!inline pages=\"link(life)\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:38
msgid "Or include some tags and exclude others:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:40
#, no-wrap
msgid "\t\\[[!inline pages=\"link(debian) and !link(social)\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:45
msgid ""
"There are many parameters you can use with the `inline` directive. These are "
"the commonly used ones:"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid "`pages` - A [[PageSpec]] of the pages to inline."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid ""
"`show` - Specify the maximum number of matching pages to inline.  Default is "
"10, unless archiving, when the default is to show all.  Set to 0 to show all "
"matching pages."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid ""
"`archive` - If set to \"yes\", only list page titles and some metadata, not "
"full contents."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid ""
"`description` - Sets the description of the rss feed if one is generated.  "
"Defaults to the name of the wiki."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid ""
"`skip` - Specify a number of pages to skip displaying. Can be useful to "
"produce a feed that only shows archived pages."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid "`postform` - Set to \"yes\" to enable a form to post new pages to a blog."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid "`postformtext` - Set to specify text that is displayed in a postform."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:62
msgid ""
"`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 ""

#. type: Plain text
#: ikiwiki/directive/inline.mdwn:64
msgid "Here are some less often needed parameters:"
msgstr ""

#. type: Bullet: '* '
#: 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 "
"itself)."
msgstr ""

#. type: Bullet: '* '
#: 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 "
"configured to `allowrss`, set to \"yes\" to enable."
msgstr ""

#. type: Bullet: '* '
#: 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 "
"configured to `allowatom`, set to \"yes\" to enable."
msgstr ""

#. type: Bullet: '* '
#: 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: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 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: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 "
"it, as if it were a literal part of the source of the inlining page."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`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:117
msgid "`reverse` - If set to \"yes\", causes the sort order to be reversed."
msgstr ""

#. type: Bullet: '* '
#: 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:117
msgid ""
"`feedonly` - Only generate the feed, do not display the pages inline on the "
"page."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/inline.mdwn:117
msgid ""
"`quick` - Build archives in quick mode, without reading page contents for "
"metadata. This also turns off generation of any feeds."
msgstr ""

#. type: Bullet: '* '
#: 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: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 "
"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: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:121
msgid ""
"A related directive is the [[ikiwiki/directive/edittemplate]] directive, "
"which allows default text for a new page to be specified."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/linkmap.mdwn:2
msgid ""
"The `linkmap` directive is supplied by the [[!iki plugins/linkmap "
"desc=linkmap]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/linkmap.mdwn:5
msgid ""
"This directive uses [graphviz](http://www.graphviz.org/) to generate a graph "
"showing the links between a set of pages in the wiki. Example usage:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/linkmap.mdwn:7
#, no-wrap
msgid "\t\\[[!linkmap pages=\"* and !blog/* and !*/Discussion\"]]\n"
msgstr ""

#. type: Plain text
#: 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."
msgstr ""

#. type: Plain text
#: 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:22
msgid "`pages` - A [[ikiwiki/PageSpec]] of the pages to map."
msgstr ""

#. type: Bullet: '* '
#: 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 ""
"The `listdirectives` directive is supplied by the [[!iki "
"plugins/listdirectives desc=listdirectives]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/listdirectives.mdwn:5
msgid ""
"This directive generates a list of available "
"[[directives|ikiwiki/directive]]."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/listdirectives.mdwn:7
#, no-wrap
msgid "\t\\[[!listdirectives]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/listdirectives.mdwn:14
msgid ""
"There is one optional keyword argument, `generated`.  Normally the "
"`listdirectives` directive will list all built in directives and directives "
"directly registered by plugins.  With this keyword, `listdirectives` will "
"also list directives generated later.  For example, all [[shortcuts]] are "
"directives generated in turn by the `shortcut` directive.  They will only be "
"listed if the `generated` argument is supplied."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/listdirectives.mdwn:16
#, no-wrap
msgid "    \\[[!listdirectives generated]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/listdirectives.mdwn:19
msgid ""
"This extended list is often quite long, and often contains many undocumented "
"directives."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/map.mdwn:2
msgid "The `map` directive is supplied by the [[!iki plugins/map desc=map]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/map.mdwn:4
msgid ""
"This directive generates a hierarchical page map for the wiki. Example "
"usage:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/map.mdwn:6
#, no-wrap
msgid "\t\\[[!map pages=\"* and !blog/* and !*/Discussion\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/map.mdwn:9
msgid ""
"If the pages to include are not specified, all pages (and other files) in "
"the wiki are mapped."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/map.mdwn:13
msgid ""
"By default, the names of pages are shown in the map. The `show` parameter "
"can be used to show the titles or descriptions of pages instead (as set by "
"the [[meta]] directive). For example:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/map.mdwn:15
#, no-wrap
msgid "\t\\[[!map pages=\"* and !blog/* and !*/Discussion\" show=title]]\n"
msgstr ""

#. type: Plain text
#: 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 !*/*/*\"`"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:2
msgid ""
"The `meta` directive is supplied by the [[!iki plugins/meta desc=meta]] "
"plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:5
msgid ""
"This directive allows inserting arbitrary metadata into the source of a "
"page.  Enter the metadata as follows:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:8
#, no-wrap
msgid ""
"\t\\[[!meta field=\"value\"]]\n"
"\t\\[[!meta field=\"value\" param=\"value\" param=\"value\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:11
msgid ""
"The first form sets a given field to a given value, while the second form "
"also specifies some additional sub-parameters."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:14
msgid ""
"The field values are treated as HTML entity-escaped text, so you can include "
"a quote in the text by writing `&quot;` and so on."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:16
msgid "Supported fields:"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:18
msgid "title"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:21
#, no-wrap
msgid ""
"  Overrides the title of the page, which is generally the same as the\n"
"  page name.\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:25
#, no-wrap
msgid ""
"  Note that if the title is overridden, a \"title_overridden\" variable "
"will\n"
"  be set to a true value in the template; this can be used to format "
"things\n"
"  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:34
msgid "license"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:37
#, no-wrap
msgid ""
"  Specifies a license for the page, for example, \"GPL\". Can contain\n"
"  WikiLinks and arbitrary markup.\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:39
msgid "copyright"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:42
#, no-wrap
msgid ""
"  Specifies the copyright of the page, for example, \"Copyright 2007 by\n"
"  Joey Hess\". Can contain WikiLinks and arbitrary markup.\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:44
msgid "author"
msgstr ""

#. type: Plain text
#: 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:53
msgid "authorurl"
msgstr ""

#. type: Plain text
#: 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:57
msgid "description"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:60
#, no-wrap
msgid ""
"  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:62
msgid "permalink"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:65
#, no-wrap
msgid ""
"  Specifies a permanent link to the page, if different than the page\n"
"  generated by ikiwiki.\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:67
msgid "date"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:70
#, no-wrap
msgid ""
"  Specifies the creation date of the page. The date can be entered in\n"
"  nearly any format, since it's parsed by [[!cpan TimeDate]].\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:72
msgid "stylesheet"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:76
#, no-wrap
msgid ""
"  Adds a stylesheet to a page. The stylesheet is treated as a wiki link to\n"
"  a `.css` file in the wiki, so it cannot be used to add links to external\n"
"  stylesheets. Example:\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:79
#, no-wrap
msgid ""
"\t\\[[!meta stylesheet=somestyle rel=\"alternate stylesheet\"\n"
"\ttitle=\"somestyle\"]]\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:81
msgid "openid"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:84
#, no-wrap
msgid ""
"  Adds html &lt;link&gt; tags to perform OpenID delegation to an external\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:93
#, no-wrap
msgid "  Example:\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:97
#, no-wrap
msgid ""
"\t\\\\[[!meta openid=\"http://joeyh.myopenid.com/\"\n"
"\tserver=\"http://www.myopenid.com/server\"\n"
"\txrds-location=\"http://www.myopenid.com/xrds?username=joeyh.myopenid.com\"\"]]\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:99
msgid "link"
msgstr ""

#. type: Plain text
#: 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"
"  wiki treat one page as linking to another without displaying a "
"user-visible\n"
"  [[ikiwiki/WikiLink]]:\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:105
#, no-wrap
msgid "       \\[[!meta link=otherpage]]\n"
msgstr ""

#. type: Plain text
#: 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:109
#, no-wrap
msgid ""
"       \\[[!meta link=\"http://joeyh.myopenid.com/\" "
"rel=\"openid.delegate\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:113 ikiwiki/directive/meta.mdwn:130
#, no-wrap
msgid ""
"  However, this latter syntax won't be allowed if the \n"
"  [[!iki plugins/htmlscrubber desc=htmlscrubber]] plugin is enabled, since "
"it can be used to\n"
"  insert unsafe content.\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:115
msgid "redir"
msgstr ""

#. type: Plain text
#: 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:119
#, no-wrap
msgid "  \t\\[[!meta redir=otherpage]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:122
#, no-wrap
msgid ""
"  Optionally, a delay (in seconds) can be specified. The default is to\n"
"  redirect without delay.\n"
msgstr ""

#. type: Plain text
#: 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:126
#, no-wrap
msgid "  \t\\[[!meta redir=\"http://example.com/\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:133
#, no-wrap
msgid ""
"  For both cases, an anchor to jump to inside the destination page may also "
"be\n"
"  specified using the common `#ANCHOR` syntax.\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/meta.mdwn:135
msgid "robots"
msgstr ""

#. type: Plain text
#: 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:139
#, no-wrap
msgid "        \\[[!meta robots=\"index, nofollow\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:144
#, no-wrap
msgid ""
"  Valid values for the attribute are: \"index\", \"noindex\", \"follow\", "
"and\n"
"  \"nofollow\". Multiple comma-separated values are allowed, but obviously "
"only\n"
"  some combinations make sense. If there is no robots meta tag, \"index,\n"
"  follow\" is used as the default.\n"
msgstr ""

#. type: Plain text
#: 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:148
msgid "guid"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:154
#, no-wrap
msgid ""
"  Specifies a globally unique ID for a page. This guid should be a URI\n"
"  (in particular, it can be `urn:uuid:` followed by a UUID, as per\n"
"  [[!rfc 4122]]), and it will be used to identify the page's entry in RSS\n"
"  and Atom feeds. If not given, the default is to use the page's URL as "
"its\n"
"  guid.\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/meta.mdwn:158
#, no-wrap
msgid ""
"  This is mostly useful when a page has moved, to keep the guids for\n"
"  pages unchanged and avoid_flooding_aggregators\n"
"  (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: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 "
"won't be allowed if the [[!iki plugins/htmlscrubber desc=htmlscrubber]] "
"plugin is enabled, since it can be used to insert unsafe content."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/more.mdwn:2
msgid ""
"The `more` directive is supplied by the [[!iki plugins/more desc=more]] "
"plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/more.mdwn:5
msgid ""
"This directive provides a way to have a \"more\" link on a post in a blog, "
"that leads to the full version of the page. Use it like this:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/more.mdwn:6
#, no-wrap
msgid "\t\\[[!more linktext=\"click for more\" text=\"\"\"\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/more.mdwn:10
#, no-wrap
msgid ""
"\tThis is the rest of my post. Not intended for people catching up on\n"
"\ttheir blogs at 30,000 feet. Because I like to make things\n"
"\tdifficult.\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/more.mdwn:13
msgid "If the `linktext` parameter is omitted it defaults to just \"more\"."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/more.mdwn:15
msgid "Note that you can accomplish something similar using a [[toggle]] instead."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/orphans.mdwn:2
msgid ""
"The `orphans` directive is supplied by the [[!iki plugins/orphans "
"desc=orphans]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/orphans.mdwn:5
msgid ""
"This directive generates a list of possibly orphaned pages -- pages that no "
"other page links to. Example:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/orphans.mdwn:7
#, no-wrap
msgid "\t\\[[!orphans pages=\"* and !blog/*\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/orphans.mdwn:10
msgid ""
"The optional parameter \"pages\" can be a [[ikiwiki/PageSpec]] specifying "
"the pages to check for orphans, default is search them all."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/orphans.mdwn:14
msgid ""
"Note that it takes backlinks into account, but does not count inlining a "
"page as linking to it, so will generally count many blog-type pages as "
"orphans."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/pagecount.mdwn:2
msgid ""
"The `pagecount` directive is supplied by the [[!iki plugins/pagecount "
"desc=pagecount]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/pagecount.mdwn:4
msgid "This directive counts pages currently in the wiki. Example:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/pagecount.mdwn:6
#, no-wrap
msgid "\t\\[[!pagecount pages=\"*\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/pagecount.mdwn:9
msgid ""
"The optional parameter \"pages\" can be a [[ikiwiki/PageSpec]] specifying "
"the pages to count, default is to count them all."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/pagestats.mdwn:2
msgid ""
"The `pagestats` directive is supplied by the [[!iki plugins/pagestats "
"desc=pagestats]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/pagestats.mdwn:6
msgid ""
"This directive can generate stats about how pages link to each other. It can "
"produce either a tag cloud, or a table counting the number of links to each "
"page."
msgstr ""

#. type: Plain text
#: 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:11
#, no-wrap
msgid "\t\\[[!pagestats pages=\"tags/*\"]]\n"
msgstr ""

#. type: Plain text
#: 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: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 "
"desc=pagetemplate]] plugin."
msgstr ""

#. type: Plain text
#: 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 ""
"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 "
"_into_ the body of a page."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/pagetemplate.mdwn:12
#, no-wrap
msgid "\t\\[[!pagetemplate template=\"my_fancy.tmpl\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/ping.mdwn:2
msgid ""
"The `ping` directive is supplied by the [[!iki plugins/pinger desc=pinger]] "
"plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/ping.mdwn:8
msgid ""
"This directive allows ikiwiki to be configured to hit a URL each time it "
"updates the wiki. One way to use this is in conjunction with the [[!iki "
"plugins/pingee desc=pingee]] plugin to set up a loosely coupled mirror "
"network, or a branched version of a wiki. By pinging the mirror or branch "
"each time the main wiki changes, it can be kept up-to-date."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/ping.mdwn:11
#, no-wrap
msgid ""
"        \\[[!ping from=\"http://mywiki.com/\"\n"
"        to=\"http://otherwiki.com/ikiwiki.cgi?do=ping\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/ping.mdwn:14
msgid ""
"The \"from\" parameter must be identical to the url of the wiki that is "
"doing the pinging. This is used to prevent ping loops."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/ping.mdwn:17
msgid ""
"The \"to\" parameter is the url to ping. The example shows how to ping "
"another ikiwiki instance."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/poll.mdwn:2
msgid ""
"The `poll` directive is supplied by the [[!iki plugins/poll desc=poll]] "
"plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/poll.mdwn:5
msgid ""
"This directive allows you to create online polls in the wiki. Here's an "
"example use:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/poll.mdwn:7
#, no-wrap
msgid "\t\\[[!poll 0 \"red\" 0 \"green\" 0 \"blue\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/poll.mdwn:11
msgid ""
"The numbers indicate how many users voted for that choice. When a user votes "
"for a choice in the poll, the page is modified and the number incremented."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/poll.mdwn:17
msgid ""
"While some basic precautions are taken to prevent users from accidentially "
"voting twice, this sort of poll should not be counted on to be very "
"accurate; all the usual concerns about web based polling apply. Unless the "
"page that the poll is in is locked, users can even edit the page and change "
"the numbers!"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/poll.mdwn:19
msgid "Parameters:"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/poll.mdwn:24
msgid ""
"`open` - Whether voting is still open. Set to \"no\" to close the poll to "
"voting."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/poll.mdwn:24
msgid "`total` - Show total number of votes at bottom of poll. Default is \"yes\"."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/poll.mdwn:24
msgid "`percent` - Whether to display percents. Default is \"yes\"."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/polygen.mdwn:2
msgid ""
"The `polygen` directive is supplied by the [[!iki plugins/polygen "
"desc=polygen]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/polygen.mdwn:5
msgid ""
"This directive allows inserting text generated by polygen into a wiki page.  "
"For example:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/polygen.mdwn:7
#, no-wrap
msgid "\t\\[[!polygen grammar=\"genius\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/polygen.mdwn:10
msgid ""
"It's also possible to specify a starting nonterminal for the grammar by "
"including `symbol=\"text\"` in the directive."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:2
msgid ""
"The `postsparkline` directive is supplied by the [[!iki "
"plugins/postsparkline desc=postsparkline]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:5
msgid ""
"This directive uses the [[!iki plugins/sparkline desc=sparkline]] plugin to "
"create a [[sparkline]] of statistics about a set of pages, such as posts to "
"a blog."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:11
#, no-wrap
msgid ""
"\tPost interval: \n"
"\t\\[[!postsparkline pages=\"blog/* and !*/Discussion\" max=100\n"
"\tformula=interval style=bar barwidth=2 barspacing=1 height=13]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:15
#, no-wrap
msgid ""
"\tPosts per month this year: \n"
"\t\\[[!postsparkline pages=\"blog/* and !*/Discussion\" max=12\n"
"\tformula=permonth style=bar barwidth=2 barspacing=1 height=13]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:20
msgid ""
"All options aside from the `pages`, `max`, `formula`, `time`, and `color` "
"options are the same as in [[sparkline]] directive."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:25
msgid ""
"You don't need to specify any data points (though you can if you want to).  "
"Instead, data points are automatically generated based on the creation times "
"of pages matched by the specified `pages` [[ikiwiki/PageSpec]]. A maximum of "
"`max` data points will be generated."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:28
msgid ""
"The `formula` parameter controls the formula used to generate data points.  "
"Available formulae:"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/postsparkline.mdwn:37
msgid ""
"`interval` - The height of each point represents how long it has been since "
"the previous post."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/postsparkline.mdwn:37
msgid ""
"`perday` - Each point represents a day; the height represents how many posts "
"were made that day."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/postsparkline.mdwn:37
msgid ""
"`permonth` - Each point represents a month; the height represents how many "
"posts were made that month."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/postsparkline.mdwn:37
msgid ""
"`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 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 ""

#. type: Plain text
#: ikiwiki/directive/postsparkline.mdwn:44
msgid ""
"To change the color used to draw the sparkline, use the `color` parameter.  "
"For example, \"color=red\"."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/progress.mdwn:2
msgid ""
"The `progress` directive is supplied by the [[!iki plugins/progress "
"desc=progress]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/progress.mdwn:4
msgid "This directive generates a progress bar."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/progress.mdwn:7
msgid ""
"There are two possible parameter sets.  The first is a single parameter "
"\"percent\" which holds a percentage figure of how complete the progress bar "
"is."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/progress.mdwn:12
msgid ""
"The second possible set of parameters is a pair of [[ikiwiki/PageSpec]]s, "
"`totalpages` and `donepages`. The directive counts the number of pages in "
"each pagespec and shows the percentage of the total pages that are done."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/progress.mdwn:15
msgid "For example, to show what percentage of pages have discussion pages:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/progress.mdwn:17
#, no-wrap
msgid ""
"\t\\[[!progress totalpages=\"* and !*/Discussion\" "
"donepages=\"*/Discussion\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/shortcut.mdwn:2
msgid ""
"The `shortcut` directive is supplied by the [[!iki plugins/shortcut "
"desc=shortcut]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/shortcut.mdwn:5
msgid ""
"This directive allows external links to commonly linked to sites to be made "
"more easily using shortcuts."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/shortcut.mdwn:8
msgid ""
"The available shortcuts are defined on the [[shortcuts]] page in the "
"wiki. The `shortcut` directive can only be used on that page."
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 "
"desc=sparkline]] plugin."
msgstr ""

#. type: Plain text
#: 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 displayed "
"alongside text."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:11
#, no-wrap
msgid ""
"\t\\[[!sparkline 1 3 5 -3 10 0 width=40 height=16\n"
"\tfeaturepoint=\"4,-3,red,3\" featurepoint=\"5,10,green,3\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:15
msgid ""
"This creates a simple line graph, graphing several points.  It will be drawn "
"40 pixels wide and 16 pixels high. The high point in the line has a green "
"marker, and the low point has a red marker."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:18
#, no-wrap
msgid ""
"\t\\[[!sparkline 1 -1(red) 1 -1(red) 1 1 1 -1(red) -1(red) style=bar "
"barwidth=2\n"
"\tbarspacing=1 height=13]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:23
msgid ""
"This more complex example generates a bar graph.  The bars are 2 pixels "
"wide, and separated by one pixel, and the graph is 13 pixels tall. Width is "
"determined automatically for bar graphs. The points with negative values are "
"colored red, instead of the default black."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:28
msgid ""
"The form for the data points is \"x,y\", or just \"y\" if the x values don't "
"matter. Bar graphs can also add \"(color)\" to specify a color for that bar."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:32
msgid ""
"The following named parameters are recognised. Most of these are the same as "
"those used by the underlying sparkline library, which is documented in more "
"detail in [its wiki](http://sparkline.wikispaces.com/usage)."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/sparkline.mdwn:44
msgid "`style` - Either \"line\" (the default) or \"bar\"."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/sparkline.mdwn:44
msgid "`width` - Width of the graph in pixels. Only needed for line graphs."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/sparkline.mdwn:44
msgid "`height` - Height of the graph in pixels. Defaults to 16."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/sparkline.mdwn:44
msgid "`barwidth` - Width of bars in a bar graph. Default is 1 pixel."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/sparkline.mdwn:44
msgid ""
"`barspacing` - Spacing between bars in a bar graph, in pixels. Default is 1 "
"pixel."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/sparkline.mdwn:44
msgid ""
"`ymin`, `ymax` - Minimum and maximum values for the Y axis. This is normally "
"calculated automatically, but can be explicitly specified to get the same "
"values for multiple related graphs."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/sparkline.mdwn:44
msgid ""
"`featurepoint` - Adds a circular marker to a line graph, with optional "
"text. This can be used to label significant points."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:48
#, no-wrap
msgid ""
"  The value is a comma-delimited list of parameters specifying the feature\n"
"  point: X value, Y value, color name, circle diameter, text (optional),\n"
"  and text location (optional). Example: `featurepoint=\"3,5,blue,3\"`\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/sparkline.mdwn:51
#, no-wrap
msgid ""
"  Available values for the text location are: \"top\", \"right\", "
"\"bottom\", and\n"
"  \"left\".\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:2
msgid ""
"The `table` directive is supplied by the [[!iki plugins/table desc=table]] "
"plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:5
msgid ""
"This directive can build HTML tables from data in CSV (comma-separated "
"values)  or DSV (delimiter-separated values) format."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:8 ikiwiki/directive/table.mdwn:26
#, no-wrap
msgid "\t\\[[!table data=\"\"\"\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:13
#, no-wrap
msgid ""
"\tCustomer |Amount\n"
"\tFulanito |134,34\n"
"\tMenganito|234,56\n"
"\tMenganito|234,56\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:16
#, no-wrap
msgid ""
"\t\\[[!table class=\"book_record\" format=csv "
"file=\"data/books/record1\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:18
msgid "In this second example the `record1` page should be similar to:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:22
#, no-wrap
msgid ""
"\t\"Title\",\"Perl Best Practices\"\n"
"\t\"Author\",\"Damian Conway\"\n"
"\t\"Publisher\",\"O’Reilly\"\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:25
msgid ""
"To make a cell span multiple columns, follow it with one or more empty "
"cells. For example:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:30
#, no-wrap
msgid ""
"\tleft||right|\n"
"\ta|b|c|d\n"
"\tthis cell spans 4 columns|||\n"
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/table.mdwn:44
msgid "`data` - Values for the table."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/table.mdwn:44
msgid "`file` - A file in the wiki containing the data."
msgstr ""

#. type: Bullet: '* '
#: ikiwiki/directive/table.mdwn:44
msgid ""
"`format` - The format of the data, either \"csv\", \"dsv\", or \"auto\" (the "
"default)."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/table.mdwn:44
#, no-wrap
msgid ""
"* `delimiter` - The character used to separate fields. By default,\n"
"   DSV format uses a pipe (`|`), and CSV uses a comma (`,`).\n"
"* `class` - A CSS class for the table html element.\n"
"* `header` - By default, or if set to \"row\", the first data line is used\n"
"  as the table header. Set it to \"no\" to make a table without a header, "
"or\n"
"  \"column\" to make the first column be the header.\n"
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 "
"desc=tag]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/tag.mdwn:4
msgid "These directives allow tagging pages. List tags as follows:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/tag.mdwn:6
#, no-wrap
msgid "\t\\[[!tag tech life linux]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/tag.mdwn:12
msgid ""
"The tags work the same as if you had put a (hidden) [[ikiwiki/WikiLink]] on "
"the page for each tag, so you can use a [[ikiwiki/PageSpec]] match all pages "
"that are tagged with a given tag, for example. The tags will also show up on "
"blog entries and at the bottom of the tagged pages, as well as in RSS and "
"Atom feeds."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/tag.mdwn:15
msgid ""
"If you want a visible [[ikiwiki/WikiLink]] along with the tag, use taglink "
"instead:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/tag.mdwn:18
#, no-wrap
msgid ""
"\t\\[[!taglink foo]]\n"
"\t\\[[!taglink tagged_as_foo|foo]]\n"
msgstr ""

#. type: Plain text
#: 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. 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: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:34
#, no-wrap
msgid ""
"\t\\[[!tag /foo]]\n"
"\t\\[[!taglink /foo]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/taglink.mdwn:1
#, no-wrap
msgid "[[!meta redir=/ikiwiki/directive/tag]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/template.mdwn:2
msgid ""
"The `template` directive is supplied by the [[!iki plugins/template "
"desc=template]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/template.mdwn:7
msgid ""
"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 "
"note.\"\"\"]]\n"
msgstr ""

#. type: Plain text
#: 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:25
msgid ""
"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
#: ikiwiki/directive/testpagespec.mdwn:2
msgid ""
"The `testpagespec` directive is supplied by the [[!iki plugins/testpagespec "
"desc=testpagespec]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/testpagespec.mdwn:5
msgid ""
"This directive allows testing a [[ikiwiki/PageSpec]] to see if it matches a "
"page, and to see the part that matches, or causes the match to fail."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/testpagespec.mdwn:7
msgid "Example uses:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/testpagespec.mdwn:9
#, no-wrap
msgid "\t\\[[!testpagespec pagespec=\"foopage and barpage\" match=\"foopage\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/testpagespec.mdwn:13
msgid ""
"This will print out something like \"no match: barpage does not match "
"foopage\", highlighting which part of the [[ikiwiki/PageSpec]] is causing "
"the match to fail."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/testpagespec.mdwn:15
#, no-wrap
msgid "\t\\[[!testpagespec pagespec=\"foopage or !bar*\" match=\"barpage\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/testpagespec.mdwn:18
msgid ""
"This will print out something like \"no match: bar* matches barpage\", since "
"the part of the [[ikiwiki/PageSpec]] that fails is this negated match."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/testpagespec.mdwn:20
#, no-wrap
msgid "\t\\[[!testpagespec pagespec=\"foopage or barpage\" match=\"barpage\"]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/testpagespec.mdwn:23
msgid ""
"This will print out something like \"match: barpage matches barpage\", "
"indicating the part of the [[ikiwiki/PageSpec]] that caused it to match."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/teximg.mdwn:2
msgid ""
"The `teximg` directive is supplied by the [[!iki plugins/teximg "
"desc=teximg]] plugin."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/teximg.mdwn:4
msgid "This directive renders LaTeX formulas into images."
msgstr ""

#. type: Plain text
#: ikiwiki/directive/teximg.mdwn:9
#, no-wrap
msgid ""
"\t\\[[!teximg code=\"\\frac{1}{2}\"]]\n"
"\t\\[[!teximg code=\"E = - \\frac{Z^2 \\cdot  \\mu \\cdot e^4}{32\\pi^2 "
"\\epsilon_0^2 \\hbar^2 n^2}\" ]]\n"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/teximg.mdwn:11
msgid "To scale the image, use height=x:"
msgstr ""

#. type: Plain text
#: ikiwiki/directive/teximg.mdwn:14
#, no-wrap
msgid ""
"\t\\[[!teximg code=\"\\frac{1}{2}\" height=\"17\"]]\n"
"\t\\[[!teximg code=\"\\frac{1}{2}\" height=\"8\"]]\n"
msgstr ""

#. type: Plain text