diff options
Diffstat (limited to 'po/directives.pot')
| -rw-r--r-- | po/directives.pot | 1017 |
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 <link> 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 <link> 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 <meta> 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." |