jones/content - Unnamed repository; edit this file 'description' to name the repository.

summary refs log tree commit diff

path: root/info/sidebar.mdwn

diff options

Diffstat (limited to 'info/sidebar.mdwn')

0 files changed, 0 insertions, 0 deletions

AME <EMAIL@ADDRESS>\n"

"Language-Team: LANGUAGE <LL@li.org>\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=utf-8\n"

"Content-Transfer-Encoding: 8bit"

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:4

msgid ""

"The `aggregate` directive is supplied by the [[!iki plugins/aggregate "

"desc=aggregate]] plugin. This plugin requires extra setup, specifically, a "

"cron job. See the plugin's documentation for details."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:7

msgid ""

"This directive allows content from other feeds to be aggregated into the "

"wiki. Aggregate a feed as follows:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:11

#, no-wrap

msgid ""

"\t\\[[!aggregate name=\"example blog\" dir=\"example\"\n"

"\tfeedurl=\"http://example.com/index.rss\"\n"

"\turl=\"http://example.com/\" updateinterval=\"15\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:16

msgid ""

"That example aggregates posts from the specified RSS feed, updating no more "

"frequently than once every 15 minutes (though possibly less frequently, if "

"the cron job runs less frequently than that), and puts a page per post under "

"the example/ directory in the wiki."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:19

msgid ""

"You can then use ikiwiki's [[inline]] directive to create a blog of one or "

"more aggregated feeds. For example:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:21

#, no-wrap

msgid "\t\\[[!inline pages=\"internal(example/*)\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:26

msgid ""

"Note the use of `internal()` in the [[ikiwiki/PageSpec]] to match aggregated "

"pages. By default, aggregated pages are internal pages, which prevents them "

"from showing up directly in the wiki, and so this special [[PageSpec]] is "

"needed to match them."

msgstr ""

#. type: Title ##

#: ikiwiki/directive/aggregate.mdwn:27 ikiwiki/directive/calendar.mdwn:37 ikiwiki/directive/comment.mdwn:17 ikiwiki/directive/img.mdwn:8 ikiwiki/directive/inline.mdwn:41 ikiwiki/directive/postsparkline.mdwn:16 ikiwiki/directive/sparkline.mdwn:24 ikiwiki/directive/table.mdwn:32

#, no-wrap

msgid "usage"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:31

msgid ""

"Here are descriptions of all the supported parameters to the `aggregate` "

"directive:"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid "`name` - A name for the feed. Each feed must have a unique name. Required."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid ""

"`url` - The url to the web page for the feed that's being aggregated. "

"Required."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid ""

"`dir` - The directory in the wiki where pages should be saved. Optional, if "

"not specified, the directory is based on the name of the feed."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid ""

"`feedurl` - The url to the feed. Optional, if it's not specified ikiwiki "

"will look for feeds on the `url`. RSS and atom feeds are supported."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid ""

"`updateinterval` - How often to check for new posts, in minutes. Default is "

"15 minutes."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid ""

"`expireage` - Expire old items from this feed if they are older than a "

"specified number of days. Default is to never expire on age."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid ""

"`expirecount` - Expire old items from this feed if there are more than the "

"specified number total. Oldest items will be expired first. Default is to "

"never expire on count."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid ""

"`tag` - A tag to tag each post from the feed with. A good tag to use is the "

"name of the feed. Can be repeated multiple times. The [[tag]] plugin must be "

"enabled for this to work."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/aggregate.mdwn:52

msgid ""

"`template` - Template to use for creating the aggregated pages. Defaults to "

"aggregatepost."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:56

msgid ""

"Note that even if you are using subversion or another revision control "

"system, pages created by aggregation will *not* be checked into revision "

