- # 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 2.62.1\n"
- "POT-Creation-Date: 2008-10-23 03:35+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:22 ikiwiki/directive/calendar.mdwn:26 ikiwiki/directive/img.mdwn:8 ikiwiki/directive/inline.mdwn:41 ikiwiki/directive/table.mdwn:32
- #, no-wrap
- msgid "## usage\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/aggregate.mdwn:26
- msgid ""
- "Here are descriptions of all the supported parameters to the `aggregate` "
- "directive:"
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/aggregate.mdwn:47
- msgid "`name` - A name for the feed. Each feed must have a unique name. Required."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/aggregate.mdwn:47
- msgid ""
- "`url` - The url to the web page for the feed that's being aggregated. "
- "Required."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/aggregate.mdwn:47
- 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
- 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
- msgid ""
- "`updateinterval` - How often to check for new posts, in minutes. Default is "
- "15 minutes."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/aggregate.mdwn:47
- 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
- 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:47
- 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:47
- msgid ""
- "`template` - Template to use for creating the aggregated pages. Defaults to "
- "aggregatepost."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/aggregate.mdwn:51
- 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: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
- #, 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/inline.mdwn:7 ikiwiki/directive/template.mdwn:9
- 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:3
- 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."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/calendar.mdwn:6
- 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
- #, no-wrap
- msgid "# examples\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/calendar.mdwn:10
- #, no-wrap
- msgid "\t\\[[!calendar ]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/calendar.mdwn:12
- #, no-wrap
- msgid "\t\\[[!calendar type=\"month\" pages=\"blog/* and !*/Discussion\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/calendar.mdwn:14
- #, no-wrap
- msgid ""
- "\t\\[[!calendar type=\"year\" year=\"2005\" pages=\"blog/* and "
- "!*/Discussion\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/calendar.mdwn:18
- 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."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/calendar.mdwn:25
- 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."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/calendar.mdwn:45
- 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
- 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
- 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."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/calendar.mdwn:45
- msgid ""
- "`year` - The year for which the calendar is requested. Defaults to the "
- "current year."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/calendar.mdwn:45
- 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."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/calendar.mdwn:45
- 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:45
- msgid ""
- "`months_per_row` - In the annual 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: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 "
- "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/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/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"
- "similar to 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 "
- "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/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:24
- 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."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/img.mdwn:29
- 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 "
- "\"link=http://url\" to link to a given url."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/img.mdwn:32
- 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
- #, 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` - Enable 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:105
- 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:105
- 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:105
- 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:105
- 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
- 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."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/inline.mdwn:105
- 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:105
- 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."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/inline.mdwn:105
- msgid "`reverse` - If set to \"yes\", causes the sort order to be reversed."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/inline.mdwn:105
- 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
- msgid ""
- "`feedonly` - Only generate the feed, do not display the pages inline on the "
- "page."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/inline.mdwn:105
- msgid ""
- "`quick` - Build archives in quick mode, without reading page contents for "
- "metadata. By default, this also turns off generation of any feeds."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/inline.mdwn:105
- 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
- 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 "
- "specifying a tighter [[PageSpec]] here."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/inline.mdwn:105
- 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: Plain text
- #: ikiwiki/directive/inline.mdwn:109
- 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:15
- 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."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/linkmap.mdwn:18
- msgid ""
- "Here are descriptions of all the supported parameters to the `linkmap` "
- "directive:"
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/linkmap.mdwn:23
- msgid "`pages` - A [[ikiwiki/PageSpec]] of the pages to map."
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/linkmap.mdwn:23
- 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: 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:18
- 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 `"` 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: Bullet: '* '
- #: ikiwiki/directive/meta.mdwn:27
- msgid "license"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:30
- #, 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:32
- msgid "copyright"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:35
- #, 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:37
- msgid "author"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:39
- #, no-wrap
- msgid " Specifies the author of a page.\n"
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/meta.mdwn:41
- msgid "authorurl"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:43
- #, no-wrap
- msgid " Specifies an url for the author of a page.\n"
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/meta.mdwn:45
- msgid "description"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:48
- #, 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"
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/meta.mdwn:50
- msgid "permalink"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:53
- #, 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:55
- msgid "date"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:58
- #, 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:60
- msgid "stylesheet"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:64
- #, 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:67
- #, no-wrap
- msgid ""
- "\t\\[[!meta stylesheet=somestyle rel=\"alternate stylesheet\"\n"
- "\ttitle=\"somestyle\"]]\n"
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/meta.mdwn:69
- msgid "openid"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:74
- #, 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"
- " 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
- #, no-wrap
- msgid " This lets you use an ikiwiki page as your OpenID. Example:\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:80
- #, 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:82
- msgid "link"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:86
- #, 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:88
- #, no-wrap
- msgid " \\[[!meta link=otherpage]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:90
- #, 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
- #, no-wrap
- msgid ""
- " \\[[!meta link=\"http://joeyh.myopenid.com/\" "
- "rel=\"openid.delegate\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:96 ikiwiki/directive/meta.mdwn:113
- #, 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:98
- msgid "redir"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:100
- #, no-wrap
- msgid " Causes the page to redirect to another page in the wiki.\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:102
- #, no-wrap
- msgid " \t\\[[!meta redir=otherpage]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:105
- #, 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:107
- #, 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
- #, no-wrap
- msgid " \t\\[[!meta redir=\"http://example.com/\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:116
- #, 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:118
- msgid "robots"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:120
- #, no-wrap
- msgid " Causes the robots meta tag to be written:\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:122
- #, no-wrap
- msgid " \\[[!meta robots=\"index, nofollow\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:127
- #, 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:129
- #, no-wrap
- msgid " The value is escaped, but its contents are not otherwise checked.\n"
- msgstr ""
- # type: Bullet: '* '
- #: ikiwiki/directive/meta.mdwn:131
- msgid "guid"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/meta.mdwn:137
- #, 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:141
- #, 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: Plain text
- #: ikiwiki/directive/meta.mdwn:146
- 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 "
- "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:8
- msgid "Here's how to use it to create a [[tag]] cloud:"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/pagestats.mdwn:10
- #, no-wrap
- msgid "\t\\[[!pagestats pages=\"tags/*\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/pagestats.mdwn:12
- 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
- #, no-wrap
- msgid "\t\\[[!pagestats style=\"table\"]]\n"
- 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:8
- 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 "
- "_into_ the body of a page."
- 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 ""
- # 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: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` "
- "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 forumlae:"
- 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 day; 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 "
- "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/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 displayes "
- "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/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:23
- 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."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/tag.mdwn:26
- 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
- #, 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 ""
- "[[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."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/template.mdwn:11
- #, 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:14
- 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: Plain text
- #: ikiwiki/directive/template.mdwn:17
- msgid ""
- "For a list of available templates, and details about how to create more, see "
- "the [[templates]] page."
- 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
- #: ikiwiki/directive/teximg.mdwn:18
- msgid ""
- "If no height is choosen 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 ""
- # type: Plain text
- #: ikiwiki/directive/teximg.mdwn:20
- msgid "To add an alt text to the image, use alt=\"text\":"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/teximg.mdwn:22
- #, no-wrap
- msgid "\t\\[[!teximg code=\"\\frac{1}{2}\" alt=\"1/2\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toc.mdwn:2
- msgid "The `toc` directive is supplied by the [[!iki plugins/toc desc=toc]] plugin."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toc.mdwn:4
- msgid "Add a table of contents to a page:"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toc.mdwn:6
- #, no-wrap
- msgid "\t\\[[!toc ]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toc.mdwn:11
- msgid ""
- "The table of contents will be automatically generated based on the headers "
- "of the page. By default only the largest headers present on the page will be "
- "shown; to control how many levels of headers are shown, use the `levels` "
- "parameter:"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toc.mdwn:13
- #, no-wrap
- msgid "\t\\[[!toc levels=2]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toc.mdwn:16
- msgid ""
- "The toc directive will take the level of the first header as the topmost "
- "level, even if there are higher levels seen later in the file."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toc.mdwn:20
- 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."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:2
- msgid ""
- "The `toggle` and `toggleable` directives are supplied by the [[!iki "
- "plugins/toggle desc=toggle]] plugin."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:5
- msgid ""
- "With these directives you can create links on pages that, when clicked, "
- "toggle display of other parts of the page."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:8
- msgid ""
- "It uses javascript to accomplish this; browsers without javascript will "
- "always see the full page content."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:10
- msgid "Example use:"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:12
- #, no-wrap
- msgid "\t\\[[!toggle id=\"ipsum\" text=\"show\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:13
- #, no-wrap
- msgid "\t\\[[!toggleable id=\"ipsum\" text=\"\"\"\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:18
- #, no-wrap
- msgid ""
- "\tLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do\n"
- "\teiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim\n"
- "\tad minim veniam, quis nostrud exercitation ullamco laboris nisi ut\n"
- "\taliquip ex ea commodo consequat.\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:19
- #, no-wrap
- msgid "\t[[!toggle id=\"ipsum\" text=\"hide\"]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:24
- msgid ""
- "Note that you can include wiki markup in the toggleable text, including even "
- "additional toggles, as shown in the above example."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:28
- msgid ""
- "Also, the toggle and the togglable definitions do not need to be next to "
- "each other, but can be located anywhere on the page. There can also be "
- "mutiple toggles that all toggle a single togglable."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:30
- msgid ""
- "The id has a default value of \"default\", so can be omitted in simple "
- "cases."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggle.mdwn:33
- msgid ""
- "If you'd like a toggleable to be displayed by default, and toggle to hidden, "
- "then pass a parameter \"open=yes\" when setting up the toggleable."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/toggleable.mdwn:1
- #, no-wrap
- msgid "[[!meta redir=/ikiwiki/directive/toggle]]\n"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/version.mdwn:2
- msgid ""
- "The `version` directive is supplied by the [[!iki plugins/version "
- "desc=version]] plugin."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/version.mdwn:4
- msgid "This directive allows inserting the version of ikiwiki onto a page."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/version.mdwn:7
- msgid ""
- "Whenever ikiwiki is upgraded to a new version, the page will be rebuilt, "
- "updating the version number."
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/version.mdwn:9
- msgid "Use is simple:"
- msgstr ""
- # type: Plain text
- #: ikiwiki/directive/version.mdwn:11
- #, no-wrap
- msgid "\t\\[[!version ]]\n"
- msgstr ""
|