# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2013-05-19 00:40+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: Plain text msgid "" "The `template` directive is supplied by the [[!iki plugins/template " "desc=template]] plugin." msgstr "" #. type: Plain text msgid "" "The template directive allows wiki pages to be used as templates. These " "templates can be filled out and inserted into other pages in the wiki using " "the directive. The [[templates]] page lists templates that can be used with " "this directive." msgstr "" #. type: Plain text msgid "" "The directive has an `id` parameter that identifies the template to use. The " "remaining parameters are used to fill out the template." msgstr "" #. type: Title ## #, no-wrap msgid "Example" msgstr "" #. type: Plain text #, no-wrap msgid "" "\t\\[[!template id=note text=\"\"\"Here is the text to insert into my " "note.\"\"\"]]\n" msgstr "" #. type: Plain text msgid "" "This fills out the `note` template, filling in the `text` field with the " "specified value, and inserts the result into the page." msgstr "" #. type: Title ## #, no-wrap msgid "Using a template" msgstr "" #. type: Plain text msgid "" "Generally, a value can include any markup that would be allowed in the wiki " "page outside the template. Triple-quoting the value even allows quotes to be " "included in it. Combined with multi-line quoted values, this allows for " "large chunks of marked up text to be embedded into a template:" msgstr "" #. type: Plain text #, no-wrap msgid "" " \\[[!template id=foo name=\"Sally\" color=\"green\" age=8 " "notes=\"\"\"\n" msgstr "" #. type: Bullet: ' * ' msgid "\\[[Charley]]'s sister." msgstr "" #. type: Bullet: ' * ' msgid "\"I want to be an astronaut when I grow up.\"" msgstr "" #. type: Bullet: ' * ' msgid "Really 8 and a half." msgstr "" #. type: Title ## #, no-wrap msgid "Creating a template" msgstr "" #. type: Plain text msgid "" "The template is a regular wiki page, located in the `templates/` " "subdirectory inside the source directory of the wiki." msgstr "" #. type: Plain text msgid "" "Alternatively, templates can be stored in a directory outside the wiki, as " "files with the extension \".tmpl\". By default, these are searched for in " "`/usr/share/ikiwiki/templates`, the `templatedir` setting can be used to " "make another directory be searched first. When referring to templates " "outside the wiki source directory, the \"id\" parameter is not interpreted " "as a pagespec, and you must include the full filename of the template page, " "including the \".tmpl\" extension. E.g.:" msgstr "" #. type: Plain text #, no-wrap msgid " \\[[!template id=blogpost.tmpl]]\n" msgstr "" #. type: Plain text msgid "" "The template uses the syntax used by the [[!cpan HTML::Template]] perl " "module, which allows for some fairly complex things to be done. Consult its " "documentation for the full syntax, but all you really need to know are a few " "things:" msgstr "" #. type: Bullet: '* ' msgid "" "Each parameter you pass to the template directive will generate a template " "variable. There are also some pre-defined variables like PAGE and BASENAME." msgstr "" #. type: Bullet: '* ' msgid "" "To insert the value of a variable, use ``. Wiki markup in " "the value will first be converted to html." msgstr "" #. type: Bullet: '* ' msgid "" "To insert the raw value of a variable, with wiki markup not yet converted to " "html, use ``." msgstr "" #. type: Bullet: '* ' msgid "" "To make a block of text conditional on a variable being set use `text`." msgstr "" #. type: Bullet: '* ' msgid "" "To use one block of text if a variable is set and a second if it's not, use " "`textother text`" msgstr "" #. type: Plain text msgid "Here's a sample template:" msgstr "" #. type: Plain text #, no-wrap msgid "" " \n" " Name: \\[[]]
\n" " Age:
\n" " \n" " Favorite color:
\n" " \n" " No favorite color.
\n" "
\n" " \n" "
\n" " \n" "
\n" "
\n" msgstr "" #. type: Plain text msgid "" "The filled out template will be formatted the same as the rest of the page " "that contains it, so you can include WikiLinks and all other forms of wiki " "markup in the template. Note though that such WikiLinks will not show up as " "backlinks to the page that uses the template." msgstr "" #. type: Plain text msgid "" "Note the use of \"raw_name\" inside the [[ikiwiki/WikiLink]] generator in " "the example above. This ensures that if the name contains something that " "might be mistaken for wiki markup, it's not converted to html before being " "processed as a [[ikiwiki/WikiLink]]." msgstr "" #. type: Plain text #, no-wrap msgid "[[!meta robots=\"noindex, follow\"]]\n" msgstr ""