"control."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/aggregate.mdwn:57 ikiwiki/directive/brokenlinks.mdwn:14 ikiwiki/directive/calendar.mdwn:60 ikiwiki/directive/color.mdwn:25 ikiwiki/directive/comment.mdwn:40 ikiwiki/directive/copy.mdwn:3 ikiwiki/directive/cut.mdwn:3 ikiwiki/directive/cutpaste.mdwn:50 ikiwiki/directive/date.mdwn:16 ikiwiki/directive/edittemplate.mdwn:36 ikiwiki/directive/format.mdwn:29 ikiwiki/directive/fortune.mdwn:8 ikiwiki/directive/graph.mdwn:23 ikiwiki/directive/haiku.mdwn:15 ikiwiki/directive/if.mdwn:48 ikiwiki/directive/img.mdwn:39 ikiwiki/directive/inline.mdwn:118 ikiwiki/directive/linkmap.mdwn:29 ikiwiki/directive/listdirectives.mdwn:20 ikiwiki/directive/map.mdwn:21 ikiwiki/directive/meta.mdwn:173 ikiwiki/directive/more.mdwn:16 ikiwiki/directive/orphans.mdwn:15 ikiwiki/directive/pagecount.mdwn:10 ikiwiki/directive/pagestats.mdwn:40 ikiwiki/directive/pagetemplate.mdwn:13 ikiwiki/directive/paste.mdwn:3 ikiwiki/directive/ping.mdwn:18 ikiwiki/directive/poll.mdwn:25 ikiwiki/directive/polygen.mdwn:11 ikiwiki/directive/postsparkline.mdwn:45 ikiwiki/directive/progress.mdwn:18 ikiwiki/directive/shortcut.mdwn:9 ikiwiki/directive/sidebar.mdwn:20 ikiwiki/directive/sparkline.mdwn:52 ikiwiki/directive/table.mdwn:50 ikiwiki/directive/tag.mdwn:35 ikiwiki/directive/taglink.mdwn:3 ikiwiki/directive/template.mdwn:87 ikiwiki/directive/testpagespec.mdwn:24 ikiwiki/directive/teximg.mdwn:23 ikiwiki/directive/toc.mdwn:27 ikiwiki/directive/toggle.mdwn:34 ikiwiki/directive/toggleable.mdwn:3 ikiwiki/directive/version.mdwn:12

#, no-wrap

msgid "[[!meta robots=\"noindex, follow\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/brokenlinks.mdwn:2

msgid ""

"The `brokenlinks` directive is supplied by the [[!iki plugins/brokenlinks "

"desc=brokenlinks]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/brokenlinks.mdwn:6

msgid ""

"This directive generates a list of broken links on pages in the wiki. This "

"is a useful way to find pages that still need to be written, or links that "

"are written wrong."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/brokenlinks.mdwn:9

msgid ""

"The optional parameter \"pages\" can be a [[ikiwiki/PageSpec]] specifying "

"the pages to search for broken links, default is search them all."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/brokenlinks.mdwn:11 ikiwiki/directive/comment.mdwn:7 ikiwiki/directive/inline.mdwn:7

msgid "Example:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/brokenlinks.mdwn:13

#, no-wrap

msgid "\t\\[[!brokenlinks pages=\"* and !recentchanges\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:2

msgid ""

"The `calendar` directive is supplied by the [[!iki plugins/calendar "

"desc=calendar]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:5

msgid ""

"This directive displays a calendar, similar to the typical calendars shown "

"on some blogs."

msgstr ""

#. type: Title ##

#: ikiwiki/directive/calendar.mdwn:6 ikiwiki/directive/color.mdwn:9 ikiwiki/directive/postsparkline.mdwn:6 ikiwiki/directive/sidebar.mdwn:10 ikiwiki/directive/sparkline.mdwn:7 ikiwiki/directive/table.mdwn:6 ikiwiki/directive/teximg.mdwn:5

#, no-wrap

msgid "examples"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:9

#, no-wrap

msgid "\t\\[[!calendar ]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:11

#, no-wrap

msgid "\t\\[[!calendar type=\"month\" pages=\"blog/* and !*/Discussion\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:13

#, no-wrap

msgid ""

"\t\\[[!calendar type=\"year\" year=\"2005\" pages=\"blog/* and "

"!*/Discussion\"]]\n"

msgstr ""

#. type: Title ##

#: ikiwiki/directive/calendar.mdwn:14

#, no-wrap

