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.
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"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
21 "The `inline` directive is supplied by the [[!iki plugins/inline "
22 "desc=inline]] plugin."
27 "This is a directive that allows including one wiki page inside another. The "
28 "most common use of inlining is generating blogs and RSS or Atom feeds."
38 "\t\\[[!inline pages=\"blog/* and !*/Discussion\" show=\"10\" "
39 "rootpage=\"blog\"]]\n"
44 "Any pages that match the specified [[PageSpec]] (in the example, any "
45 "[[SubPage]] of \"blog\") will be part of the blog, and the newest 10 of them "
46 "will appear in the page. Note that if files that are not pages match the "
47 "[[PageSpec]], they will be included in the feed using RSS enclosures, which "
48 "is useful for podcasting."
53 "The optional `rootpage` parameter tells the wiki that new posts to this blog "
54 "should default to being [[SubPages|SubPage]] of \"blog\", and enables a form "
55 "at the top of the blog that can be used to add new items."
60 "If you want your blog to have an archive page listing every post ever made "
61 "to it, you can accomplish that like this:"
66 msgid "\t\\[[!inline pages=\"blog/* and !*/Discussion\" archive=\"yes\"]]\n"
71 "You can even create an automatically generated list of all the pages on the "
72 "wiki, with the most recently added at the top, like this:"
77 msgid "\t\\[[!inline pages=\"* and !*/Discussion\" archive=\"yes\"]]\n"
82 "If you want to be able to add pages to a given blog feed by tagging them, "
83 "you can do that too. To tag a page, just make it link to a page or pages "
84 "that represent its tags. Then use the special `link()` [[PageSpec]] to match "
85 "all pages that have a given tag:"
90 msgid "\t\\[[!inline pages=\"link(life)\"]]\n"
94 msgid "Or include some tags and exclude others:"
99 msgid "\t\\[[!inline pages=\"link(debian) and !link(social)\"]]\n"
109 "There are many parameters you can use with the `inline` directive. These are "
110 "the commonly used ones:"
113 #. type: Bullet: '* '
114 msgid "`pages` - A [[PageSpec]] of the pages to inline."
117 #. type: Bullet: '* '
119 "`show` - Specify the maximum number of matching pages to inline. Default is "
120 "10, unless archiving, when the default is to show all. Set to 0 to show all "
124 #. type: Bullet: '* '
126 "`archive` - If set to \"yes\", only list page titles and some metadata, not "
130 #. type: Bullet: '* '
132 "`description` - Sets the description of the rss feed if one is generated. "
133 "Defaults to the name of the wiki."
136 #. type: Bullet: '* '
138 "`skip` - Specify a number of pages to skip displaying. Can be useful to "
139 "produce a feed that only shows archived pages."
142 #. type: Bullet: '* '
143 msgid "`postform` - Set to \"yes\" to enable a form to post new pages to a blog."
146 #. type: Bullet: '* '
147 msgid "`postformtext` - Set to specify text that is displayed in a postform."
150 #. type: Bullet: '* '
152 "`rootpage` - Enables the postform, and allows controling where newly posted "
153 "pages should go, by specifiying the page that they should be a [[SubPage]] "
158 msgid "Here are some less often needed parameters:"
161 #. type: Bullet: '* '
163 "`actions` - If set to \"yes\" add links to the bottom of the inlined pages "
164 "for editing and discussion (if they would be shown at the top of the page "
168 #. type: Bullet: '* '
170 "`rss` - controls generation of an rss feed. If the wiki is configured to "
171 "generate rss feeds by default, set to \"no\" to disable. If the wiki is "
172 "configured to `allowrss`, set to \"yes\" to enable."
175 #. type: Bullet: '* '
177 "`atom` - controls generation of an atom feed. If the wiki is configured to "
178 "generate atom feeds by default, set to \"no\" to disable. If the wiki is "
179 "configured to `allowatom`, set to \"yes\" to enable."
182 #. type: Bullet: '* '
184 "`feeds` - controls generation of all types of feeds. Set to \"no\" to "
185 "disable generating any feeds."
188 #. type: Bullet: '* '
190 "`emptyfeeds` - Set to \"no\" to disable generation of empty feeds. Has no "
191 "effect if `rootpage` or `postform` is set."
197 "* `id` - Set to specify the value of the HTML `id` attribute for the\n"
198 " feed links or the post form. Useful if you have multiple forms in the\n"
200 "* `template` - Specifies the template to fill out to display each inlined\n"
201 " page. By default the `inlinepage` template is used, while\n"
202 " the `archivepage` template is used for archives. Set this parameter to\n"
203 " use some other, custom template, such as the `titlepage` template that\n"
204 " only shows post titles or the `microblog` template, optimised for\n"
205 " microblogging. Note that you should still set `archive=yes` if\n"
206 " your custom template does not include the page content.\n"
207 "* `raw` - Rather than the default behavior of creating a blog,\n"
208 " if raw is set to \"yes\", the page will be included raw, without "
210 " markup around it, as if it were a literal part of the source of the \n"
212 "* `sort` - Controls how inlined pages are [[sorted|pagespec/sorting]].\n"
213 " The default is to sort the newest created pages first.\n"
214 "* `reverse` - If set to \"yes\", causes the sort order to be reversed.\n"
215 "* `feedshow` - Specify the maximum number of matching pages to include in\n"
216 " the rss/atom feeds. The default is the same as the `show` value above.\n"
217 "* `feedonly` - Only generate the feed, do not display the pages inline on\n"
219 "* `quick` - Build archives in quick mode, without reading page contents "
221 " metadata. This also turns off generation of any feeds.\n"
222 "* `timeformat` - Use this to specify how to display the time or date for "
224 " in the blog. The format string is passed to the strftime(3) function.\n"
225 "* `feedpages` - A [[PageSpec]] of inlined pages to include in the rss/atom\n"
226 " feeds. The default is the same as the `pages` value above, and only "
228 " matched by that value are included, but some of those can be excluded by\n"
229 " specifying a tighter [[PageSpec]] here.\n"
230 "* `guid` - If a URI is given here (perhaps a UUID prefixed with "
232 " the Atom feed will have this as its `<id>`. The default is to use the "
234 " of the page containing the `inline` directive.\n"
235 "* `feedfile` - Can be used to change the name of the file generated for "
237 " feed. This is particularly useful if a page contains multiple feeds.\n"
238 " For example, set \"feedfile=feed\" to cause it to generate "
240 " and/or `page/feed.rss`. This option is not supported if the wiki is\n"
241 " configured not to use `usedirs`.\n"
242 "* `pagenames` - If given instead of `pages`, this is interpreted as a\n"
243 " space-separated list of links to pages (with the same\n"
244 " [[SubPage/LinkingRules]] as in a [[ikiwiki/WikiLink]]), and they are "
246 " in exactly the order given: the `sort` and `pages` parameters cannot be "
248 " in conjunction with this one.\n"
253 msgid "[[!meta robots=\"noindex, follow\"]]\n"