po/underlays/directives/ikiwiki/directive/template.cs.po

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2011-05-05 20:04+0300\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: Plain text
  20 msgid ""
  21 "The `template` directive is supplied by the [[!iki plugins/template "
  22 "desc=template]] plugin."
  23 msgstr ""
  24
  25 #. type: Plain text
  26 msgid ""
  27 "The template directive allows wiki pages to be used as templates.  These "
  28 "templates can be filled out and inserted into other pages in the wiki using "
  29 "the directive. The [[templates]] page lists templates that can be used with "
  30 "this directive."
  31 msgstr ""
  32
  33 #. type: Plain text
  34 msgid ""
  35 "The directive has an `id` parameter that identifies the template to use. The "
  36 "remaining parameters are used to fill out the template."
  37 msgstr ""
  38
  39 #. type: Title ##
  40 #, no-wrap
  41 msgid "Example"
  42 msgstr ""
  43
  44 #. type: Plain text
  45 #, no-wrap
  46 msgid ""
  47 "\t\\[[!template id=note text=\"\"\"Here is the text to insert into my "
  48 "note.\"\"\"]]\n"
  49 msgstr ""
  50
  51 #. type: Plain text
  52 msgid ""
  53 "This fills out the `note` template, filling in the `text` field with the "
  54 "specified value, and inserts the result into the page."
  55 msgstr ""
  56
  57 #. type: Title ##
  58 #, no-wrap
  59 msgid "Using a template"
  60 msgstr ""
  61
  62 #. type: Plain text
  63 msgid ""
  64 "Generally, a value can include any markup that would be allowed in the wiki "
  65 "page outside the template. Triple-quoting the value even allows quotes to be "
  66 "included in it. Combined with multi-line quoted values, this allows for "
  67 "large chunks of marked up text to be embedded into a template:"
  68 msgstr ""
  69
  70 #. type: Plain text
  71 #, no-wrap
  72 msgid ""
  73 "        \\[[!template id=foo name=\"Sally\" color=\"green\" age=8 "
  74 "notes=\"\"\"\n"
  75 msgstr ""
  76
  77 #. type: Bullet: '        * '
  78 msgid "\\[[Charley]]'s sister."
  79 msgstr ""
  80
  81 #. type: Bullet: '        * '
  82 msgid "\"I want to be an astronaut when I grow up.\""
  83 msgstr ""
  84
  85 #. type: Bullet: '        * '
  86 msgid "Really 8 and a half."
  87 msgstr ""
  88
  89 #. type: Title ##
  90 #, no-wrap
  91 msgid "Creating a template"
  92 msgstr ""
  93
  94 #. type: Plain text
  95 msgid ""
  96 "The template is a regular wiki page, located in the `templates/` "
  97 "subdirectory inside the source directory of the wiki."
  98 msgstr ""
  99
 100 #. type: Plain text
 101 msgid ""
 102 "Alternatively, templates can be stored in a directory outside the wiki, as "
 103 "files with the extension \".tmpl\".  By default, these are searched for in "
 104 "`/usr/share/ikiwiki/templates`, the `templatedir` setting can be used to "
 105 "make another directory be searched first.  When referring to templates "
 106 "outside the wiki source directory, the \"id\" parameter is not interpreted "
 107 "as a pagespec, and you must include the full filename of the template page, "
 108 "including the \".tmpl\" extension. E.g.:"
 109 msgstr ""
 110
 111 #. type: Plain text
 112 #, no-wrap
 113 msgid "    \\[[!template id=blogpost.tmpl]]\n"
 114 msgstr ""
 115
 116 #. type: Plain text
 117 msgid ""
 118 "The template uses the syntax used by the [[!cpan HTML::Template]] perl "
 119 "module, which allows for some fairly complex things to be done. Consult its "
 120 "documentation for the full syntax, but all you really need to know are a few "
 121 "things:"
 122 msgstr ""
 123
 124 #. type: Bullet: '* '
 125 msgid ""
 126 "Each parameter you pass to the template directive will generate a template "
 127 "variable. There are also some pre-defined variables like PAGE and BASENAME."
 128 msgstr ""
 129
 130 #. type: Bullet: '* '
 131 msgid ""
 132 "To insert the value of a variable, use `<TMPL_VAR variable>`. Wiki markup in "
 133 "the value will first be converted to html."
 134 msgstr ""
 135
 136 #. type: Bullet: '* '
 137 msgid ""
 138 "To insert the raw value of a variable, with wiki markup not yet converted to "
 139 "html, use `<TMPL_VAR raw_variable>`."
 140 msgstr ""
 141
 142 #. type: Bullet: '* '
 143 msgid ""
 144 "To make a block of text conditional on a variable being set use `<TMPL_IF "
 145 "variable>text</TMPL_IF>`."
 146 msgstr ""
 147
 148 #. type: Bullet: '* '
 149 msgid ""
 150 "To use one block of text if a variable is set and a second if it's not, use "
 151 "`<TMPL_IF variable>text<TMPL_ELSE>other text</TMPL_IF>`"
 152 msgstr ""
 153
 154 #. type: Plain text
 155 msgid "Here's a sample template:"
 156 msgstr ""
 157
 158 #. type: Plain text
 159 #, no-wrap
 160 msgid ""
 161 "        <span class=\"infobox\">\n"
 162 "        Name: \\[[<TMPL_VAR raw_name>]]<br />\n"
 163 "        Age: <TMPL_VAR age><br />\n"
 164 "        <TMPL_IF color>\n"
 165 "        Favorite color: <TMPL_VAR color><br />\n"
 166 "        <TMPL_ELSE>\n"
 167 "        No favorite color.<br />\n"
 168 "        </TMPL_IF>\n"
 169 "        <TMPL_IF notes>\n"
 170 "        <hr />\n"
 171 "        <TMPL_VAR notes>\n"
 172 "        </TMPL_IF>\n"
 173 "        </span>\n"
 174 msgstr ""
 175
 176 #. type: Plain text
 177 msgid ""
 178 "The filled out template will be formatted the same as the rest of the page "
 179 "that contains it, so you can include WikiLinks and all other forms of wiki "
 180 "markup in the template. Note though that such WikiLinks will not show up as "
 181 "backlinks to the page that uses the template."
 182 msgstr ""
 183
 184 #. type: Plain text
 185 msgid ""
 186 "Note the use of \"raw_name\" inside the [[ikiwiki/WikiLink]] generator in "
 187 "the example above. This ensures that if the name contains something that "
 188 "might be mistaken for wiki markup, it's not converted to html before being "
 189 "processed as a [[ikiwiki/WikiLink]]."
 190 msgstr ""
 191
 192 #. type: Plain text
 193 #, no-wrap
 194 msgid "[[!meta robots=\"noindex, follow\"]]\n"
 195 msgstr ""