msgid "setup"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:22

msgid ""

"The calendar is essentially a fancy front end to archives of previous pages, "

"usually used for blogs. It can produce a calendar for a given month, or a "

"list of months for a given year. The month format calendar simply links to "

"any page posted on each day of the month. The year format calendar links to "

"archive pages, with names like `archives/2007` (for all of 2007) and "

"`archives/2007/01` (for January, 2007)."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:27

msgid ""

"While you can insert calendar directives anywhere on your wiki, including in "

"the sidebar, you'll also need to create these archive pages. They typically "

"use this directive to display a calendar, and also use [[inline]] to display "

"or list pages created in the given time frame."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:32

msgid ""

"The `ikiwiki-calendar` command can be used to automatically generate the "

"archive pages. It also refreshes the wiki, updating the calendars to "

"highlight the current day. This command is typically run at midnight from "

"cron. An example crontab:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:34

msgid "An example crontab:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/calendar.mdwn:36

#, no-wrap

msgid "\t0 0 * * * ikiwiki-calendar ~/ikiwiki.setup \"posts/* and !*/Discussion\"\n"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/calendar.mdwn:59

msgid ""

"`type` - Used to specify the type of calendar wanted. Can be one of "

"\"month\" or \"year\". The default is a month view calendar."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/calendar.mdwn:59

msgid ""

"`pages` - Specifies the [[ikiwiki/PageSpec]] of pages to link to from the "

"month calendar. Defaults to \"*\"."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/calendar.mdwn:59

msgid ""

"`archivebase` - Configures the base of the archives hierarchy. The default "

"is \"archives\". Note that this default can also be overridden for the whole "

"wiki by setting `archivebase` in ikiwiki's setup file. Calendars link to "

"pages under here, with names like \"2010/04\" and \"2010\". These pages can "

"be automatically created using the `ikiwiki-calendar` program."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/calendar.mdwn:59

msgid ""

"`year` - The year for which the calendar is requested. Defaults to the "

"current year. Can also use -1 to refer to last year, and so on."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/calendar.mdwn:59

msgid ""

"`month` - The numeric month for which the calendar is requested, in the "

"range 1..12. Used only for the month view calendar, and defaults to the "

"current month. Can also use -1 to refer to last month, and so on."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/calendar.mdwn:59

msgid ""

"`week_start_day` - A number, in the range 0..6, which represents the day of "

"the week that the month calendar starts with. 0 is Sunday, 1 is Monday, and "

"so on. Defaults to 0, which is Sunday."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/calendar.mdwn:59

msgid ""

"`months_per_row` - In the year calendar, number of months to place in each "

"row. Defaults to 3."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:2

msgid ""

"The `color` directive is supplied by the [[!iki plugins/color desc=color]] "

"plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:5

msgid ""

"This directive can be used to color a piece of text on a page. It can be "

"used to set the foreground and/or background color of the text."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:8

msgid ""

"You can use a color name (e.g. `white`) or HTML code (e.g. `#ffffff`) to "

"define colors."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:13

msgid ""

"Here the foreground color is defined as a word, while the background color "

"is defined as a HTML color code:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:15

#, no-wrap

msgid ""

"\t\\[[!color foreground=white background=#ff0000 text=\"White text on red "

"background\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:18

msgid ""

"The background color is missing, so the text is displayed on default "

"background:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:20

#, no-wrap

msgid ""

"\t\\[[!color foreground=white text=\"White text on default color "

"background\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:22

msgid "The foreground is missing, so the text has the default foreground color:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/color.mdwn:24

#, no-wrap

msgid ""

"\t\\[[!color background=#ff0000 text=\"Default color text on red "

"background\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/comment.mdwn:5

msgid ""

"The `comment` directive is supplied by the [[!iki plugins/comments "

"desc=comments]] plugin, and is used to add a comment to a page. Typically, "

"the directive is the only thing on a comment page, and is filled out by the "

"comment plugin when a user posts a comment."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/comment.mdwn:12

#, no-wrap

msgid ""

"\t\\[[!comment format=mdwn\n"

"\tusername=\"foo\"\n"

"\tsubject=\"Bar\"\n"

"\tdate=\"2009-06-02T19:05:01Z\"\n"

"\tcontent=\"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/comment.mdwn:14

#, no-wrap

msgid ""

"\tBlah blah.\n"

"\t\"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/comment.mdwn:16

#, no-wrap

msgid "\t]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/comment.mdwn:21

msgid ""

"The only required parameter is `content`, the others just add or override "

"metadata of the comment."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/comment.mdwn:39

msgid ""

"`content` - Text to display for the comment. Note that "

"[[directives|ikiwiki/directive]] may not be allowed, depending on the "

"configuration of the comment plugin."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/comment.mdwn:39

msgid "`format` - Specifies the markup used for the content."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/comment.mdwn:39

msgid "`subject` - Subject for the comment."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/comment.mdwn:39

msgid ""

"`date` - Date the comment was posted. Can be entered in nearly any format, "

"since it's parsed by [[!cpan TimeDate]]"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/comment.mdwn:39

msgid ""

"`username` - Used to record the username (or OpenID) of a logged in "

"commenter."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/comment.mdwn:39

msgid ""

"`nickname` - Name to display for a logged in commenter. (Optional; used for "

"OpenIDs.)"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/comment.mdwn:39

msgid ""

"`ip` - Can be used to record the IP address of a commenter, if they posted "

"anonymously."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/comment.mdwn:39

msgid ""

"`claimedauthor` - Records the name that the user entered, if anonymous "

"commenters are allowed to enter their (unverified) name."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/copy.mdwn:1 ikiwiki/directive/cut.mdwn:1 ikiwiki/directive/paste.mdwn:1

#, no-wrap

msgid "[[!meta redir=/ikiwiki/directive/cutpaste]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:3

msgid ""

"The `copy`, `cut` and `paste` directives are supplied by the [[!iki "

"plugins/cutpaste desc=cutpaste]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:5

msgid "With these directives you can store and recall pieces of text in a page:"

msgstr ""

#. type: Bullet: ' * '

#: ikiwiki/directive/cutpaste.mdwn:11

msgid ""

"`\\[[!cut id=name text=\"text\"]]` memorizes the text allowing to recall it "

"using the given ID. The text being cut is not included in the output."

msgstr ""

#. type: Bullet: ' * '

#: ikiwiki/directive/cutpaste.mdwn:11

msgid ""

"`\\[[!copy id=name text=\"text\"]]` memorizes the text allowing to recall it "

"using the given ID. The text being cut *is* included in the output."

msgstr ""

#. type: Bullet: ' * '

#: ikiwiki/directive/cutpaste.mdwn:11

msgid "`\\[[!paste id=name]]` is replaced by the previously memorized text."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:14

msgid ""

"The text being cut, copied and pasted can freely include wiki markup, "

"including more calls to cut, copy and paste."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:19

msgid ""

"You do not need to memorize the text before using it: a cut directive can "

"follow the paste directive that uses its text. In fact, this is quite "

"useful to postpone big blocks of text like long annotations and have a more "

"natural flow. For example:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:23

#, no-wrap

msgid ""

"\t\\[[!toggleable id=\"cut\" text=\"[[!paste id=cutlongdesc]]\"]]\n"

"\t\\[[!toggleable id=\"copy\" text=\"[[!paste id=copylongdesc]]\"]]\n"

"\t\\[[!toggleable id=\"paste\" text=\"[[!paste id=pastelongdesc]]\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:25

#, no-wrap

msgid "\t[...some time later...]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:26

#, no-wrap

msgid "\t\\[[!cut id=cutlongdesc text=\"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:28 ikiwiki/directive/cutpaste.mdwn:31 ikiwiki/directive/cutpaste.mdwn:34

#, no-wrap

msgid "\t blah blah blah\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:29

#, no-wrap

msgid "\t\\[[!cut id=copylongdesc text=\"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:32

#, no-wrap

msgid "\t\\[[!cut id=pastelongdesc text=\"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:38

msgid ""

"This can potentially be used to create loops, but ikiwiki is clever and "

"breaks them."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:41

msgid ""

"Since you can paste without using double quotes, copy and paste can be used "

"to nest directives that require multiline parameters inside each other:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:42

#, no-wrap

msgid "\t\\[[!toggleable id=foo text=\"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:44

#, no-wrap

msgid "\t [[!toggleable id=bar text=\"[[!paste id=baz]]\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:46

#, no-wrap

msgid "\t\\[[!cut id=baz text=\"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/cutpaste.mdwn:48

#, no-wrap

msgid "\tmultiline parameter!\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/date.mdwn:2

msgid ""

"The `date` directive is supplied by the [[!iki plugins/date desc=date]] "

"plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/date.mdwn:7

msgid ""

"This directive can be used to display a date on a page, using the same "

"display method that is used to display the modification date in the page "

"footer, and other dates in the wiki. This can be useful for consistency of "

"display, or if you want to embed parseable dates into the page source."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/date.mdwn:10

msgid ""

"Like the dates used by the [[meta]] directive, the date can be entered in "

"nearly any format, since it's parsed by [[!cpan TimeDate]]."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/date.mdwn:13

msgid ""

"For example, an update to a page with an embedded date stamp could look "

"like:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/date.mdwn:15

#, no-wrap

msgid "\tUpdated \\[[!date \"Wed, 25 Nov 2009 01:11:55 -0500\"]]: mumble mumble\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/edittemplate.mdwn:2

msgid ""

"The `edittemplate` directive is supplied by the [[!iki plugins/edittemplate "

"desc=edittemplate]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/edittemplate.mdwn:6

msgid ""

"This directive allows registering template pages, that provide default "

"content for new pages created using the web frontend. To register a "

"template, insert a [[ikiwiki/directive/template]] directive on some other "

"page."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/edittemplate.mdwn:8

#, no-wrap

msgid "\t\\[[!edittemplate template=\"bugtemplate\" match=\"bugs/*\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/edittemplate.mdwn:13

msgid ""

"In the above example, the page named \"bugtemplate\" is registered as a "

"template to be used when any page named \"bugs/*\" is created. To avoid the "

"directive displaying a note about the template being registered, add "

"\"silent=yes\"."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/edittemplate.mdwn:17

msgid ""

"Often the template page contains a simple skeleton for a particular type of "

"page. For the bug report pages in the above example, it might look something "

"like:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/edittemplate.mdwn:22

#, no-wrap

msgid ""

"\tPackage: \n"

"\tVersion: \n"

"\tReproducible: y/n\n"

"\tDetails:\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/edittemplate.mdwn:27

#, no-wrap

msgid ""

"The template page can also contain [[!cpan HTML::Template]] directives,\n"

"like other ikiwiki [[templates]]. Currently only one variable is\n"

"set: `<TMPL_VAR name>` is replaced with the name of the page being\n"

"created.\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/edittemplate.mdwn:35

msgid ""

"It's generally not a good idea to put the `edittemplate` directive in the "

"template page itself, since the directive would then be included as part of "

"the template on new pages, which would then in turn be registered as "

"templates. If multiple pages are registered as templates for a new page, an "

"arbitrary one is chosen, so that could get confusing."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/format.mdwn:3

msgid ""

"The `format` directive is supplied by the [[!iki plugins/format "

"desc=format]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/format.mdwn:8

msgid ""

"The directive allows formatting a chunk of text using any available page "

"format. It takes two parameters. First is the type of format to use, ie the "

"extension that would be used for a standalone file of this type. Second is "

"the text to format."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/format.mdwn:11

msgid ""

"For example, this will embed an otl outline inside a page using mdwn or some "

"other format:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/format.mdwn:12

#, no-wrap

msgid "\t\\[[!format otl \"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/format.mdwn:19

#, no-wrap

msgid ""

"\tfoo\n"

"\t\t1\n"

"\t\t2\n"

"\tbar\n"

"\t\t3\n"

"\t\t4\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/format.mdwn:24

msgid ""

"Note that if the highlight plugin is enabled, this directive can also be "

"used to display syntax highlighted code. Many languages and formats are "

"supported. For example:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/format.mdwn:25

#, no-wrap

msgid "\t\\[[!format perl \"\"\"\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/format.mdwn:27

#, no-wrap

msgid "\tprint \"hello, world\\n\";\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/fortune.mdwn:2

msgid ""

"The `fortune` directive is supplied by the [[!iki plugins/fortune "

"desc=fortune]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/fortune.mdwn:5

msgid ""

"This just uses the `fortune` program to insert a fortune cookie into the "

"page. Usage:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/fortune.mdwn:7

#, no-wrap

msgid "\t\\[[!fortune ]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/graph.mdwn:2

msgid ""

"The `graph` directive is supplied by the [[!iki plugins/graphviz "

"desc=graphviz]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/graph.mdwn:5

msgid ""

"This directive allows embedding [graphviz](http://www.graphviz.org/) graphs "

"in a page. Example usage:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/graph.mdwn:7

#, no-wrap

msgid "\t\\[[!graph src=\"a -> b -> c; a -> c;\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/graph.mdwn:11

msgid ""

"Note that graphs will only show up in previews if your browser has "

"[[!wikipedia data: URI]] support, or if the same graph already exists on "

"that page."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/graph.mdwn:13

msgid "The `graph` directive supports the following parameters:"

msgstr ""

#. type: Bullet: '- '

#: ikiwiki/directive/graph.mdwn:22

msgid "`src` - The graphviz source to render."

msgstr ""

#. type: Bullet: '- '

#: ikiwiki/directive/graph.mdwn:22

msgid ""

"`type` - The type of graph to render: `graph` or `digraph`. Defaults to "

"`digraph`."

msgstr ""

#. type: Bullet: '- '

#: ikiwiki/directive/graph.mdwn:22

msgid ""

"`prog` - The graphviz program to render with: `dot`, `neato`, `fdp`, "

"`twopi`, or `circo`. Defaults to `dot`."

msgstr ""

#. type: Bullet: '- '

#: ikiwiki/directive/graph.mdwn:22

msgid ""

"`height`, `width` - Limit the size of the graph to a given height and width, "

"in inches. You must specify both to limit the size; otherwise, graphviz will "

"choose a size, without any limit."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/haiku.mdwn:2

msgid ""

"The `haiku` directive is supplied by the [[!iki plugins/haiku desc=haiku]] "

"plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/haiku.mdwn:5

msgid ""

"This directive allows inserting a randomly generated haiku into a wiki "

"page. Just type:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/haiku.mdwn:7

#, no-wrap

msgid "\t\\[[!haiku hint=\"argument\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/haiku.mdwn:8

#, no-wrap

msgid "[[!haiku hint=\"argument test\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/haiku.mdwn:14

msgid ""

"The hint parameter can be omitted, it only provides the generator a hint of "

"what to write the haiku about. If no hint is given, it might base it on the "

"page name. Since the vocabulary it knows is very small, many hints won't "

"affect the result at all."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:2

msgid ""

"The `if` directive is supplied by the [[!iki plugins/conditional "

"desc=conditional]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:5

msgid ""

"With this directive, you can make text be conditionally displayed on a "

"page. For example:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:9

#, no-wrap

msgid ""

"\t\\[[!if test=\"enabled(smiley)\"\n"

"\t then=\"The smiley plugin is enabled :-)\"\n"

"\t else=\"No smiley plugin here..\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:12

msgid ""

"If the specified `test` succeeds, the `then` text will be displayed, "

"otherwise the `else` text will be displayed. The `else` part is optional."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:16

msgid ""

"The `then` and `else` values can include any markup that would be allowed in "

"the wiki page outside the template. Triple-quoting the values even allows "

"quotes to be included."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:21

msgid ""

"The `test` is a [[ikiwiki/PageSpec]]; if it matches any page in the wiki "

"then it succeeds. So you can do things like testing for the existence of a "

"page or pages, testing to see if any pages were created in a given month, "

"and so on."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:25

msgid ""

"If you want the [[ikiwiki/PageSpec]] to only match against the page that "

"contains the conditional, rather than matching against all pages in the "

"wiki, set the \"all\" parameter to \"no\"."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:28

msgid ""

"In an `if` directive, the regular [[ikiwiki/PageSpec]] syntax is expanded "

"with the following additional tests:"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/if.mdwn:30

msgid "enabled(plugin)"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:32

#, no-wrap

msgid " Tests whether the specified plugin is enabled.\n"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/if.mdwn:34

msgid "sourcepage(glob)"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:37

#, no-wrap

msgid ""

" Tests whether the glob matches the name of the page that contains the\n"

" conditional.\n"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/if.mdwn:39

msgid "destpage(glob)"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:43

#, no-wrap

msgid ""

" Tests whether the glob matches the name of the page that is being built.\n"

" That might be different than the name of the page that contains the\n"

" conditional, if it's being inlined into another page.\n"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/if.mdwn:45

msgid "included()"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/if.mdwn:47

#, no-wrap

msgid " Tests whether the page is being included onto another page.\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:2

msgid "The `img` directive is supplied by the [[!iki plugins/img desc=img]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:7

msgid ""

"This is an image handling directive. While ikiwiki supports inlining "

"full-size images by making a [[ikiwiki/WikiLink]] that points to the image, "

"using this directive you can easily scale down an image for inclusion onto a "

"page, providing a link to a full-size version."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:11

#, no-wrap

msgid "\t\\[[!img image1.jpg size=\"200x200\" alt=\"clouds\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:14

msgid ""

"The image file will be searched for using the same rules as used to find the "

"file pointed to by a [[ikiwiki/WikiLink]]."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:20

msgid ""

"The `size` parameter is optional, defaulting to full size. Note that the "

"original image's aspect ratio is always preserved, even if this means making "

"the image smaller than the specified size. You can also specify only the "

"width or the height, and the other value will be calculated based on it: "

"\"200x\", \"x200\""

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:25

msgid ""

"You can also pass `alt`, `title`, `class`, `align`, `id`, `hspace`, and "

"`vspace` parameters. These are passed through unchanged to the html img "

"tag. If you include a `caption` parameter, the caption will be displayed "

"centered beneath the image."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:30

msgid ""

"The `link` parameter is used to control whether the scaled image links to "

"the full size version. By default it does; set \"link=somepage\" to link to "

"another page instead, or \"link=no\" to disable the link, or "

"\"link=http://url\" to link to a given url."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:33

msgid ""

"You can also set default values that will be applied to all later images on "

"the page, unless overridden. Useful when including many images on a page."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/img.mdwn:38

#, no-wrap

msgid ""

"\t\\[[!img defaults size=200x200 alt=\"wedding photo\"]]\n"

"\t\\[[!img photo1.jpg]]\n"

"\t\\[[!img photo2.jpg]]\n"

"\t\\[[!img photo3.jpg size=200x600]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:2

msgid ""

"The `inline` directive is supplied by the [[!iki plugins/inline "

"desc=inline]] plugin."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:5

msgid ""

"This is a directive that allows including one wiki page inside another. The "

"most common use of inlining is generating blogs and RSS or Atom feeds."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:9

#, no-wrap

msgid ""

"\t\\[[!inline pages=\"blog/* and !*/Discussion\" show=\"10\" "

"rootpage=\"blog\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:15

msgid ""

"Any pages that match the specified [[PageSpec]] (in the example, any "

"[[SubPage]] of \"blog\") will be part of the blog, and the newest 10 of them "

"will appear in the page. Note that if files that are not pages match the "

"[[PageSpec]], they will be included in the feed using RSS enclosures, which "

"is useful for podcasting."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:19

msgid ""

"The optional `rootpage` parameter tells the wiki that new posts to this blog "

"should default to being [[SubPages|SubPage]] of \"blog\", and enables a form "

"at the top of the blog that can be used to add new items."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:22

msgid ""

"If you want your blog to have an archive page listing every post ever made "

"to it, you can accomplish that like this:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:24

#, no-wrap

msgid "\t\\[[!inline pages=\"blog/* and !*/Discussion\" archive=\"yes\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:27

msgid ""

"You can even create an automatically generated list of all the pages on the "

"wiki, with the most recently added at the top, like this:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:29

#, no-wrap

msgid "\t\\[[!inline pages=\"* and !*/Discussion\" archive=\"yes\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:34

msgid ""

"If you want to be able to add pages to a given blog feed by tagging them, "

"you can do that too. To tag a page, just make it link to a page or pages "

"that represent its tags. Then use the special `link()` [[PageSpec]] to match "

"all pages that have a given tag:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:36

#, no-wrap

msgid "\t\\[[!inline pages=\"link(life)\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:38

msgid "Or include some tags and exclude others:"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:40

#, no-wrap

msgid "\t\\[[!inline pages=\"link(debian) and !link(social)\"]]\n"

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:45

msgid ""

"There are many parameters you can use with the `inline` directive. These are "

"the commonly used ones:"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:62

msgid "`pages` - A [[PageSpec]] of the pages to inline."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:62

msgid ""

"`show` - Specify the maximum number of matching pages to inline. Default is "

"10, unless archiving, when the default is to show all. Set to 0 to show all "

"matching pages."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:62

msgid ""

"`archive` - If set to \"yes\", only list page titles and some metadata, not "

"full contents."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:62

msgid ""

"`description` - Sets the description of the rss feed if one is generated. "

"Defaults to the name of the wiki."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:62

msgid ""

"`skip` - Specify a number of pages to skip displaying. Can be useful to "

"produce a feed that only shows archived pages."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:62

msgid "`postform` - Set to \"yes\" to enable a form to post new pages to a blog."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:62

msgid "`postformtext` - Set to specify text that is displayed in a postform."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:62

msgid ""

"`rootpage` - Enables the postform, and allows controling where newly posted "

"pages should go, by specifiying the page that they should be a [[SubPage]] "

"of."

msgstr ""

#. type: Plain text

#: ikiwiki/directive/inline.mdwn:64

msgid "Here are some less often needed parameters:"

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`actions` - If set to \"yes\" add links to the bottom of the inlined pages "

"for editing and discussion (if they would be shown at the top of the page "

"itself)."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`rss` - controls generation of an rss feed. If the wiki is configured to "

"generate rss feeds by default, set to \"no\" to disable. If the wiki is "

"configured to `allowrss`, set to \"yes\" to enable."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`atom` - controls generation of an atom feed. If the wiki is configured to "

"generate atom feeds by default, set to \"no\" to disable. If the wiki is "

"configured to `allowatom`, set to \"yes\" to enable."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`feeds` - controls generation of all types of feeds. Set to \"no\" to "

"disable generating any feeds."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`emptyfeeds` - Set to \"no\" to disable generation of empty feeds. Has no "

"effect if `rootpage` or `postform` is set."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`template` - Specifies the template to fill out to display each inlined "

"page. By default the `inlinepage` template is used, while the `archivepage` "

"template is used for archives. Set this parameter to use some other, custom "

"template, such as the `titlepage` template that only shows post titles or "

"the `microblog` template, optimised for microblogging. Note that you should "

"still set `archive=yes` if your custom template does not include the page "

"content."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`raw` - Rather than the default behavior of creating a blog, if raw is set "

"to \"yes\", the page will be included raw, without additional markup around "

"it, as if it were a literal part of the source of the inlining page."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`sort` - Controls how inlined pages are [[sorted|pagespec/sorting]]. The "

"default is to sort the newest created pages first."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid "`reverse` - If set to \"yes\", causes the sort order to be reversed."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`feedshow` - Specify the maximum number of matching pages to include in the "

"rss/atom feeds. The default is the same as the `show` value above."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`feedonly` - Only generate the feed, do not display the pages inline on the "

"page."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""

"`quick` - Build archives in quick mode, without reading page contents for "

"metadata. This also turns off generation of any feeds."

msgstr ""

#. type: Bullet: '* '

#: ikiwiki/directive/inline.mdwn:117

msgid ""


context:
space:
mode: