summaryrefslogtreecommitdiff
path: root/po/directives.pot
blob: e9cc93129b6b33bcd35f58a2bd75f5187ab33a6f (plain)
  1. # LOCALE translation of directives pages for ikiwiki.
  2. # Copyright (C) YEAR Free Software Foundation, Inc.
  3. # This file is distributed under the same license as the ikiwiki package.
  4. # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
  5. #
  6. #, fuzzy
  7. msgid ""
  8. msgstr ""
  9. "Project-Id-Version: ikiwiki directives 3.20100704\n"
  10. "POT-Creation-Date: 2010-07-16 13:42+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. "MIME-Version: 1.0\n"
  15. "Content-Type: text/plain; charset=utf-8\n"
  16. "Content-Transfer-Encoding: 8bit"
  17. #. type: Plain text
  18. #: ikiwiki/directive/aggregate.mdwn:4
  19. msgid ""
  20. "The `aggregate` directive is supplied by the [[!iki plugins/aggregate "
  21. "desc=aggregate]] plugin. This plugin requires extra setup, specifically, a "
  22. "cron job. See the plugin's documentation for details."
  23. msgstr ""
  24. #. type: Plain text
  25. #: ikiwiki/directive/aggregate.mdwn:7
  26. msgid ""
  27. "This directive allows content from other feeds to be aggregated into the "
  28. "wiki. Aggregate a feed as follows:"
  29. msgstr ""
  30. #. type: Plain text
  31. #: ikiwiki/directive/aggregate.mdwn:11
  32. #, no-wrap
  33. msgid ""
  34. "\t\\[[!aggregate name=\"example blog\" dir=\"example\"\n"
  35. "\tfeedurl=\"http://example.com/index.rss\"\n"
  36. "\turl=\"http://example.com/\" updateinterval=\"15\"]]\n"
  37. msgstr ""
  38. #. type: Plain text
  39. #: ikiwiki/directive/aggregate.mdwn:16
  40. msgid ""
  41. "That example aggregates posts from the specified RSS feed, updating no more "
  42. "frequently than once every 15 minutes (though possibly less frequently, if "
  43. "the cron job runs less frequently than that), and puts a page per post under "
  44. "the example/ directory in the wiki."
  45. msgstr ""
  46. #. type: Plain text
  47. #: ikiwiki/directive/aggregate.mdwn:19
  48. msgid ""
  49. "You can then use ikiwiki's [[inline]] directive to create a blog of one or "
  50. "more aggregated feeds. For example:"
  51. msgstr ""
  52. #. type: Plain text
  53. #: ikiwiki/directive/aggregate.mdwn:21
  54. #, no-wrap
  55. msgid "\t\\[[!inline pages=\"internal(example/*)\"]]\n"
  56. msgstr ""
  57. #. type: Plain text
  58. #: ikiwiki/directive/aggregate.mdwn:26
  59. msgid ""
  60. "Note the use of `internal()` in the [[ikiwiki/PageSpec]] to match aggregated "
  61. "pages. By default, aggregated pages are internal pages, which prevents them "
  62. "from showing up directly in the wiki, and so this special [[PageSpec]] is "
  63. "needed to match them."
  64. msgstr ""
  65. #. type: Title ##
  66. #: 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
  67. #, no-wrap
  68. msgid "usage"
  69. msgstr ""
  70. #. type: Plain text
  71. #: ikiwiki/directive/aggregate.mdwn:31
  72. msgid ""
  73. "Here are descriptions of all the supported parameters to the `aggregate` "
  74. "directive:"
  75. msgstr ""
  76. #. type: Bullet: '* '
  77. #: ikiwiki/directive/aggregate.mdwn:52
  78. msgid "`name` - A name for the feed. Each feed must have a unique name. Required."
  79. msgstr ""
  80. #. type: Bullet: '* '
  81. #: ikiwiki/directive/aggregate.mdwn:52
  82. msgid ""
  83. "`url` - The url to the web page for the feed that's being aggregated. "
  84. "Required."
  85. msgstr ""
  86. #. type: Bullet: '* '
  87. #: ikiwiki/directive/aggregate.mdwn:52
  88. msgid ""
  89. "`dir` - The directory in the wiki where pages should be saved. Optional, if "
  90. "not specified, the directory is based on the name of the feed."
  91. msgstr ""
  92. #. type: Bullet: '* '
  93. #: ikiwiki/directive/aggregate.mdwn:52
  94. msgid ""
  95. "`feedurl` - The url to the feed. Optional, if it's not specified ikiwiki "
  96. "will look for feeds on the `url`. RSS and atom feeds are supported."
  97. msgstr ""
  98. #. type: Bullet: '* '
  99. #: ikiwiki/directive/aggregate.mdwn:52
  100. msgid ""
  101. "`updateinterval` - How often to check for new posts, in minutes. Default is "
  102. "15 minutes."
  103. msgstr ""
  104. #. type: Bullet: '* '
  105. #: ikiwiki/directive/aggregate.mdwn:52
  106. msgid ""
  107. "`expireage` - Expire old items from this feed if they are older than a "
  108. "specified number of days. Default is to never expire on age."
  109. msgstr ""
  110. #. type: Bullet: '* '
  111. #: ikiwiki/directive/aggregate.mdwn:52
  112. msgid ""
  113. "`expirecount` - Expire old items from this feed if there are more than the "
  114. "specified number total. Oldest items will be expired first. Default is to "
  115. "never expire on count."
  116. msgstr ""
  117. #. type: Bullet: '* '
  118. #: ikiwiki/directive/aggregate.mdwn:52
  119. msgid ""
  120. "`tag` - A tag to tag each post from the feed with. A good tag to use is the "
  121. "name of the feed. Can be repeated multiple times. The [[tag]] plugin must be "
  122. "enabled for this to work."
  123. msgstr ""
  124. #. type: Bullet: '* '
  125. #: ikiwiki/directive/aggregate.mdwn:52
  126. msgid ""
  127. "`template` - Template to use for creating the aggregated pages. Defaults to "
  128. "aggregatepost."
  129. msgstr ""
  130. #. type: Plain text
  131. #: ikiwiki/directive/aggregate.mdwn:56
  132. msgid ""
  133. "Note that even if you are using subversion or another revision control "
  134. "system, pages created by aggregation will *not* be checked into revision "
  135. "control."
  136. msgstr ""
  137. #. type: Plain text
  138. #: 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
  139. #, no-wrap
  140. msgid "[[!meta robots=\"noindex, follow\"]]\n"
  141. msgstr ""
  142. #. type: Plain text
  143. #: ikiwiki/directive/brokenlinks.mdwn:2
  144. msgid ""
  145. "The `brokenlinks` directive is supplied by the [[!iki plugins/brokenlinks "
  146. "desc=brokenlinks]] plugin."
  147. msgstr ""
  148. #. type: Plain text
  149. #: ikiwiki/directive/brokenlinks.mdwn:6
  150. msgid ""
  151. "This directive generates a list of broken links on pages in the wiki. This "
  152. "is a useful way to find pages that still need to be written, or links that "
  153. "are written wrong."
  154. msgstr ""
  155. #. type: Plain text
  156. #: ikiwiki/directive/brokenlinks.mdwn:9
  157. msgid ""
  158. "The optional parameter \"pages\" can be a [[ikiwiki/PageSpec]] specifying "
  159. "the pages to search for broken links, default is search them all."
  160. msgstr ""
  161. #. type: Plain text
  162. #: ikiwiki/directive/brokenlinks.mdwn:11 ikiwiki/directive/comment.mdwn:7 ikiwiki/directive/inline.mdwn:7
  163. msgid "Example:"
  164. msgstr ""
  165. #. type: Plain text
  166. #: ikiwiki/directive/brokenlinks.mdwn:13
  167. #, no-wrap
  168. msgid "\t\\[[!brokenlinks pages=\"* and !recentchanges\"]]\n"
  169. msgstr ""
  170. #. type: Plain text
  171. #: ikiwiki/directive/calendar.mdwn:2
  172. msgid ""
  173. "The `calendar` directive is supplied by the [[!iki plugins/calendar "
  174. "desc=calendar]] plugin."
  175. msgstr ""
  176. #. type: Plain text
  177. #: ikiwiki/directive/calendar.mdwn:5
  178. msgid ""
  179. "This directive displays a calendar, similar to the typical calendars shown "
  180. "on some blogs."
  181. msgstr ""
  182. #. type: Title ##
  183. #: 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
  184. #, no-wrap
  185. msgid "examples"
  186. msgstr ""
  187. #. type: Plain text
  188. #: ikiwiki/directive/calendar.mdwn:9
  189. #, no-wrap
  190. msgid "\t\\[[!calendar ]]\n"
  191. msgstr ""
  192. #. type: Plain text
  193. #: ikiwiki/directive/calendar.mdwn:11
  194. #, no-wrap
  195. msgid "\t\\[[!calendar type=\"month\" pages=\"blog/* and !*/Discussion\"]]\n"
  196. msgstr ""
  197. #. type: Plain text
  198. #: ikiwiki/directive/calendar.mdwn:13
  199. #, no-wrap
  200. msgid ""
  201. "\t\\[[!calendar type=\"year\" year=\"2005\" pages=\"blog/* and "
  202. "!*/Discussion\"]]\n"
  203. msgstr ""
  204. #. type: Title ##
  205. #: ikiwiki/directive/calendar.mdwn:14
  206. #, no-wrap
  207. msgid "setup"
  208. msgstr ""
  209. #. type: Plain text
  210. #: ikiwiki/directive/calendar.mdwn:22
  211. msgid ""
  212. "The calendar is essentially a fancy front end to archives of previous pages, "
  213. "usually used for blogs. It can produce a calendar for a given month, or a "
  214. "list of months for a given year. The month format calendar simply links to "
  215. "any page posted on each day of the month. The year format calendar links to "
  216. "archive pages, with names like `archives/2007` (for all of 2007) and "
  217. "`archives/2007/01` (for January, 2007)."
  218. msgstr ""
  219. #. type: Plain text
  220. #: ikiwiki/directive/calendar.mdwn:27
  221. msgid ""
  222. "While you can insert calendar directives anywhere on your wiki, including in "
  223. "the sidebar, you'll also need to create these archive pages. They typically "
  224. "use this directive to display a calendar, and also use [[inline]] to display "
  225. "or list pages created in the given time frame."
  226. msgstr ""
  227. #. type: Plain text
  228. #: ikiwiki/directive/calendar.mdwn:32
  229. msgid ""
  230. "The `ikiwiki-calendar` command can be used to automatically generate the "
  231. "archive pages. It also refreshes the wiki, updating the calendars to "
  232. "highlight the current day. This command is typically run at midnight from "
  233. "cron. An example crontab:"
  234. msgstr ""
  235. #. type: Plain text
  236. #: ikiwiki/directive/calendar.mdwn:34
  237. msgid "An example crontab:"
  238. msgstr ""
  239. #. type: Plain text
  240. #: ikiwiki/directive/calendar.mdwn:36
  241. #, no-wrap
  242. msgid "\t0 0 * * * ikiwiki-calendar ~/ikiwiki.setup \"posts/* and !*/Discussion\"\n"
  243. msgstr ""
  244. #. type: Bullet: '* '
  245. #: ikiwiki/directive/calendar.mdwn:59
  246. msgid ""
  247. "`type` - Used to specify the type of calendar wanted. Can be one of "
  248. "\"month\" or \"year\". The default is a month view calendar."
  249. msgstr ""
  250. #. type: Bullet: '* '
  251. #: ikiwiki/directive/calendar.mdwn:59
  252. msgid ""
  253. "`pages` - Specifies the [[ikiwiki/PageSpec]] of pages to link to from the "
  254. "month calendar. Defaults to \"*\"."
  255. msgstr ""
  256. #. type: Bullet: '* '
  257. #: ikiwiki/directive/calendar.mdwn:59
  258. msgid ""
  259. "`archivebase` - Configures the base of the archives hierarchy. The default "
  260. "is \"archives\". Note that this default can also be overridden for the whole "
  261. "wiki by setting `archivebase` in ikiwiki's setup file. Calendars link to "
  262. "pages under here, with names like \"2010/04\" and \"2010\". These pages can "
  263. "be automatically created using the `ikiwiki-calendar` program."
  264. msgstr ""
  265. #. type: Bullet: '* '
  266. #: ikiwiki/directive/calendar.mdwn:59
  267. msgid ""
  268. "`year` - The year for which the calendar is requested. Defaults to the "
  269. "current year. Can also use -1 to refer to last year, and so on."
  270. msgstr ""
  271. #. type: Bullet: '* '
  272. #: ikiwiki/directive/calendar.mdwn:59
  273. msgid ""
  274. "`month` - The numeric month for which the calendar is requested, in the "
  275. "range 1..12. Used only for the month view calendar, and defaults to the "
  276. "current month. Can also use -1 to refer to last month, and so on."
  277. msgstr ""
  278. #. type: Bullet: '* '
  279. #: ikiwiki/directive/calendar.mdwn:59
  280. msgid ""
  281. "`week_start_day` - A number, in the range 0..6, which represents the day of "
  282. "the week that the month calendar starts with. 0 is Sunday, 1 is Monday, and "
  283. "so on. Defaults to 0, which is Sunday."
  284. msgstr ""
  285. #. type: Bullet: '* '
  286. #: ikiwiki/directive/calendar.mdwn:59
  287. msgid ""
  288. "`months_per_row` - In the year calendar, number of months to place in each "
  289. "row. Defaults to 3."
  290. msgstr ""
  291. #. type: Plain text
  292. #: ikiwiki/directive/color.mdwn:2
  293. msgid ""
  294. "The `color` directive is supplied by the [[!iki plugins/color desc=color]] "
  295. "plugin."
  296. msgstr ""
  297. #. type: Plain text
  298. #: ikiwiki/directive/color.mdwn:5
  299. msgid ""
  300. "This directive can be used to color a piece of text on a page. It can be "
  301. "used to set the foreground and/or background color of the text."
  302. msgstr ""
  303. #. type: Plain text
  304. #: ikiwiki/directive/color.mdwn:8
  305. msgid ""
  306. "You can use a color name (e.g. `white`) or HTML code (e.g. `#ffffff`) to "
  307. "define colors."
  308. msgstr ""
  309. #. type: Plain text
  310. #: ikiwiki/directive/color.mdwn:13
  311. msgid ""
  312. "Here the foreground color is defined as a word, while the background color "
  313. "is defined as a HTML color code:"
  314. msgstr ""
  315. #. type: Plain text
  316. #: ikiwiki/directive/color.mdwn:15
  317. #, no-wrap
  318. msgid ""
  319. "\t\\[[!color foreground=white background=#ff0000 text=\"White text on red "
  320. "background\"]]\n"
  321. msgstr ""
  322. #. type: Plain text
  323. #: ikiwiki/directive/color.mdwn:18
  324. msgid ""
  325. "The background color is missing, so the text is displayed on default "
  326. "background:"
  327. msgstr ""
  328. #. type: Plain text
  329. #: ikiwiki/directive/color.mdwn:20
  330. #, no-wrap
  331. msgid ""
  332. "\t\\[[!color foreground=white text=\"White text on default color "
  333. "background\"]]\n"
  334. msgstr ""
  335. #. type: Plain text
  336. #: ikiwiki/directive/color.mdwn:22
  337. msgid "The foreground is missing, so the text has the default foreground color:"
  338. msgstr ""
  339. #. type: Plain text
  340. #: ikiwiki/directive/color.mdwn:24
  341. #, no-wrap
  342. msgid ""
  343. "\t\\[[!color background=#ff0000 text=\"Default color text on red "
  344. "background\"]]\n"
  345. msgstr ""
  346. #. type: Plain text
  347. #: ikiwiki/directive/comment.mdwn:5
  348. msgid ""
  349. "The `comment` directive is supplied by the [[!iki plugins/comments "
  350. "desc=comments]] plugin, and is used to add a comment to a page. Typically, "
  351. "the directive is the only thing on a comment page, and is filled out by the "
  352. "comment plugin when a user posts a comment."
  353. msgstr ""
  354. #. type: Plain text
  355. #: ikiwiki/directive/comment.mdwn:12
  356. #, no-wrap
  357. msgid ""
  358. "\t\\[[!comment format=mdwn\n"
  359. "\tusername=\"foo\"\n"
  360. "\tsubject=\"Bar\"\n"
  361. "\tdate=\"2009-06-02T19:05:01Z\"\n"
  362. "\tcontent=\"\"\"\n"
  363. msgstr ""
  364. #. type: Plain text
  365. #: ikiwiki/directive/comment.mdwn:14
  366. #, no-wrap
  367. msgid ""
  368. "\tBlah blah.\n"
  369. "\t\"\"\"\n"
  370. msgstr ""
  371. #. type: Plain text
  372. #: ikiwiki/directive/comment.mdwn:16
  373. #, no-wrap
  374. msgid "\t]]\n"
  375. msgstr ""
  376. #. type: Plain text
  377. #: ikiwiki/directive/comment.mdwn:21
  378. msgid ""
  379. "The only required parameter is `content`, the others just add or override "
  380. "metadata of the comment."
  381. msgstr ""
  382. #. type: Bullet: '* '
  383. #: ikiwiki/directive/comment.mdwn:39
  384. msgid ""
  385. "`content` - Text to display for the comment. Note that "
  386. "[[directives|ikiwiki/directive]] may not be allowed, depending on the "
  387. "configuration of the comment plugin."
  388. msgstr ""
  389. #. type: Bullet: '* '
  390. #: ikiwiki/directive/comment.mdwn:39
  391. msgid "`format` - Specifies the markup used for the content."
  392. msgstr ""
  393. #. type: Bullet: '* '
  394. #: ikiwiki/directive/comment.mdwn:39
  395. msgid "`subject` - Subject for the comment."
  396. msgstr ""
  397. #. type: Bullet: '* '
  398. #: ikiwiki/directive/comment.mdwn:39
  399. msgid ""
  400. "`date` - Date the comment was posted. Can be entered in nearly any format, "
  401. "since it's parsed by [[!cpan TimeDate]]"
  402. msgstr ""
  403. #. type: Bullet: '* '
  404. #: ikiwiki/directive/comment.mdwn:39
  405. msgid ""
  406. "`username` - Used to record the username (or OpenID) of a logged in "
  407. "commenter."
  408. msgstr ""
  409. #. type: Bullet: '* '
  410. #: ikiwiki/directive/comment.mdwn:39
  411. msgid ""
  412. "`nickname` - Name to display for a logged in commenter. (Optional; used for "
  413. "OpenIDs.)"
  414. msgstr ""
  415. #. type: Bullet: '* '
  416. #: ikiwiki/directive/comment.mdwn:39
  417. msgid ""
  418. "`ip` - Can be used to record the IP address of a commenter, if they posted "
  419. "anonymously."
  420. msgstr ""
  421. #. type: Bullet: '* '
  422. #: ikiwiki/directive/comment.mdwn:39
  423. msgid ""
  424. "`claimedauthor` - Records the name that the user entered, if anonymous "
  425. "commenters are allowed to enter their (unverified) name."
  426. msgstr ""
  427. #. type: Plain text
  428. #: ikiwiki/directive/copy.mdwn:1 ikiwiki/directive/cut.mdwn:1 ikiwiki/directive/paste.mdwn:1
  429. #, no-wrap
  430. msgid "[[!meta redir=/ikiwiki/directive/cutpaste]]\n"
  431. msgstr ""
  432. #. type: Plain text
  433. #: ikiwiki/directive/cutpaste.mdwn:3
  434. msgid ""
  435. "The `copy`, `cut` and `paste` directives are supplied by the [[!iki "
  436. "plugins/cutpaste desc=cutpaste]] plugin."
  437. msgstr ""
  438. #. type: Plain text
  439. #: ikiwiki/directive/cutpaste.mdwn:5
  440. msgid "With these directives you can store and recall pieces of text in a page:"
  441. msgstr ""
  442. #. type: Bullet: ' * '
  443. #: ikiwiki/directive/cutpaste.mdwn:11
  444. msgid ""
  445. "`\\[[!cut id=name text=\"text\"]]` memorizes the text allowing to recall it "
  446. "using the given ID. The text being cut is not included in the output."
  447. msgstr ""
  448. #. type: Bullet: ' * '
  449. #: ikiwiki/directive/cutpaste.mdwn:11
  450. msgid ""
  451. "`\\[[!copy id=name text=\"text\"]]` memorizes the text allowing to recall it "
  452. "using the given ID. The text being cut *is* included in the output."
  453. msgstr ""
  454. #. type: Bullet: ' * '
  455. #: ikiwiki/directive/cutpaste.mdwn:11
  456. msgid "`\\[[!paste id=name]]` is replaced by the previously memorized text."
  457. msgstr ""
  458. #. type: Plain text
  459. #: ikiwiki/directive/cutpaste.mdwn:14
  460. msgid ""
  461. "The text being cut, copied and pasted can freely include wiki markup, "
  462. "including more calls to cut, copy and paste."
  463. msgstr ""
  464. #. type: Plain text
  465. #: ikiwiki/directive/cutpaste.mdwn:19
  466. msgid ""
  467. "You do not need to memorize the text before using it: a cut directive can "
  468. "follow the paste directive that uses its text. In fact, this is quite "
  469. "useful to postpone big blocks of text like long annotations and have a more "
  470. "natural flow. For example:"
  471. msgstr ""
  472. #. type: Plain text
  473. #: ikiwiki/directive/cutpaste.mdwn:23
  474. #, no-wrap
  475. msgid ""
  476. "\t\\[[!toggleable id=\"cut\" text=\"[[!paste id=cutlongdesc]]\"]]\n"
  477. "\t\\[[!toggleable id=\"copy\" text=\"[[!paste id=copylongdesc]]\"]]\n"
  478. "\t\\[[!toggleable id=\"paste\" text=\"[[!paste id=pastelongdesc]]\"]]\n"
  479. msgstr ""
  480. #. type: Plain text
  481. #: ikiwiki/directive/cutpaste.mdwn:25
  482. #, no-wrap
  483. msgid "\t[...some time later...]\n"
  484. msgstr ""
  485. #. type: Plain text
  486. #: ikiwiki/directive/cutpaste.mdwn:26
  487. #, no-wrap
  488. msgid "\t\\[[!cut id=cutlongdesc text=\"\"\"\n"
  489. msgstr ""
  490. #. type: Plain text
  491. #: ikiwiki/directive/cutpaste.mdwn:28 ikiwiki/directive/cutpaste.mdwn:31 ikiwiki/directive/cutpaste.mdwn:34
  492. #, no-wrap
  493. msgid "\t blah blah blah\n"
  494. msgstr ""
  495. #. type: Plain text
  496. #: ikiwiki/directive/cutpaste.mdwn:29
  497. #, no-wrap
  498. msgid "\t\\[[!cut id=copylongdesc text=\"\"\"\n"
  499. msgstr ""
  500. #. type: Plain text
  501. #: ikiwiki/directive/cutpaste.mdwn:32
  502. #, no-wrap
  503. msgid "\t\\[[!cut id=pastelongdesc text=\"\"\"\n"
  504. msgstr ""
  505. #. type: Plain text
  506. #: ikiwiki/directive/cutpaste.mdwn:38
  507. msgid ""
  508. "This can potentially be used to create loops, but ikiwiki is clever and "
  509. "breaks them."
  510. msgstr ""
  511. #. type: Plain text
  512. #: ikiwiki/directive/cutpaste.mdwn:41
  513. msgid ""
  514. "Since you can paste without using double quotes, copy and paste can be used "
  515. "to nest directives that require multiline parameters inside each other:"
  516. msgstr ""
  517. #. type: Plain text
  518. #: ikiwiki/directive/cutpaste.mdwn:42
  519. #, no-wrap
  520. msgid "\t\\[[!toggleable id=foo text=\"\"\"\n"
  521. msgstr ""
  522. #. type: Plain text
  523. #: ikiwiki/directive/cutpaste.mdwn:44
  524. #, no-wrap
  525. msgid "\t [[!toggleable id=bar text=\"[[!paste id=baz]]\"]]\n"
  526. msgstr ""
  527. #. type: Plain text
  528. #: ikiwiki/directive/cutpaste.mdwn:46
  529. #, no-wrap
  530. msgid "\t\\[[!cut id=baz text=\"\"\"\n"
  531. msgstr ""
  532. #. type: Plain text
  533. #: ikiwiki/directive/cutpaste.mdwn:48
  534. #, no-wrap
  535. msgid "\tmultiline parameter!\n"
  536. msgstr ""
  537. #. type: Plain text
  538. #: ikiwiki/directive/date.mdwn:2
  539. msgid ""
  540. "The `date` directive is supplied by the [[!iki plugins/date desc=date]] "
  541. "plugin."
  542. msgstr ""
  543. #. type: Plain text
  544. #: ikiwiki/directive/date.mdwn:7
  545. msgid ""
  546. "This directive can be used to display a date on a page, using the same "
  547. "display method that is used to display the modification date in the page "
  548. "footer, and other dates in the wiki. This can be useful for consistency of "
  549. "display, or if you want to embed parseable dates into the page source."
  550. msgstr ""
  551. #. type: Plain text
  552. #: ikiwiki/directive/date.mdwn:10
  553. msgid ""
  554. "Like the dates used by the [[meta]] directive, the date can be entered in "
  555. "nearly any format, since it's parsed by [[!cpan TimeDate]]."
  556. msgstr ""
  557. #. type: Plain text
  558. #: ikiwiki/directive/date.mdwn:13
  559. msgid ""
  560. "For example, an update to a page with an embedded date stamp could look "
  561. "like:"
  562. msgstr ""
  563. #. type: Plain text
  564. #: ikiwiki/directive/date.mdwn:15
  565. #, no-wrap
  566. msgid "\tUpdated \\[[!date \"Wed, 25 Nov 2009 01:11:55 -0500\"]]: mumble mumble\n"
  567. msgstr ""
  568. #. type: Plain text
  569. #: ikiwiki/directive/edittemplate.mdwn:2
  570. msgid ""
  571. "The `edittemplate` directive is supplied by the [[!iki plugins/edittemplate "
  572. "desc=edittemplate]] plugin."
  573. msgstr ""
  574. #. type: Plain text
  575. #: ikiwiki/directive/edittemplate.mdwn:6
  576. msgid ""
  577. "This directive allows registering template pages, that provide default "
  578. "content for new pages created using the web frontend. To register a "
  579. "template, insert a [[ikiwiki/directive/template]] directive on some other "
  580. "page."
  581. msgstr ""
  582. #. type: Plain text
  583. #: ikiwiki/directive/edittemplate.mdwn:8
  584. #, no-wrap
  585. msgid "\t\\[[!edittemplate template=\"bugtemplate\" match=\"bugs/*\"]]\n"
  586. msgstr ""
  587. #. type: Plain text
  588. #: ikiwiki/directive/edittemplate.mdwn:13
  589. msgid ""
  590. "In the above example, the page named \"bugtemplate\" is registered as a "
  591. "template to be used when any page named \"bugs/*\" is created. To avoid the "
  592. "directive displaying a note about the template being registered, add "
  593. "\"silent=yes\"."
  594. msgstr ""
  595. #. type: Plain text
  596. #: ikiwiki/directive/edittemplate.mdwn:17
  597. msgid ""
  598. "Often the template page contains a simple skeleton for a particular type of "
  599. "page. For the bug report pages in the above example, it might look something "
  600. "like:"
  601. msgstr ""
  602. #. type: Plain text
  603. #: ikiwiki/directive/edittemplate.mdwn:22
  604. #, no-wrap
  605. msgid ""
  606. "\tPackage: \n"
  607. "\tVersion: \n"
  608. "\tReproducible: y/n\n"
  609. "\tDetails:\n"
  610. msgstr ""
  611. #. type: Plain text
  612. #: ikiwiki/directive/edittemplate.mdwn:27
  613. #, no-wrap
  614. msgid ""
  615. "The template page can also contain [[!cpan HTML::Template]] directives,\n"
  616. "like other ikiwiki [[templates]]. Currently only one variable is\n"
  617. "set: `<TMPL_VAR name>` is replaced with the name of the page being\n"
  618. "created.\n"
  619. msgstr ""
  620. #. type: Plain text
  621. #: ikiwiki/directive/edittemplate.mdwn:35
  622. msgid ""
  623. "It's generally not a good idea to put the `edittemplate` directive in the "
  624. "template page itself, since the directive would then be included as part of "
  625. "the template on new pages, which would then in turn be registered as "
  626. "templates. If multiple pages are registered as templates for a new page, an "
  627. "arbitrary one is chosen, so that could get confusing."
  628. msgstr ""
  629. #. type: Plain text
  630. #: ikiwiki/directive/format.mdwn:3
  631. msgid ""
  632. "The `format` directive is supplied by the [[!iki plugins/format "
  633. "desc=format]] plugin."
  634. msgstr ""
  635. #. type: Plain text
  636. #: ikiwiki/directive/format.mdwn:8
  637. msgid ""
  638. "The directive allows formatting a chunk of text using any available page "
  639. "format. It takes two parameters. First is the type of format to use, ie the "
  640. "extension that would be used for a standalone file of this type. Second is "
  641. "the text to format."
  642. msgstr ""
  643. #. type: Plain text
  644. #: ikiwiki/directive/format.mdwn:11
  645. msgid ""
  646. "For example, this will embed an otl outline inside a page using mdwn or some "
  647. "other format:"
  648. msgstr ""
  649. #. type: Plain text
  650. #: ikiwiki/directive/format.mdwn:12
  651. #, no-wrap
  652. msgid "\t\\[[!format otl \"\"\"\n"
  653. msgstr ""
  654. #. type: Plain text
  655. #: ikiwiki/directive/format.mdwn:19
  656. #, no-wrap
  657. msgid ""
  658. "\tfoo\n"
  659. "\t\t1\n"
  660. "\t\t2\n"
  661. "\tbar\n"
  662. "\t\t3\n"
  663. "\t\t4\n"
  664. msgstr ""
  665. #. type: Plain text
  666. #: ikiwiki/directive/format.mdwn:24
  667. msgid ""
  668. "Note that if the highlight plugin is enabled, this directive can also be "
  669. "used to display syntax highlighted code. Many languages and formats are "
  670. "supported. For example:"
  671. msgstr ""
  672. #. type: Plain text
  673. #: ikiwiki/directive/format.mdwn:25
  674. #, no-wrap
  675. msgid "\t\\[[!format perl \"\"\"\n"
  676. msgstr ""
  677. #. type: Plain text
  678. #: ikiwiki/directive/format.mdwn:27
  679. #, no-wrap
  680. msgid "\tprint \"hello, world\\n\";\n"
  681. msgstr ""
  682. #. type: Plain text
  683. #: ikiwiki/directive/fortune.mdwn:2
  684. msgid ""
  685. "The `fortune` directive is supplied by the [[!iki plugins/fortune "
  686. "desc=fortune]] plugin."
  687. msgstr ""
  688. #. type: Plain text
  689. #: ikiwiki/directive/fortune.mdwn:5
  690. msgid ""
  691. "This just uses the `fortune` program to insert a fortune cookie into the "
  692. "page. Usage:"
  693. msgstr ""
  694. #. type: Plain text
  695. #: ikiwiki/directive/fortune.mdwn:7
  696. #, no-wrap
  697. msgid "\t\\[[!fortune ]]\n"
  698. msgstr ""
  699. #. type: Plain text
  700. #: ikiwiki/directive/graph.mdwn:2
  701. msgid ""
  702. "The `graph` directive is supplied by the [[!iki plugins/graphviz "
  703. "desc=graphviz]] plugin."
  704. msgstr ""
  705. #. type: Plain text
  706. #: ikiwiki/directive/graph.mdwn:5
  707. msgid ""
  708. "This directive allows embedding [graphviz](http://www.graphviz.org/) graphs "
  709. "in a page. Example usage:"
  710. msgstr ""
  711. #. type: Plain text
  712. #: ikiwiki/directive/graph.mdwn:7
  713. #, no-wrap
  714. msgid "\t\\[[!graph src=\"a -> b -> c; a -> c;\"]]\n"
  715. msgstr ""
  716. #. type: Plain text
  717. #: ikiwiki/directive/graph.mdwn:11
  718. msgid ""
  719. "Note that graphs will only show up in previews if your browser has "
  720. "[[!wikipedia data: URI]] support, or if the same graph already exists on "
  721. "that page."
  722. msgstr ""
  723. #. type: Plain text
  724. #: ikiwiki/directive/graph.mdwn:13
  725. msgid "The `graph` directive supports the following parameters:"
  726. msgstr ""
  727. #. type: Bullet: '- '
  728. #: ikiwiki/directive/graph.mdwn:22
  729. msgid "`src` - The graphviz source to render."
  730. msgstr ""
  731. #. type: Bullet: '- '
  732. #: ikiwiki/directive/graph.mdwn:22
  733. msgid ""
  734. "`type` - The type of graph to render: `graph` or `digraph`. Defaults to "
  735. "`digraph`."
  736. msgstr ""
  737. #. type: Bullet: '- '
  738. #: ikiwiki/directive/graph.mdwn:22
  739. msgid ""
  740. "`prog` - The graphviz program to render with: `dot`, `neato`, `fdp`, "
  741. "`twopi`, or `circo`. Defaults to `dot`."
  742. msgstr ""
  743. #. type: Bullet: '- '
  744. #: ikiwiki/directive/graph.mdwn:22
  745. msgid ""
  746. "`height`, `width` - Limit the size of the graph to a given height and width, "
  747. "in inches. You must specify both to limit the size; otherwise, graphviz will "
  748. "choose a size, without any limit."
  749. msgstr ""
  750. #. type: Plain text
  751. #: ikiwiki/directive/haiku.mdwn:2
  752. msgid ""
  753. "The `haiku` directive is supplied by the [[!iki plugins/haiku desc=haiku]] "
  754. "plugin."
  755. msgstr ""
  756. #. type: Plain text
  757. #: ikiwiki/directive/haiku.mdwn:5
  758. msgid ""
  759. "This directive allows inserting a randomly generated haiku into a wiki "
  760. "page. Just type:"
  761. msgstr ""
  762. #. type: Plain text
  763. #: ikiwiki/directive/haiku.mdwn:7
  764. #, no-wrap
  765. msgid "\t\\[[!haiku hint=\"argument\"]]\n"
  766. msgstr ""
  767. #. type: Plain text
  768. #: ikiwiki/directive/haiku.mdwn:8
  769. #, no-wrap
  770. msgid "[[!haiku hint=\"argument test\"]]\n"
  771. msgstr ""
  772. #. type: Plain text
  773. #: ikiwiki/directive/haiku.mdwn:14
  774. msgid ""
  775. "The hint parameter can be omitted, it only provides the generator a hint of "
  776. "what to write the haiku about. If no hint is given, it might base it on the "
  777. "page name. Since the vocabulary it knows is very small, many hints won't "
  778. "affect the result at all."
  779. msgstr ""
  780. #. type: Plain text
  781. #: ikiwiki/directive/if.mdwn:2
  782. msgid ""
  783. "The `if` directive is supplied by the [[!iki plugins/conditional "
  784. "desc=conditional]] plugin."
  785. msgstr ""
  786. #. type: Plain text
  787. #: ikiwiki/directive/if.mdwn:5
  788. msgid ""
  789. "With this directive, you can make text be conditionally displayed on a "
  790. "page. For example:"
  791. msgstr ""
  792. #. type: Plain text
  793. #: ikiwiki/directive/if.mdwn:9
  794. #, no-wrap
  795. msgid ""
  796. "\t\\[[!if test=\"enabled(smiley)\"\n"
  797. "\t then=\"The smiley plugin is enabled :-)\"\n"
  798. "\t else=\"No smiley plugin here..\"]]\n"
  799. msgstr ""
  800. #. type: Plain text
  801. #: ikiwiki/directive/if.mdwn:12
  802. msgid ""
  803. "If the specified `test` succeeds, the `then` text will be displayed, "
  804. "otherwise the `else` text will be displayed. The `else` part is optional."
  805. msgstr ""
  806. #. type: Plain text
  807. #: ikiwiki/directive/if.mdwn:16
  808. msgid ""
  809. "The `then` and `else` values can include any markup that would be allowed in "
  810. "the wiki page outside the template. Triple-quoting the values even allows "
  811. "quotes to be included."
  812. msgstr ""
  813. #. type: Plain text
  814. #: ikiwiki/directive/if.mdwn:21
  815. msgid ""
  816. "The `test` is a [[ikiwiki/PageSpec]]; if it matches any page in the wiki "
  817. "then it succeeds. So you can do things like testing for the existence of a "
  818. "page or pages, testing to see if any pages were created in a given month, "
  819. "and so on."
  820. msgstr ""
  821. #. type: Plain text
  822. #: ikiwiki/directive/if.mdwn:25
  823. msgid ""
  824. "If you want the [[ikiwiki/PageSpec]] to only match against the page that "
  825. "contains the conditional, rather than matching against all pages in the "
  826. "wiki, set the \"all\" parameter to \"no\"."
  827. msgstr ""
  828. #. type: Plain text
  829. #: ikiwiki/directive/if.mdwn:28
  830. msgid ""
  831. "In an `if` directive, the regular [[ikiwiki/PageSpec]] syntax is expanded "
  832. "with the following additional tests:"
  833. msgstr ""
  834. #. type: Bullet: '* '
  835. #: ikiwiki/directive/if.mdwn:30
  836. msgid "enabled(plugin)"
  837. msgstr ""
  838. #. type: Plain text
  839. #: ikiwiki/directive/if.mdwn:32
  840. #, no-wrap
  841. msgid " Tests whether the specified plugin is enabled.\n"
  842. msgstr ""
  843. #. type: Bullet: '* '
  844. #: ikiwiki/directive/if.mdwn:34
  845. msgid "sourcepage(glob)"
  846. msgstr ""
  847. #. type: Plain text
  848. #: ikiwiki/directive/if.mdwn:37
  849. #, no-wrap
  850. msgid ""
  851. " Tests whether the glob matches the name of the page that contains the\n"
  852. " conditional.\n"
  853. msgstr ""
  854. #. type: Bullet: '* '
  855. #: ikiwiki/directive/if.mdwn:39
  856. msgid "destpage(glob)"
  857. msgstr ""
  858. #. type: Plain text
  859. #: ikiwiki/directive/if.mdwn:43
  860. #, no-wrap
  861. msgid ""
  862. " Tests whether the glob matches the name of the page that is being built.\n"
  863. " That might be different than the name of the page that contains the\n"
  864. " conditional, if it's being inlined into another page.\n"
  865. msgstr ""
  866. #. type: Bullet: '* '
  867. #: ikiwiki/directive/if.mdwn:45
  868. msgid "included()"
  869. msgstr ""
  870. #. type: Plain text
  871. #: ikiwiki/directive/if.mdwn:47
  872. #, no-wrap
  873. msgid " Tests whether the page is being included onto another page.\n"
  874. msgstr ""
  875. #. type: Plain text
  876. #: ikiwiki/directive/img.mdwn:2
  877. msgid "The `img` directive is supplied by the [[!iki plugins/img desc=img]] plugin."
  878. msgstr ""
  879. #. type: Plain text
  880. #: ikiwiki/directive/img.mdwn:7
  881. msgid ""
  882. "This is an image handling directive. While ikiwiki supports inlining "
  883. "full-size images by making a [[ikiwiki/WikiLink]] that points to the image, "
  884. "using this directive you can easily scale down an image for inclusion onto a "
  885. "page, providing a link to a full-size version."
  886. msgstr ""
  887. #. type: Plain text
  888. #: ikiwiki/directive/img.mdwn:11
  889. #, no-wrap
  890. msgid "\t\\[[!img image1.jpg size=\"200x200\" alt=\"clouds\"]]\n"
  891. msgstr ""
  892. #. type: Plain text
  893. #: ikiwiki/directive/img.mdwn:14
  894. msgid ""
  895. "The image file will be searched for using the same rules as used to find the "
  896. "file pointed to by a [[ikiwiki/WikiLink]]."
  897. msgstr ""
  898. #. type: Plain text
  899. #: ikiwiki/directive/img.mdwn:20
  900. msgid ""
  901. "The `size` parameter is optional, defaulting to full size. Note that the "
  902. "original image's aspect ratio is always preserved, even if this means making "
  903. "the image smaller than the specified size. You can also specify only the "
  904. "width or the height, and the other value will be calculated based on it: "
  905. "\"200x\", \"x200\""
  906. msgstr ""
  907. #. type: Plain text
  908. #: ikiwiki/directive/img.mdwn:25
  909. msgid ""
  910. "You can also pass `alt`, `title`, `class`, `align`, `id`, `hspace`, and "
  911. "`vspace` parameters. These are passed through unchanged to the html img "
  912. "tag. If you include a `caption` parameter, the caption will be displayed "
  913. "centered beneath the image."
  914. msgstr ""
  915. #. type: Plain text
  916. #: ikiwiki/directive/img.mdwn:30
  917. msgid ""
  918. "The `link` parameter is used to control whether the scaled image links to "
  919. "the full size version. By default it does; set \"link=somepage\" to link to "
  920. "another page instead, or \"link=no\" to disable the link, or "
  921. "\"link=http://url\" to link to a given url."
  922. msgstr ""
  923. #. type: Plain text
  924. #: ikiwiki/directive/img.mdwn:33
  925. msgid ""
  926. "You can also set default values that will be applied to all later images on "
  927. "the page, unless overridden. Useful when including many images on a page."
  928. msgstr ""
  929. #. type: Plain text
  930. #: ikiwiki/directive/img.mdwn:38
  931. #, no-wrap
  932. msgid ""
  933. "\t\\[[!img defaults size=200x200 alt=\"wedding photo\"]]\n"
  934. "\t\\[[!img photo1.jpg]]\n"
  935. "\t\\[[!img photo2.jpg]]\n"
  936. "\t\\[[!img photo3.jpg size=200x600]]\n"
  937. msgstr ""
  938. #. type: Plain text
  939. #: ikiwiki/directive/inline.mdwn:2
  940. msgid ""
  941. "The `inline` directive is supplied by the [[!iki plugins/inline "
  942. "desc=inline]] plugin."
  943. msgstr ""
  944. #. type: Plain text
  945. #: ikiwiki/directive/inline.mdwn:5
  946. msgid ""
  947. "This is a directive that allows including one wiki page inside another. The "
  948. "most common use of inlining is generating blogs and RSS or Atom feeds."
  949. msgstr ""
  950. #. type: Plain text
  951. #: ikiwiki/directive/inline.mdwn:9
  952. #, no-wrap
  953. msgid ""
  954. "\t\\[[!inline pages=\"blog/* and !*/Discussion\" show=\"10\" "
  955. "rootpage=\"blog\"]]\n"
  956. msgstr ""
  957. #. type: Plain text
  958. #: ikiwiki/directive/inline.mdwn:15
  959. msgid ""
  960. "Any pages that match the specified [[PageSpec]] (in the example, any "
  961. "[[SubPage]] of \"blog\") will be part of the blog, and the newest 10 of them "
  962. "will appear in the page. Note that if files that are not pages match the "
  963. "[[PageSpec]], they will be included in the feed using RSS enclosures, which "
  964. "is useful for podcasting."
  965. msgstr ""
  966. #. type: Plain text
  967. #: ikiwiki/directive/inline.mdwn:19
  968. msgid ""
  969. "The optional `rootpage` parameter tells the wiki that new posts to this blog "
  970. "should default to being [[SubPages|SubPage]] of \"blog\", and enables a form "
  971. "at the top of the blog that can be used to add new items."
  972. msgstr ""
  973. #. type: Plain text
  974. #: ikiwiki/directive/inline.mdwn:22
  975. msgid ""
  976. "If you want your blog to have an archive page listing every post ever made "
  977. "to it, you can accomplish that like this:"
  978. msgstr ""
  979. #. type: Plain text
  980. #: ikiwiki/directive/inline.mdwn:24
  981. #, no-wrap
  982. msgid "\t\\[[!inline pages=\"blog/* and !*/Discussion\" archive=\"yes\"]]\n"
  983. msgstr ""
  984. #. type: Plain text
  985. #: ikiwiki/directive/inline.mdwn:27
  986. msgid ""
  987. "You can even create an automatically generated list of all the pages on the "
  988. "wiki, with the most recently added at the top, like this:"
  989. msgstr ""
  990. #. type: Plain text
  991. #: ikiwiki/directive/inline.mdwn:29
  992. #, no-wrap
  993. msgid "\t\\[[!inline pages=\"* and !*/Discussion\" archive=\"yes\"]]\n"
  994. msgstr ""
  995. #. type: Plain text
  996. #: ikiwiki/directive/inline.mdwn:34
  997. msgid ""
  998. "If you want to be able to add pages to a given blog feed by tagging them, "
  999. "you can do that too. To tag a page, just make it link to a page or pages "
  1000. "that represent its tags. Then use the special `link()` [[PageSpec]] to match "
  1001. "all pages that have a given tag:"
  1002. msgstr ""
  1003. #. type: Plain text
  1004. #: ikiwiki/directive/inline.mdwn:36
  1005. #, no-wrap
  1006. msgid "\t\\[[!inline pages=\"link(life)\"]]\n"
  1007. msgstr ""
  1008. #. type: Plain text
  1009. #: ikiwiki/directive/inline.mdwn:38
  1010. msgid "Or include some tags and exclude others:"
  1011. msgstr ""
  1012. #. type: Plain text
  1013. #: ikiwiki/directive/inline.mdwn:40
  1014. #, no-wrap
  1015. msgid "\t\\[[!inline pages=\"link(debian) and !link(social)\"]]\n"
  1016. msgstr ""
  1017. #. type: Plain text
  1018. #: ikiwiki/directive/inline.mdwn:45
  1019. msgid ""
  1020. "There are many parameters you can use with the `inline` directive. These are "
  1021. "the commonly used ones:"
  1022. msgstr ""
  1023. #. type: Bullet: '* '
  1024. #: ikiwiki/directive/inline.mdwn:62
  1025. msgid "`pages` - A [[PageSpec]] of the pages to inline."
  1026. msgstr ""
  1027. #. type: Bullet: '* '
  1028. #: ikiwiki/directive/inline.mdwn:62
  1029. msgid ""
  1030. "`show` - Specify the maximum number of matching pages to inline. Default is "
  1031. "10, unless archiving, when the default is to show all. Set to 0 to show all "
  1032. "matching pages."
  1033. msgstr ""
  1034. #. type: Bullet: '* '
  1035. #: ikiwiki/directive/inline.mdwn:62
  1036. msgid ""
  1037. "`archive` - If set to \"yes\", only list page titles and some metadata, not "
  1038. "full contents."
  1039. msgstr ""
  1040. #. type: Bullet: '* '
  1041. #: ikiwiki/directive/inline.mdwn:62
  1042. msgid ""
  1043. "`description` - Sets the description of the rss feed if one is generated. "
  1044. "Defaults to the name of the wiki."
  1045. msgstr ""
  1046. #. type: Bullet: '* '
  1047. #: ikiwiki/directive/inline.mdwn:62
  1048. msgid ""
  1049. "`skip` - Specify a number of pages to skip displaying. Can be useful to "
  1050. "produce a feed that only shows archived pages."
  1051. msgstr ""
  1052. #. type: Bullet: '* '
  1053. #: ikiwiki/directive/inline.mdwn:62
  1054. msgid "`postform` - Set to \"yes\" to enable a form to post new pages to a blog."
  1055. msgstr ""
  1056. #. type: Bullet: '* '
  1057. #: ikiwiki/directive/inline.mdwn:62
  1058. msgid "`postformtext` - Set to specify text that is displayed in a postform."
  1059. msgstr ""
  1060. #. type: Bullet: '* '
  1061. #: ikiwiki/directive/inline.mdwn:62
  1062. msgid ""
  1063. "`rootpage` - Enables the postform, and allows controling where newly posted "
  1064. "pages should go, by specifiying the page that they should be a [[SubPage]] "
  1065. "of."
  1066. msgstr ""
  1067. #. type: Plain text
  1068. #: ikiwiki/directive/inline.mdwn:64
  1069. msgid "Here are some less often needed parameters:"
  1070. msgstr ""
  1071. #. type: Bullet: '* '
  1072. #: ikiwiki/directive/inline.mdwn:117
  1073. msgid ""
  1074. "`actions` - If set to \"yes\" add links to the bottom of the inlined pages "
  1075. "for editing and discussion (if they would be shown at the top of the page "
  1076. "itself)."
  1077. msgstr ""
  1078. #. type: Bullet: '* '
  1079. #: ikiwiki/directive/inline.mdwn:117
  1080. msgid ""
  1081. "`rss` - controls generation of an rss feed. If the wiki is configured to "
  1082. "generate rss feeds by default, set to \"no\" to disable. If the wiki is "
  1083. "configured to `allowrss`, set to \"yes\" to enable."
  1084. msgstr ""
  1085. #. type: Bullet: '* '
  1086. #: ikiwiki/directive/inline.mdwn:117
  1087. msgid ""
  1088. "`atom` - controls generation of an atom feed. If the wiki is configured to "
  1089. "generate atom feeds by default, set to \"no\" to disable. If the wiki is "
  1090. "configured to `allowatom`, set to \"yes\" to enable."
  1091. msgstr ""
  1092. #. type: Bullet: '* '
  1093. #: ikiwiki/directive/inline.mdwn:117
  1094. msgid ""
  1095. "`feeds` - controls generation of all types of feeds. Set to \"no\" to "
  1096. "disable generating any feeds."
  1097. msgstr ""
  1098. #. type: Bullet: '* '
  1099. #: ikiwiki/directive/inline.mdwn:117
  1100. msgid ""
  1101. "`emptyfeeds` - Set to \"no\" to disable generation of empty feeds. Has no "
  1102. "effect if `rootpage` or `postform` is set."
  1103. msgstr ""
  1104. #. type: Bullet: '* '
  1105. #: ikiwiki/directive/inline.mdwn:117
  1106. msgid ""
  1107. "`template` - Specifies the template to fill out to display each inlined "
  1108. "page. By default the `inlinepage` template is used, while the `archivepage` "
  1109. "template is used for archives. Set this parameter to use some other, custom "
  1110. "template, such as the `titlepage` template that only shows post titles or "
  1111. "the `microblog` template, optimised for microblogging. Note that you should "
  1112. "still set `archive=yes` if your custom template does not include the page "
  1113. "content."
  1114. msgstr ""
  1115. #. type: Bullet: '* '
  1116. #: ikiwiki/directive/inline.mdwn:117
  1117. msgid ""
  1118. "`raw` - Rather than the default behavior of creating a blog, if raw is set "
  1119. "to \"yes\", the page will be included raw, without additional markup around "
  1120. "it, as if it were a literal part of the source of the inlining page."
  1121. msgstr ""
  1122. #. type: Bullet: '* '
  1123. #: ikiwiki/directive/inline.mdwn:117
  1124. msgid ""
  1125. "`sort` - Controls how inlined pages are [[sorted|pagespec/sorting]]. The "
  1126. "default is to sort the newest created pages first."
  1127. msgstr ""
  1128. #. type: Bullet: '* '
  1129. #: ikiwiki/directive/inline.mdwn:117
  1130. msgid "`reverse` - If set to \"yes\", causes the sort order to be reversed."
  1131. msgstr ""
  1132. #. type: Bullet: '* '
  1133. #: ikiwiki/directive/inline.mdwn:117
  1134. msgid ""
  1135. "`feedshow` - Specify the maximum number of matching pages to include in the "
  1136. "rss/atom feeds. The default is the same as the `show` value above."
  1137. msgstr ""
  1138. #. type: Bullet: '* '
  1139. #: ikiwiki/directive/inline.mdwn:117
  1140. msgid ""
  1141. "`feedonly` - Only generate the feed, do not display the pages inline on the "
  1142. "page."
  1143. msgstr ""
  1144. #. type: Bullet: '* '
  1145. #: ikiwiki/directive/inline.mdwn:117
  1146. msgid ""
  1147. "`quick` - Build archives in quick mode, without reading page contents for "
  1148. "metadata. This also turns off generation of any feeds."
  1149. msgstr ""
  1150. #. type: Bullet: '* '
  1151. #: ikiwiki/directive/inline.mdwn:117
  1152. msgid ""
  1153. "`timeformat` - Use this to specify how to display the time or date for pages "
  1154. "in the blog. The format string is passed to the strftime(3) function."
  1155. msgstr ""
  1156. #. type: Bullet: '* '
  1157. #: ikiwiki/directive/inline.mdwn:117
  1158. msgid ""
  1159. "`feedpages` - A [[PageSpec]] of inlined pages to include in the rss/atom "
  1160. "feeds. The default is the same as the `pages` value above, and only pages "
  1161. "matched by that value are included, but some of those can be excluded by "
  1162. "specifying a tighter [[PageSpec]] here."
  1163. msgstr ""
  1164. #. type: Bullet: '* '
  1165. #: ikiwiki/directive/inline.mdwn:117
  1166. msgid ""
  1167. "`guid` - If a URI is given here (perhaps a UUID prefixed with `urn:uuid:`), "
  1168. "the Atom feed will have this as its `<id>`. The default is to use the URL of "
  1169. "the page containing the `inline` directive."
  1170. msgstr ""
  1171. #. type: Bullet: '* '
  1172. #: ikiwiki/directive/inline.mdwn:117
  1173. msgid ""
  1174. "`feedfile` - Can be used to change the name of the file generated for the "
  1175. "feed. This is particularly useful if a page contains multiple feeds. For "
  1176. "example, set \"feedfile=feed\" to cause it to generate `page/feed.atom` "
  1177. "and/or `page/feed.rss`. This option is not supported if the wiki is "
  1178. "configured not to use `usedirs`."
  1179. msgstr ""
  1180. #. type: Bullet: '* '
  1181. #: ikiwiki/directive/inline.mdwn:117
  1182. msgid ""
  1183. "`pagenames` - If given instead of `pages`, this is interpreted as a "
  1184. "space-separated list of links to pages (with the same "
  1185. "[[SubPage/LinkingRules]] as in a [[ikiwiki/WikiLink]]), and they are inlined "
  1186. "in exactly the order given: the `sort` and `pages` parameters cannot be used "
  1187. "in conjunction with this one."
  1188. msgstr ""
  1189. #. type: Plain text
  1190. #: ikiwiki/directive/inline.mdwn:121
  1191. msgid ""
  1192. "A related directive is the [[ikiwiki/directive/edittemplate]] directive, "
  1193. "which allows default text for a new page to be specified."
  1194. msgstr ""
  1195. #. type: Plain text
  1196. #: ikiwiki/directive/linkmap.mdwn:2
  1197. msgid ""
  1198. "The `linkmap` directive is supplied by the [[!iki plugins/linkmap "
  1199. "desc=linkmap]] plugin."
  1200. msgstr ""
  1201. #. type: Plain text
  1202. #: ikiwiki/directive/linkmap.mdwn:5
  1203. msgid ""
  1204. "This directive uses [graphviz](http://www.graphviz.org/) to generate a graph "
  1205. "showing the links between a set of pages in the wiki. Example usage:"
  1206. msgstr ""
  1207. #. type: Plain text
  1208. #: ikiwiki/directive/linkmap.mdwn:7
  1209. #, no-wrap
  1210. msgid "\t\\[[!linkmap pages=\"* and !blog/* and !*/Discussion\"]]\n"
  1211. msgstr ""
  1212. #. type: Plain text
  1213. #: ikiwiki/directive/linkmap.mdwn:11
  1214. msgid ""
  1215. "Only links between mapped pages will be shown; links pointing to or from "
  1216. "unmapped pages will be omitted. If the pages to include are not specified, "
  1217. "the links between all pages (and other files) in the wiki are mapped."
  1218. msgstr ""
  1219. #. type: Plain text
  1220. #: ikiwiki/directive/linkmap.mdwn:14
  1221. msgid ""
  1222. "Here are descriptions of all the supported parameters to the `linkmap` "
  1223. "directive:"
  1224. msgstr ""
  1225. #. type: Bullet: '* '
  1226. #: ikiwiki/directive/linkmap.mdwn:22
  1227. msgid "`pages` - A [[ikiwiki/PageSpec]] of the pages to map."
  1228. msgstr ""
  1229. #. type: Bullet: '* '
  1230. #: ikiwiki/directive/linkmap.mdwn:22
  1231. msgid ""
  1232. "`height`, `width` - Limit the size of the map to a given height and width, "
  1233. "in inches. Both must be specified for the limiting to take effect, otherwise "
  1234. "the map's size is not limited."
  1235. msgstr ""
  1236. #. type: Bullet: '* '
  1237. #: ikiwiki/directive/linkmap.mdwn:22
  1238. msgid ""
  1239. "`connected` - Controls whether to include pages on the map that link to no "
  1240. "other pages (connected=no, the default), or to only show pages that link to "
  1241. "others (connected=yes)."
  1242. msgstr ""
  1243. #. type: Plain text
  1244. #: ikiwiki/directive/linkmap.mdwn:28
  1245. msgid ""
  1246. "For best results, only a small set of pages should be mapped, since "
  1247. "otherwise the map can become very large, unwieldy, and complicated. If too "
  1248. "many pages are included, the map may get so large that graphviz cannot "
  1249. "render it. Using the `connected` parameter is a good way to prune out pages "
  1250. "that clutter the map."
  1251. msgstr ""
  1252. #. type: Plain text
  1253. #: ikiwiki/directive/listdirectives.mdwn:2
  1254. msgid ""
  1255. "The `listdirectives` directive is supplied by the [[!iki "
  1256. "plugins/listdirectives desc=listdirectives]] plugin."
  1257. msgstr ""
  1258. #. type: Plain text
  1259. #: ikiwiki/directive/listdirectives.mdwn:5
  1260. msgid ""
  1261. "This directive generates a list of available "
  1262. "[[directives|ikiwiki/directive]]."
  1263. msgstr ""
  1264. #. type: Plain text
  1265. #: ikiwiki/directive/listdirectives.mdwn:7
  1266. #, no-wrap
  1267. msgid "\t\\[[!listdirectives]]\n"
  1268. msgstr ""
  1269. #. type: Plain text
  1270. #: ikiwiki/directive/listdirectives.mdwn:14
  1271. msgid ""
  1272. "There is one optional keyword argument, `generated`. Normally the "
  1273. "`listdirectives` directive will list all built in directives and directives "
  1274. "directly registered by plugins. With this keyword, `listdirectives` will "
  1275. "also list directives generated later. For example, all [[shortcuts]] are "
  1276. "directives generated in turn by the `shortcut` directive. They will only be "
  1277. "listed if the `generated` argument is supplied."
  1278. msgstr ""
  1279. #. type: Plain text
  1280. #: ikiwiki/directive/listdirectives.mdwn:16
  1281. #, no-wrap
  1282. msgid " \\[[!listdirectives generated]]\n"
  1283. msgstr ""
  1284. #. type: Plain text
  1285. #: ikiwiki/directive/listdirectives.mdwn:19
  1286. msgid ""
  1287. "This extended list is often quite long, and often contains many undocumented "
  1288. "directives."
  1289. msgstr ""
  1290. #. type: Plain text
  1291. #: ikiwiki/directive/map.mdwn:2
  1292. msgid "The `map` directive is supplied by the [[!iki plugins/map desc=map]] plugin."
  1293. msgstr ""
  1294. #. type: Plain text
  1295. #: ikiwiki/directive/map.mdwn:4
  1296. msgid ""
  1297. "This directive generates a hierarchical page map for the wiki. Example "
  1298. "usage:"
  1299. msgstr ""
  1300. #. type: Plain text
  1301. #: ikiwiki/directive/map.mdwn:6
  1302. #, no-wrap
  1303. msgid "\t\\[[!map pages=\"* and !blog/* and !*/Discussion\"]]\n"
  1304. msgstr ""
  1305. #. type: Plain text
  1306. #: ikiwiki/directive/map.mdwn:9
  1307. msgid ""
  1308. "If the pages to include are not specified, all pages (and other files) in "
  1309. "the wiki are mapped."
  1310. msgstr ""
  1311. #. type: Plain text
  1312. #: ikiwiki/directive/map.mdwn:13
  1313. msgid ""
  1314. "By default, the names of pages are shown in the map. The `show` parameter "
  1315. "can be used to show the titles or descriptions of pages instead (as set by "
  1316. "the [[meta]] directive). For example:"
  1317. msgstr ""
  1318. #. type: Plain text
  1319. #: ikiwiki/directive/map.mdwn:15
  1320. #, no-wrap
  1321. msgid "\t\\[[!map pages=\"* and !blog/* and !*/Discussion\" show=title]]\n"
  1322. msgstr ""
  1323. #. type: Plain text
  1324. #: ikiwiki/directive/map.mdwn:17
  1325. #, no-wrap
  1326. msgid "\t\\[[!map pages=\"* and !blog/* and !*/Discussion\" show=description]]\n"
  1327. msgstr ""
  1328. #. type: Plain text
  1329. #: ikiwiki/directive/map.mdwn:20
  1330. msgid ""
  1331. "Hint: To limit the map to displaying pages less than a certain level deep, "
  1332. "use a [[ikiwiki/PageSpec]] like this: `pages=\"* and !*/*/*\"`"
  1333. msgstr ""
  1334. #. type: Plain text
  1335. #: ikiwiki/directive/meta.mdwn:2
  1336. msgid ""
  1337. "The `meta` directive is supplied by the [[!iki plugins/meta desc=meta]] "
  1338. "plugin."
  1339. msgstr ""
  1340. #. type: Plain text
  1341. #: ikiwiki/directive/meta.mdwn:5
  1342. msgid ""
  1343. "This directive allows inserting arbitrary metadata into the source of a "
  1344. "page. Enter the metadata as follows:"
  1345. msgstr ""
  1346. #. type: Plain text
  1347. #: ikiwiki/directive/meta.mdwn:8
  1348. #, no-wrap
  1349. msgid ""
  1350. "\t\\[[!meta field=\"value\"]]\n"
  1351. "\t\\[[!meta field=\"value\" param=\"value\" param=\"value\"]]\n"
  1352. msgstr ""
  1353. #. type: Plain text
  1354. #: ikiwiki/directive/meta.mdwn:11
  1355. msgid ""
  1356. "The first form sets a given field to a given value, while the second form "
  1357. "also specifies some additional sub-parameters."
  1358. msgstr ""
  1359. #. type: Plain text
  1360. #: ikiwiki/directive/meta.mdwn:14
  1361. msgid ""
  1362. "The field values are treated as HTML entity-escaped text, so you can include "
  1363. "a quote in the text by writing `&quot;` and so on."
  1364. msgstr ""
  1365. #. type: Plain text
  1366. #: ikiwiki/directive/meta.mdwn:16
  1367. msgid "Supported fields:"
  1368. msgstr ""
  1369. #. type: Bullet: '* '
  1370. #: ikiwiki/directive/meta.mdwn:18
  1371. msgid "title"
  1372. msgstr ""
  1373. #. type: Plain text
  1374. #: ikiwiki/directive/meta.mdwn:21
  1375. #, no-wrap
  1376. msgid ""
  1377. " Overrides the title of the page, which is generally the same as the\n"
  1378. " page name.\n"
  1379. msgstr ""
  1380. #. type: Plain text
  1381. #: ikiwiki/directive/meta.mdwn:25
  1382. #, no-wrap
  1383. msgid ""
  1384. " Note that if the title is overridden, a \"title_overridden\" variable "
  1385. "will\n"
  1386. " be set to a true value in the template; this can be used to format "
  1387. "things\n"
  1388. " differently in this case.\n"
  1389. msgstr ""
  1390. #. type: Plain text
  1391. #: ikiwiki/directive/meta.mdwn:28
  1392. #, no-wrap
  1393. msgid ""
  1394. " An optional `sortas` parameter will be used preferentially when\n"
  1395. " [[ikiwiki/pagespec/sorting]] by `meta(title)`:\n"
  1396. msgstr ""
  1397. #. type: Plain text
  1398. #: ikiwiki/directive/meta.mdwn:30
  1399. #, no-wrap
  1400. msgid "\t\\[[!meta title=\"The Beatles\" sortas=\"Beatles, The\"]]\n"
  1401. msgstr ""
  1402. #. type: Plain text
  1403. #: ikiwiki/directive/meta.mdwn:32
  1404. #, no-wrap
  1405. msgid "\t\\[[!meta title=\"David Bowie\" sortas=\"Bowie, David\"]]\n"
  1406. msgstr ""
  1407. #. type: Bullet: '* '
  1408. #: ikiwiki/directive/meta.mdwn:34
  1409. msgid "license"
  1410. msgstr ""
  1411. #. type: Plain text
  1412. #: ikiwiki/directive/meta.mdwn:37
  1413. #, no-wrap
  1414. msgid ""
  1415. " Specifies a license for the page, for example, \"GPL\". Can contain\n"
  1416. " WikiLinks and arbitrary markup.\n"
  1417. msgstr ""
  1418. #. type: Bullet: '* '
  1419. #: ikiwiki/directive/meta.mdwn:39
  1420. msgid "copyright"
  1421. msgstr ""
  1422. #. type: Plain text
  1423. #: ikiwiki/directive/meta.mdwn:42
  1424. #, no-wrap
  1425. msgid ""
  1426. " Specifies the copyright of the page, for example, \"Copyright 2007 by\n"
  1427. " Joey Hess\". Can contain WikiLinks and arbitrary markup.\n"
  1428. msgstr ""
  1429. #. type: Bullet: '* '
  1430. #: ikiwiki/directive/meta.mdwn:44
  1431. msgid "author"
  1432. msgstr ""
  1433. #. type: Plain text
  1434. #: ikiwiki/directive/meta.mdwn:46
  1435. #, no-wrap
  1436. msgid " Specifies the author of a page.\n"
  1437. msgstr ""
  1438. #. type: Plain text
  1439. #: ikiwiki/directive/meta.mdwn:49
  1440. #, no-wrap
  1441. msgid ""
  1442. " An optional `sortas` parameter will be used preferentially when\n"
  1443. " [[ikiwiki/pagespec/sorting]] by `meta(author)`:\n"
  1444. msgstr ""
  1445. #. type: Plain text
  1446. #: ikiwiki/directive/meta.mdwn:51
  1447. #, no-wrap
  1448. msgid "\t\\[[!meta author=\"Joey Hess\" sortas=\"Hess, Joey\"]]\n"
  1449. msgstr ""
  1450. #. type: Bullet: '* '
  1451. #: ikiwiki/directive/meta.mdwn:53
  1452. msgid "authorurl"
  1453. msgstr ""
  1454. #. type: Plain text
  1455. #: ikiwiki/directive/meta.mdwn:55
  1456. #, no-wrap
  1457. msgid " Specifies an url for the author of a page.\n"
  1458. msgstr ""
  1459. #. type: Bullet: '* '
  1460. #: ikiwiki/directive/meta.mdwn:57
  1461. msgid "description"
  1462. msgstr ""
  1463. #. type: Plain text
  1464. #: ikiwiki/directive/meta.mdwn:60
  1465. #, no-wrap
  1466. msgid ""
  1467. " Specifies a short description for the page. This will be put in\n"
  1468. " the html header, and can also be displayed by eg, the [[map]] directive.\n"
  1469. msgstr ""
  1470. #. type: Bullet: '* '
  1471. #: ikiwiki/directive/meta.mdwn:62
  1472. msgid "permalink"
  1473. msgstr ""
  1474. #. type: Plain text
  1475. #: ikiwiki/directive/meta.mdwn:65
  1476. #, no-wrap
  1477. msgid ""
  1478. " Specifies a permanent link to the page, if different than the page\n"
  1479. " generated by ikiwiki.\n"
  1480. msgstr ""
  1481. #. type: Bullet: '* '
  1482. #: ikiwiki/directive/meta.mdwn:67
  1483. msgid "date"
  1484. msgstr ""
  1485. #. type: Plain text
  1486. #: ikiwiki/directive/meta.mdwn:70
  1487. #, no-wrap
  1488. msgid ""
  1489. " Specifies the creation date of the page. The date can be entered in\n"
  1490. " nearly any format, since it's parsed by [[!cpan TimeDate]].\n"
  1491. msgstr ""
  1492. #. type: Bullet: '* '
  1493. #: ikiwiki/directive/meta.mdwn:72
  1494. msgid "stylesheet"
  1495. msgstr ""
  1496. #. type: Plain text
  1497. #: ikiwiki/directive/meta.mdwn:76
  1498. #, no-wrap
  1499. msgid ""
  1500. " Adds a stylesheet to a page. The stylesheet is treated as a wiki link to\n"
  1501. " a `.css` file in the wiki, so it cannot be used to add links to external\n"
  1502. " stylesheets. Example:\n"
  1503. msgstr ""
  1504. #. type: Plain text
  1505. #: ikiwiki/directive/meta.mdwn:79
  1506. #, no-wrap
  1507. msgid ""
  1508. "\t\\[[!meta stylesheet=somestyle rel=\"alternate stylesheet\"\n"
  1509. "\ttitle=\"somestyle\"]]\n"
  1510. msgstr ""
  1511. #. type: Bullet: '* '
  1512. #: ikiwiki/directive/meta.mdwn:81
  1513. msgid "openid"
  1514. msgstr ""
  1515. #. type: Plain text
  1516. #: ikiwiki/directive/meta.mdwn:84
  1517. #, no-wrap
  1518. msgid ""
  1519. " Adds html &lt;link&gt; tags to perform OpenID delegation to an external\n"
  1520. " OpenID server. This lets you use an ikiwiki page as your OpenID.\n"
  1521. msgstr ""
  1522. #. type: Plain text
  1523. #: ikiwiki/directive/meta.mdwn:87
  1524. #, no-wrap
  1525. msgid ""
  1526. " By default this will delegate for both `openid` and `openid2`. To only\n"
  1527. " delegate for one, add a parameter such as `delegate=openid`.\n"
  1528. msgstr ""
  1529. #. type: Plain text
  1530. #: ikiwiki/directive/meta.mdwn:91
  1531. #, no-wrap
  1532. msgid ""
  1533. " An optional `xrds-location`\n"
  1534. " parameter lets you specify the location of any [eXtensible Resource\n"
  1535. " DescriptorS](http://www.windley.com/archives/2007/05/using_xrds.shtml).\n"
  1536. msgstr ""
  1537. #. type: Plain text
  1538. #: ikiwiki/directive/meta.mdwn:93
  1539. #, no-wrap
  1540. msgid " Example:\n"
  1541. msgstr ""
  1542. #. type: Plain text
  1543. #: ikiwiki/directive/meta.mdwn:97
  1544. #, no-wrap
  1545. msgid ""
  1546. "\t\\\\[[!meta openid=\"http://joeyh.myopenid.com/\"\n"
  1547. "\tserver=\"http://www.myopenid.com/server\"\n"
  1548. "\txrds-location=\"http://www.myopenid.com/xrds?username=joeyh.myopenid.com\"\"]]\n"
  1549. msgstr ""
  1550. #. type: Bullet: '* '
  1551. #: ikiwiki/directive/meta.mdwn:99
  1552. msgid "link"
  1553. msgstr ""
  1554. #. type: Plain text
  1555. #: ikiwiki/directive/meta.mdwn:103
  1556. #, no-wrap
  1557. msgid ""
  1558. " Specifies a link to another page. This can be used as a way to make the\n"
  1559. " wiki treat one page as linking to another without displaying a "
  1560. "user-visible\n"
  1561. " [[ikiwiki/WikiLink]]:\n"
  1562. msgstr ""
  1563. #. type: Plain text
  1564. #: ikiwiki/directive/meta.mdwn:105
  1565. #, no-wrap
  1566. msgid " \\[[!meta link=otherpage]]\n"
  1567. msgstr ""
  1568. #. type: Plain text
  1569. #: ikiwiki/directive/meta.mdwn:107
  1570. #, no-wrap
  1571. msgid " It can also be used to insert a html &lt;link&gt; tag. For example:\n"
  1572. msgstr ""
  1573. #. type: Plain text
  1574. #: ikiwiki/directive/meta.mdwn:109
  1575. #, no-wrap
  1576. msgid ""
  1577. " \\[[!meta link=\"http://joeyh.myopenid.com/\" "
  1578. "rel=\"openid.delegate\"]]\n"
  1579. msgstr ""
  1580. #. type: Plain text
  1581. #: ikiwiki/directive/meta.mdwn:113 ikiwiki/directive/meta.mdwn:130
  1582. #, no-wrap
  1583. msgid ""
  1584. " However, this latter syntax won't be allowed if the \n"
  1585. " [[!iki plugins/htmlscrubber desc=htmlscrubber]] plugin is enabled, since "
  1586. "it can be used to\n"
  1587. " insert unsafe content.\n"
  1588. msgstr ""
  1589. #. type: Bullet: '* '
  1590. #: ikiwiki/directive/meta.mdwn:115
  1591. msgid "redir"
  1592. msgstr ""
  1593. #. type: Plain text
  1594. #: ikiwiki/directive/meta.mdwn:117
  1595. #, no-wrap
  1596. msgid " Causes the page to redirect to another page in the wiki.\n"
  1597. msgstr ""
  1598. #. type: Plain text
  1599. #: ikiwiki/directive/meta.mdwn:119
  1600. #, no-wrap
  1601. msgid " \t\\[[!meta redir=otherpage]]\n"
  1602. msgstr ""
  1603. #. type: Plain text
  1604. #: ikiwiki/directive/meta.mdwn:122
  1605. #, no-wrap
  1606. msgid ""
  1607. " Optionally, a delay (in seconds) can be specified. The default is to\n"
  1608. " redirect without delay.\n"
  1609. msgstr ""
  1610. #. type: Plain text
  1611. #: ikiwiki/directive/meta.mdwn:124
  1612. #, no-wrap
  1613. msgid " It can also be used to redirect to an external url. For example:\n"
  1614. msgstr ""
  1615. #. type: Plain text
  1616. #: ikiwiki/directive/meta.mdwn:126
  1617. #, no-wrap
  1618. msgid " \t\\[[!meta redir=\"http://example.com/\"]]\n"
  1619. msgstr ""
  1620. #. type: Plain text
  1621. #: ikiwiki/directive/meta.mdwn:133
  1622. #, no-wrap
  1623. msgid ""
  1624. " For both cases, an anchor to jump to inside the destination page may also "
  1625. "be\n"
  1626. " specified using the common `#ANCHOR` syntax.\n"
  1627. msgstr ""
  1628. #. type: Bullet: '* '
  1629. #: ikiwiki/directive/meta.mdwn:135
  1630. msgid "robots"
  1631. msgstr ""
  1632. #. type: Plain text
  1633. #: ikiwiki/directive/meta.mdwn:137
  1634. #, no-wrap
  1635. msgid " Causes the robots meta tag to be written:\n"
  1636. msgstr ""
  1637. #. type: Plain text
  1638. #: ikiwiki/directive/meta.mdwn:139
  1639. #, no-wrap
  1640. msgid " \\[[!meta robots=\"index, nofollow\"]]\n"
  1641. msgstr ""
  1642. #. type: Plain text
  1643. #: ikiwiki/directive/meta.mdwn:144
  1644. #, no-wrap
  1645. msgid ""
  1646. " Valid values for the attribute are: \"index\", \"noindex\", \"follow\", "
  1647. "and\n"
  1648. " \"nofollow\". Multiple comma-separated values are allowed, but obviously "
  1649. "only\n"
  1650. " some combinations make sense. If there is no robots meta tag, \"index,\n"
  1651. " follow\" is used as the default.\n"
  1652. msgstr ""
  1653. #. type: Plain text
  1654. #: ikiwiki/directive/meta.mdwn:146
  1655. #, no-wrap
  1656. msgid " The value is escaped, but its contents are not otherwise checked.\n"
  1657. msgstr ""
  1658. #. type: Bullet: '* '
  1659. #: ikiwiki/directive/meta.mdwn:148
  1660. msgid "guid"
  1661. msgstr ""
  1662. #. type: Plain text
  1663. #: ikiwiki/directive/meta.mdwn:154
  1664. #, no-wrap
  1665. msgid ""
  1666. " Specifies a globally unique ID for a page. This guid should be a URI\n"
  1667. " (in particular, it can be `urn:uuid:` followed by a UUID, as per\n"
  1668. " [[!rfc 4122]]), and it will be used to identify the page's entry in RSS\n"
  1669. " and Atom feeds. If not given, the default is to use the page's URL as "
  1670. "its\n"
  1671. " guid.\n"
  1672. msgstr ""
  1673. #. type: Plain text
  1674. #: ikiwiki/directive/meta.mdwn:158
  1675. #, no-wrap
  1676. msgid ""
  1677. " This is mostly useful when a page has moved, to keep the guids for\n"
  1678. " pages unchanged and avoid_flooding_aggregators\n"
  1679. " (see [[!iki tips/howto_avoid_flooding_aggregators]]).\n"
  1680. msgstr ""
  1681. #. type: Bullet: '* '
  1682. #: ikiwiki/directive/meta.mdwn:160
  1683. msgid "updated"
  1684. msgstr ""
  1685. #. type: Plain text
  1686. #: ikiwiki/directive/meta.mdwn:167
  1687. #, no-wrap
  1688. msgid ""
  1689. " Specifies a fake modification time for a page, to be output into RSS and\n"
  1690. " Atom feeds. This is useful to avoid flooding aggregators that sort by\n"
  1691. " modification time, like Planet: for instance, when editing an old blog "
  1692. "post\n"
  1693. " to add tags, you could set `updated` to be one second later than the "
  1694. "original\n"
  1695. " value. The date/time can be given in any format that\n"
  1696. " [[!cpan TimeDate]] can understand, just like the `date` field.\n"
  1697. msgstr ""
  1698. #. type: Plain text
  1699. #: ikiwiki/directive/meta.mdwn:172
  1700. msgid ""
  1701. "If the field is not one of the above predefined fields, the metadata will be "
  1702. "written to the generated html page as a &lt;meta&gt; header. However, this "
  1703. "won't be allowed if the [[!iki plugins/htmlscrubber desc=htmlscrubber]] "
  1704. "plugin is enabled, since it can be used to insert unsafe content."
  1705. msgstr ""
  1706. #. type: Plain text
  1707. #: ikiwiki/directive/more.mdwn:2
  1708. msgid ""
  1709. "The `more` directive is supplied by the [[!iki plugins/more desc=more]] "
  1710. "plugin."
  1711. msgstr ""
  1712. #. type: Plain text
  1713. #: ikiwiki/directive/more.mdwn:5
  1714. msgid ""
  1715. "This directive provides a way to have a \"more\" link on a post in a blog, "
  1716. "that leads to the full version of the page. Use it like this:"
  1717. msgstr ""
  1718. #. type: Plain text
  1719. #: ikiwiki/directive/more.mdwn:6
  1720. #, no-wrap
  1721. msgid "\t\\[[!more linktext=\"click for more\" text=\"\"\"\n"
  1722. msgstr ""
  1723. #. type: Plain text
  1724. #: ikiwiki/directive/more.mdwn:10
  1725. #, no-wrap
  1726. msgid ""
  1727. "\tThis is the rest of my post. Not intended for people catching up on\n"
  1728. "\ttheir blogs at 30,000 feet. Because I like to make things\n"
  1729. "\tdifficult.\n"
  1730. msgstr ""
  1731. #. type: Plain text
  1732. #: ikiwiki/directive/more.mdwn:13
  1733. msgid "If the `linktext` parameter is omitted it defaults to just \"more\"."
  1734. msgstr ""
  1735. #. type: Plain text
  1736. #: ikiwiki/directive/more.mdwn:15
  1737. msgid "Note that you can accomplish something similar using a [[toggle]] instead."
  1738. msgstr ""
  1739. #. type: Plain text
  1740. #: ikiwiki/directive/orphans.mdwn:2
  1741. msgid ""
  1742. "The `orphans` directive is supplied by the [[!iki plugins/orphans "
  1743. "desc=orphans]] plugin."
  1744. msgstr ""
  1745. #. type: Plain text
  1746. #: ikiwiki/directive/orphans.mdwn:5
  1747. msgid ""
  1748. "This directive generates a list of possibly orphaned pages -- pages that no "
  1749. "other page links to. Example:"
  1750. msgstr ""
  1751. #. type: Plain text
  1752. #: ikiwiki/directive/orphans.mdwn:7
  1753. #, no-wrap
  1754. msgid "\t\\[[!orphans pages=\"* and !blog/*\"]]\n"
  1755. msgstr ""
  1756. #. type: Plain text
  1757. #: ikiwiki/directive/orphans.mdwn:10
  1758. msgid ""
  1759. "The optional parameter \"pages\" can be a [[ikiwiki/PageSpec]] specifying "
  1760. "the pages to check for orphans, default is search them all."
  1761. msgstr ""
  1762. #. type: Plain text
  1763. #: ikiwiki/directive/orphans.mdwn:14
  1764. msgid ""
  1765. "Note that it takes backlinks into account, but does not count inlining a "
  1766. "page as linking to it, so will generally count many blog-type pages as "
  1767. "orphans."
  1768. msgstr ""
  1769. #. type: Plain text
  1770. #: ikiwiki/directive/pagecount.mdwn:2
  1771. msgid ""
  1772. "The `pagecount` directive is supplied by the [[!iki plugins/pagecount "
  1773. "desc=pagecount]] plugin."
  1774. msgstr ""
  1775. #. type: Plain text
  1776. #: ikiwiki/directive/pagecount.mdwn:4
  1777. msgid "This directive counts pages currently in the wiki. Example:"
  1778. msgstr ""
  1779. #. type: Plain text
  1780. #: ikiwiki/directive/pagecount.mdwn:6
  1781. #, no-wrap
  1782. msgid "\t\\[[!pagecount pages=\"*\"]]\n"
  1783. msgstr ""
  1784. #. type: Plain text
  1785. #: ikiwiki/directive/pagecount.mdwn:9
  1786. msgid ""
  1787. "The optional parameter \"pages\" can be a [[ikiwiki/PageSpec]] specifying "
  1788. "the pages to count, default is to count them all."
  1789. msgstr ""
  1790. #. type: Plain text
  1791. #: ikiwiki/directive/pagestats.mdwn:2
  1792. msgid ""
  1793. "The `pagestats` directive is supplied by the [[!iki plugins/pagestats "
  1794. "desc=pagestats]] plugin."
  1795. msgstr ""
  1796. #. type: Plain text
  1797. #: ikiwiki/directive/pagestats.mdwn:6
  1798. msgid ""
  1799. "This directive can generate stats about how pages link to each other. It can "
  1800. "produce either a tag cloud, or a table counting the number of links to each "
  1801. "page."
  1802. msgstr ""
  1803. #. type: Plain text
  1804. #: ikiwiki/directive/pagestats.mdwn:9
  1805. msgid ""
  1806. "Here's how to use it to create a [[tag]] cloud, with tags sized based on "
  1807. "frequency of use:"
  1808. msgstr ""
  1809. #. type: Plain text
  1810. #: ikiwiki/directive/pagestats.mdwn:11
  1811. #, no-wrap
  1812. msgid "\t\\[[!pagestats pages=\"tags/*\"]]\n"
  1813. msgstr ""
  1814. #. type: Plain text
  1815. #: ikiwiki/directive/pagestats.mdwn:14
  1816. msgid ""
  1817. "Here's how to create a list of tags, sized by use as they would be in a "
  1818. "cloud."
  1819. msgstr ""
  1820. #. type: Plain text
  1821. #: ikiwiki/directive/pagestats.mdwn:16
  1822. #, no-wrap
  1823. msgid "\t\\[[!pagestats style=\"list\" pages=\"tags/*\"]]\n"
  1824. msgstr ""
  1825. #. type: Plain text
  1826. #: ikiwiki/directive/pagestats.mdwn:18
  1827. msgid "And here's how to create a table of all the pages on the wiki:"
  1828. msgstr ""
  1829. #. type: Plain text
  1830. #: ikiwiki/directive/pagestats.mdwn:20
  1831. #, no-wrap
  1832. msgid "\t\\[[!pagestats style=\"table\"]]\n"
  1833. msgstr ""
  1834. #. type: Plain text
  1835. #: ikiwiki/directive/pagestats.mdwn:24
  1836. msgid ""
  1837. "The optional `among` parameter limits the pages whose outgoing links are "
  1838. "considered. For instance, to display a cloud of tags used on blog entries, "
  1839. "while ignoring other pages that use those tags, you could use:"
  1840. msgstr ""
  1841. #. type: Plain text
  1842. #: ikiwiki/directive/pagestats.mdwn:26
  1843. #, no-wrap
  1844. msgid "\t\\[[!pagestats pages=\"tags/*\" among=\"blog/posts/*\"]]\n"
  1845. msgstr ""
  1846. #. type: Plain text
  1847. #: ikiwiki/directive/pagestats.mdwn:28
  1848. msgid "Or to display a cloud of tags related to Linux, you could use:"
  1849. msgstr ""
  1850. #. type: Plain text
  1851. #: ikiwiki/directive/pagestats.mdwn:30
  1852. #, no-wrap
  1853. msgid ""
  1854. "\t\\[[!pagestats pages=\"tags/* and not tags/linux\" "
  1855. "among=\"tagged(linux)\"]]\n"
  1856. msgstr ""
  1857. #. type: Plain text
  1858. #: ikiwiki/directive/pagestats.mdwn:34
  1859. msgid ""
  1860. "The optional `show` parameter limits display to the specified number of "
  1861. "pages. For instance, to show a table of the top ten pages with the most "
  1862. "links:"
  1863. msgstr ""
  1864. #. type: Plain text
  1865. #: ikiwiki/directive/pagestats.mdwn:36
  1866. #, no-wrap
  1867. msgid "\t\\[[!pagestats style=\"table\" show=\"10\"]]\n"
  1868. msgstr ""
  1869. #. type: Plain text
  1870. #: ikiwiki/directive/pagestats.mdwn:39
  1871. msgid ""
  1872. "The optional `class` parameter can be used to control the class of the "
  1873. "generated tag cloud `div` or page stats `table`."
  1874. msgstr ""
  1875. #. type: Plain text
  1876. #: ikiwiki/directive/pagetemplate.mdwn:2
  1877. msgid ""
  1878. "The `pagetemplate` directive is supplied by the [[!iki plugins/pagetemplate "
  1879. "desc=pagetemplate]] plugin."
  1880. msgstr ""
  1881. #. type: Plain text
  1882. #: ikiwiki/directive/pagetemplate.mdwn:5
  1883. msgid ""
  1884. "This directive allows a page to be displayed using a different "
  1885. "[[template|templates]] than the default `page.tmpl` template."
  1886. msgstr ""
  1887. #. type: Plain text
  1888. #: ikiwiki/directive/pagetemplate.mdwn:10
  1889. msgid ""
  1890. "The page text is inserted into the template, so the template controls the "
  1891. "overall look and feel of the wiki page. This is in contrast to the "
  1892. "[[ikiwiki/directive/template]] directive, which allows inserting templates "
  1893. "_into_ the body of a page."
  1894. msgstr ""
  1895. #. type: Plain text
  1896. #: ikiwiki/directive/pagetemplate.mdwn:12
  1897. #, no-wrap
  1898. msgid "\t\\[[!pagetemplate template=\"my_fancy.tmpl\"]]\n"
  1899. msgstr ""
  1900. #. type: Plain text
  1901. #: ikiwiki/directive/ping.mdwn:2
  1902. msgid ""
  1903. "The `ping` directive is supplied by the [[!iki plugins/pinger desc=pinger]] "
  1904. "plugin."
  1905. msgstr ""
  1906. #. type: Plain text
  1907. #: ikiwiki/directive/ping.mdwn:8
  1908. msgid ""
  1909. "This directive allows ikiwiki to be configured to hit a URL each time it "
  1910. "updates the wiki. One way to use this is in conjunction with the [[!iki "
  1911. "plugins/pingee desc=pingee]] plugin to set up a loosely coupled mirror "
  1912. "network, or a branched version of a wiki. By pinging the mirror or branch "
  1913. "each time the main wiki changes, it can be kept up-to-date."
  1914. msgstr ""
  1915. #. type: Plain text
  1916. #: ikiwiki/directive/ping.mdwn:11
  1917. #, no-wrap
  1918. msgid ""
  1919. " \\[[!ping from=\"http://mywiki.com/\"\n"
  1920. " to=\"http://otherwiki.com/ikiwiki.cgi?do=ping\"]]\n"
  1921. msgstr ""
  1922. #. type: Plain text
  1923. #: ikiwiki/directive/ping.mdwn:14
  1924. msgid ""
  1925. "The \"from\" parameter must be identical to the url of the wiki that is "
  1926. "doing the pinging. This is used to prevent ping loops."
  1927. msgstr ""
  1928. #. type: Plain text
  1929. #: ikiwiki/directive/ping.mdwn:17
  1930. msgid ""
  1931. "The \"to\" parameter is the url to ping. The example shows how to ping "
  1932. "another ikiwiki instance."
  1933. msgstr ""
  1934. #. type: Plain text
  1935. #: ikiwiki/directive/poll.mdwn:2
  1936. msgid ""
  1937. "The `poll` directive is supplied by the [[!iki plugins/poll desc=poll]] "
  1938. "plugin."
  1939. msgstr ""
  1940. #. type: Plain text
  1941. #: ikiwiki/directive/poll.mdwn:5
  1942. msgid ""
  1943. "This directive allows you to create online polls in the wiki. Here's an "
  1944. "example use:"
  1945. msgstr ""
  1946. #. type: Plain text
  1947. #: ikiwiki/directive/poll.mdwn:7
  1948. #, no-wrap
  1949. msgid "\t\\[[!poll 0 \"red\" 0 \"green\" 0 \"blue\"]]\n"
  1950. msgstr ""
  1951. #. type: Plain text
  1952. #: ikiwiki/directive/poll.mdwn:11
  1953. msgid ""
  1954. "The numbers indicate how many users voted for that choice. When a user votes "
  1955. "for a choice in the poll, the page is modified and the number incremented."
  1956. msgstr ""
  1957. #. type: Plain text
  1958. #: ikiwiki/directive/poll.mdwn:17
  1959. msgid ""
  1960. "While some basic precautions are taken to prevent users from accidentially "
  1961. "voting twice, this sort of poll should not be counted on to be very "
  1962. "accurate; all the usual concerns about web based polling apply. Unless the "
  1963. "page that the poll is in is locked, users can even edit the page and change "
  1964. "the numbers!"
  1965. msgstr ""
  1966. #. type: Plain text
  1967. #: ikiwiki/directive/poll.mdwn:19
  1968. msgid "Parameters:"
  1969. msgstr ""
  1970. #. type: Bullet: '* '
  1971. #: ikiwiki/directive/poll.mdwn:24
  1972. msgid ""
  1973. "`open` - Whether voting is still open. Set to \"no\" to close the poll to "
  1974. "voting."
  1975. msgstr ""
  1976. #. type: Bullet: '* '
  1977. #: ikiwiki/directive/poll.mdwn:24
  1978. msgid "`total` - Show total number of votes at bottom of poll. Default is \"yes\"."
  1979. msgstr ""
  1980. #. type: Bullet: '* '
  1981. #: ikiwiki/directive/poll.mdwn:24
  1982. msgid "`percent` - Whether to display percents. Default is \"yes\"."
  1983. msgstr ""
  1984. #. type: Plain text
  1985. #: ikiwiki/directive/polygen.mdwn:2
  1986. msgid ""
  1987. "The `polygen` directive is supplied by the [[!iki plugins/polygen "
  1988. "desc=polygen]] plugin."
  1989. msgstr ""
  1990. #. type: Plain text
  1991. #: ikiwiki/directive/polygen.mdwn:5
  1992. msgid ""
  1993. "This directive allows inserting text generated by polygen into a wiki page. "
  1994. "For example:"
  1995. msgstr ""
  1996. #. type: Plain text
  1997. #: ikiwiki/directive/polygen.mdwn:7
  1998. #, no-wrap
  1999. msgid "\t\\[[!polygen grammar=\"genius\"]]\n"
  2000. msgstr ""
  2001. #. type: Plain text
  2002. #: ikiwiki/directive/polygen.mdwn:10
  2003. msgid ""
  2004. "It's also possible to specify a starting nonterminal for the grammar by "
  2005. "including `symbol=\"text\"` in the directive."
  2006. msgstr ""
  2007. #. type: Plain text
  2008. #: ikiwiki/directive/postsparkline.mdwn:2
  2009. msgid ""
  2010. "The `postsparkline` directive is supplied by the [[!iki "
  2011. "plugins/postsparkline desc=postsparkline]] plugin."
  2012. msgstr ""
  2013. #. type: Plain text
  2014. #: ikiwiki/directive/postsparkline.mdwn:5
  2015. msgid ""
  2016. "This directive uses the [[!iki plugins/sparkline desc=sparkline]] plugin to "
  2017. "create a [[sparkline]] of statistics about a set of pages, such as posts to "
  2018. "a blog."
  2019. msgstr ""
  2020. #. type: Plain text
  2021. #: ikiwiki/directive/postsparkline.mdwn:11
  2022. #, no-wrap
  2023. msgid ""
  2024. "\tPost interval: \n"
  2025. "\t\\[[!postsparkline pages=\"blog/* and !*/Discussion\" max=100\n"
  2026. "\tformula=interval style=bar barwidth=2 barspacing=1 height=13]]\n"
  2027. msgstr ""
  2028. #. type: Plain text
  2029. #: ikiwiki/directive/postsparkline.mdwn:15
  2030. #, no-wrap
  2031. msgid ""
  2032. "\tPosts per month this year: \n"
  2033. "\t\\[[!postsparkline pages=\"blog/* and !*/Discussion\" max=12\n"
  2034. "\tformula=permonth style=bar barwidth=2 barspacing=1 height=13]]\n"
  2035. msgstr ""
  2036. #. type: Plain text
  2037. #: ikiwiki/directive/postsparkline.mdwn:20
  2038. msgid ""
  2039. "All options aside from the `pages`, `max`, `formula`, `time`, and `color` "
  2040. "options are the same as in [[sparkline]] directive."
  2041. msgstr ""
  2042. #. type: Plain text
  2043. #: ikiwiki/directive/postsparkline.mdwn:25
  2044. msgid ""
  2045. "You don't need to specify any data points (though you can if you want to). "
  2046. "Instead, data points are automatically generated based on the creation times "
  2047. "of pages matched by the specified `pages` [[ikiwiki/PageSpec]]. A maximum of "
  2048. "`max` data points will be generated."
  2049. msgstr ""
  2050. #. type: Plain text
  2051. #: ikiwiki/directive/postsparkline.mdwn:28
  2052. msgid ""
  2053. "The `formula` parameter controls the formula used to generate data points. "
  2054. "Available formulae:"
  2055. msgstr ""
  2056. #. type: Bullet: '* '
  2057. #: ikiwiki/directive/postsparkline.mdwn:37
  2058. msgid ""
  2059. "`interval` - The height of each point represents how long it has been since "
  2060. "the previous post."
  2061. msgstr ""
  2062. #. type: Bullet: '* '
  2063. #: ikiwiki/directive/postsparkline.mdwn:37
  2064. msgid ""
  2065. "`perday` - Each point represents a day; the height represents how many posts "
  2066. "were made that day."
  2067. msgstr ""
  2068. #. type: Bullet: '* '
  2069. #: ikiwiki/directive/postsparkline.mdwn:37
  2070. msgid ""
  2071. "`permonth` - Each point represents a month; the height represents how many "
  2072. "posts were made that month."
  2073. msgstr ""
  2074. #. type: Bullet: '* '
  2075. #: ikiwiki/directive/postsparkline.mdwn:37
  2076. msgid ""
  2077. "`peryear` - Each point represents a year; the height represents how many "
  2078. "posts were made that year."
  2079. msgstr ""
  2080. #. type: Plain text
  2081. #: ikiwiki/directive/postsparkline.mdwn:41
  2082. msgid ""
  2083. "The `time` parameter has a default value of \"ctime\", since formulae use "
  2084. "the creation times of pages by default. If you instead want them to use the "
  2085. "modification times of pages, set it to \"mtime\"."
  2086. msgstr ""
  2087. #. type: Plain text
  2088. #: ikiwiki/directive/postsparkline.mdwn:44
  2089. msgid ""
  2090. "To change the color used to draw the sparkline, use the `color` parameter. "
  2091. "For example, \"color=red\"."
  2092. msgstr ""
  2093. #. type: Plain text
  2094. #: ikiwiki/directive/progress.mdwn:2
  2095. msgid ""
  2096. "The `progress` directive is supplied by the [[!iki plugins/progress "
  2097. "desc=progress]] plugin."
  2098. msgstr ""
  2099. #. type: Plain text
  2100. #: ikiwiki/directive/progress.mdwn:4
  2101. msgid "This directive generates a progress bar."
  2102. msgstr ""
  2103. #. type: Plain text
  2104. #: ikiwiki/directive/progress.mdwn:7
  2105. msgid ""
  2106. "There are two possible parameter sets. The first is a single parameter "
  2107. "\"percent\" which holds a percentage figure of how complete the progress bar "
  2108. "is."
  2109. msgstr ""
  2110. #. type: Plain text
  2111. #: ikiwiki/directive/progress.mdwn:12
  2112. msgid ""
  2113. "The second possible set of parameters is a pair of [[ikiwiki/PageSpec]]s, "
  2114. "`totalpages` and `donepages`. The directive counts the number of pages in "
  2115. "each pagespec and shows the percentage of the total pages that are done."
  2116. msgstr ""
  2117. #. type: Plain text
  2118. #: ikiwiki/directive/progress.mdwn:15
  2119. msgid "For example, to show what percentage of pages have discussion pages:"
  2120. msgstr ""
  2121. #. type: Plain text
  2122. #: ikiwiki/directive/progress.mdwn:17
  2123. #, no-wrap
  2124. msgid ""
  2125. "\t\\[[!progress totalpages=\"* and !*/Discussion\" "
  2126. "donepages=\"*/Discussion\"]]\n"
  2127. msgstr ""
  2128. #. type: Plain text
  2129. #: ikiwiki/directive/shortcut.mdwn:2
  2130. msgid ""
  2131. "The `shortcut` directive is supplied by the [[!iki plugins/shortcut "
  2132. "desc=shortcut]] plugin."
  2133. msgstr ""
  2134. #. type: Plain text
  2135. #: ikiwiki/directive/shortcut.mdwn:5
  2136. msgid ""
  2137. "This directive allows external links to commonly linked to sites to be made "
  2138. "more easily using shortcuts."
  2139. msgstr ""
  2140. #. type: Plain text
  2141. #: ikiwiki/directive/shortcut.mdwn:8
  2142. msgid ""
  2143. "The available shortcuts are defined on the [[shortcuts]] page in the "
  2144. "wiki. The `shortcut` directive can only be used on that page."
  2145. msgstr ""
  2146. #. type: Plain text
  2147. #: ikiwiki/directive/sidebar.mdwn:2
  2148. msgid ""
  2149. "The `sidebar` directive is supplied by the [[!iki plugins/sidebar "
  2150. "desc=sidebar]] plugin."
  2151. msgstr ""
  2152. #. type: Plain text
  2153. #: ikiwiki/directive/sidebar.mdwn:5
  2154. msgid ""
  2155. "This directive can specify a custom sidebar to display on the page, "
  2156. "overriding any sidebar that is displayed globally."
  2157. msgstr ""
  2158. #. type: Plain text
  2159. #: ikiwiki/directive/sidebar.mdwn:9
  2160. msgid ""
  2161. "If no custom sidebar content is specified, it forces the sidebar page to be "
  2162. "used as the sidebar, even if the `global_sidebars` setting has been used to "
  2163. "disable use of the sidebar page by default."
  2164. msgstr ""
  2165. #. type: Plain text
  2166. #: ikiwiki/directive/sidebar.mdwn:12
  2167. #, no-wrap
  2168. msgid "\t\\[[!sidebar content=\"\"\"\n"
  2169. msgstr ""
  2170. #. type: Plain text
  2171. #: ikiwiki/directive/sidebar.mdwn:14
  2172. #, no-wrap
  2173. msgid "\tThis is my custom sidebar for this page.\n"
  2174. msgstr ""
  2175. #. type: Plain text
  2176. #: ikiwiki/directive/sidebar.mdwn:16
  2177. #, no-wrap
  2178. msgid "\t\\[[!calendar pages=\"posts/*\"]]\n"
  2179. msgstr ""
  2180. #. type: Plain text
  2181. #: ikiwiki/directive/sidebar.mdwn:19
  2182. #, no-wrap
  2183. msgid "\t\\[[!sidebar]]\n"
  2184. msgstr ""
  2185. #. type: Plain text
  2186. #: ikiwiki/directive/sparkline.mdwn:2
  2187. msgid ""
  2188. "The `sparkline` directive is supplied by the [[!iki plugins/sparkline "
  2189. "desc=sparkline]] plugin."
  2190. msgstr ""
  2191. #. type: Plain text
  2192. #: ikiwiki/directive/sparkline.mdwn:6
  2193. msgid ""
  2194. "This directive allows for embedding sparklines into wiki pages. A sparkline "
  2195. "is a small word-size graphic chart, that is designed to be displayed "
  2196. "alongside text."
  2197. msgstr ""
  2198. #. type: Plain text
  2199. #: ikiwiki/directive/sparkline.mdwn:11
  2200. #, no-wrap
  2201. msgid ""
  2202. "\t\\[[!sparkline 1 3 5 -3 10 0 width=40 height=16\n"
  2203. "\tfeaturepoint=\"4,-3,red,3\" featurepoint=\"5,10,green,3\"]]\n"
  2204. msgstr ""
  2205. #. type: Plain text
  2206. #: ikiwiki/directive/sparkline.mdwn:15
  2207. msgid ""
  2208. "This creates a simple line graph, graphing several points. It will be drawn "
  2209. "40 pixels wide and 16 pixels high. The high point in the line has a green "
  2210. "marker, and the low point has a red marker."
  2211. msgstr ""
  2212. #. type: Plain text
  2213. #: ikiwiki/directive/sparkline.mdwn:18
  2214. #, no-wrap
  2215. msgid ""
  2216. "\t\\[[!sparkline 1 -1(red) 1 -1(red) 1 1 1 -1(red) -1(red) style=bar "
  2217. "barwidth=2\n"
  2218. "\tbarspacing=1 height=13]]\n"
  2219. msgstr ""
  2220. #. type: Plain text
  2221. #: ikiwiki/directive/sparkline.mdwn:23
  2222. msgid ""
  2223. "This more complex example generates a bar graph. The bars are 2 pixels "
  2224. "wide, and separated by one pixel, and the graph is 13 pixels tall. Width is "
  2225. "determined automatically for bar graphs. The points with negative values are "
  2226. "colored red, instead of the default black."
  2227. msgstr ""
  2228. #. type: Plain text
  2229. #: ikiwiki/directive/sparkline.mdwn:28
  2230. msgid ""
  2231. "The form for the data points is \"x,y\", or just \"y\" if the x values don't "
  2232. "matter. Bar graphs can also add \"(color)\" to specify a color for that bar."
  2233. msgstr ""
  2234. #. type: Plain text
  2235. #: ikiwiki/directive/sparkline.mdwn:32
  2236. msgid ""
  2237. "The following named parameters are recognised. Most of these are the same as "
  2238. "those used by the underlying sparkline library, which is documented in more "
  2239. "detail in [its wiki](http://sparkline.wikispaces.com/usage)."
  2240. msgstr ""
  2241. #. type: Bullet: '* '
  2242. #: ikiwiki/directive/sparkline.mdwn:44
  2243. msgid "`style` - Either \"line\" (the default) or \"bar\"."
  2244. msgstr ""
  2245. #. type: Bullet: '* '
  2246. #: ikiwiki/directive/sparkline.mdwn:44
  2247. msgid "`width` - Width of the graph in pixels. Only needed for line graphs."
  2248. msgstr ""
  2249. #. type: Bullet: '* '
  2250. #: ikiwiki/directive/sparkline.mdwn:44
  2251. msgid "`height` - Height of the graph in pixels. Defaults to 16."
  2252. msgstr ""
  2253. #. type: Bullet: '* '
  2254. #: ikiwiki/directive/sparkline.mdwn:44
  2255. msgid "`barwidth` - Width of bars in a bar graph. Default is 1 pixel."
  2256. msgstr ""
  2257. #. type: Bullet: '* '
  2258. #: ikiwiki/directive/sparkline.mdwn:44
  2259. msgid ""
  2260. "`barspacing` - Spacing between bars in a bar graph, in pixels. Default is 1 "
  2261. "pixel."
  2262. msgstr ""
  2263. #. type: Bullet: '* '
  2264. #: ikiwiki/directive/sparkline.mdwn:44
  2265. msgid ""
  2266. "`ymin`, `ymax` - Minimum and maximum values for the Y axis. This is normally "
  2267. "calculated automatically, but can be explicitly specified to get the same "
  2268. "values for multiple related graphs."
  2269. msgstr ""
  2270. #. type: Bullet: '* '
  2271. #: ikiwiki/directive/sparkline.mdwn:44
  2272. msgid ""
  2273. "`featurepoint` - Adds a circular marker to a line graph, with optional "
  2274. "text. This can be used to label significant points."
  2275. msgstr ""
  2276. #. type: Plain text
  2277. #: ikiwiki/directive/sparkline.mdwn:48
  2278. #, no-wrap
  2279. msgid ""
  2280. " The value is a comma-delimited list of parameters specifying the feature\n"
  2281. " point: X value, Y value, color name, circle diameter, text (optional),\n"
  2282. " and text location (optional). Example: `featurepoint=\"3,5,blue,3\"`\n"
  2283. msgstr ""
  2284. #. type: Plain text
  2285. #: ikiwiki/directive/sparkline.mdwn:51
  2286. #, no-wrap
  2287. msgid ""
  2288. " Available values for the text location are: \"top\", \"right\", "
  2289. "\"bottom\", and\n"
  2290. " \"left\".\n"
  2291. msgstr ""
  2292. #. type: Plain text
  2293. #: ikiwiki/directive/table.mdwn:2
  2294. msgid ""
  2295. "The `table` directive is supplied by the [[!iki plugins/table desc=table]] "
  2296. "plugin."
  2297. msgstr ""
  2298. #. type: Plain text
  2299. #: ikiwiki/directive/table.mdwn:5
  2300. msgid ""
  2301. "This directive can build HTML tables from data in CSV (comma-separated "
  2302. "values) or DSV (delimiter-separated values) format."
  2303. msgstr ""
  2304. #. type: Plain text
  2305. #: ikiwiki/directive/table.mdwn:8 ikiwiki/directive/table.mdwn:26
  2306. #, no-wrap
  2307. msgid "\t\\[[!table data=\"\"\"\n"
  2308. msgstr ""
  2309. #. type: Plain text
  2310. #: ikiwiki/directive/table.mdwn:13
  2311. #, no-wrap
  2312. msgid ""
  2313. "\tCustomer |Amount\n"
  2314. "\tFulanito |134,34\n"
  2315. "\tMenganito|234,56\n"
  2316. "\tMenganito|234,56\n"
  2317. msgstr ""
  2318. #. type: Plain text
  2319. #: ikiwiki/directive/table.mdwn:16
  2320. #, no-wrap
  2321. msgid ""
  2322. "\t\\[[!table class=\"book_record\" format=csv "
  2323. "file=\"data/books/record1\"]]\n"
  2324. msgstr ""
  2325. #. type: Plain text
  2326. #: ikiwiki/directive/table.mdwn:18
  2327. msgid "In this second example the `record1` page should be similar to:"
  2328. msgstr ""
  2329. #. type: Plain text
  2330. #: ikiwiki/directive/table.mdwn:22
  2331. #, no-wrap
  2332. msgid ""
  2333. "\t\"Title\",\"Perl Best Practices\"\n"
  2334. "\t\"Author\",\"Damian Conway\"\n"
  2335. "\t\"Publisher\",\"O’Reilly\"\n"
  2336. msgstr ""
  2337. #. type: Plain text
  2338. #: ikiwiki/directive/table.mdwn:25
  2339. msgid ""
  2340. "To make a cell span multiple columns, follow it with one or more empty "
  2341. "cells. For example:"
  2342. msgstr ""
  2343. #. type: Plain text
  2344. #: ikiwiki/directive/table.mdwn:30
  2345. #, no-wrap
  2346. msgid ""
  2347. "\tleft||right|\n"
  2348. "\ta|b|c|d\n"
  2349. "\tthis cell spans 4 columns|||\n"
  2350. msgstr ""
  2351. #. type: Bullet: '* '
  2352. #: ikiwiki/directive/table.mdwn:44
  2353. msgid "`data` - Values for the table."
  2354. msgstr ""
  2355. #. type: Bullet: '* '
  2356. #: ikiwiki/directive/table.mdwn:44
  2357. msgid "`file` - A file in the wiki containing the data."
  2358. msgstr ""
  2359. #. type: Bullet: '* '
  2360. #: ikiwiki/directive/table.mdwn:44
  2361. msgid ""
  2362. "`format` - The format of the data, either \"csv\", \"dsv\", or \"auto\" (the "
  2363. "default)."
  2364. msgstr ""
  2365. #. type: Plain text
  2366. #: ikiwiki/directive/table.mdwn:44
  2367. #, no-wrap
  2368. msgid ""
  2369. "* `delimiter` - The character used to separate fields. By default,\n"
  2370. " DSV format uses a pipe (`|`), and CSV uses a comma (`,`).\n"
  2371. "* `class` - A CSS class for the table html element.\n"
  2372. "* `header` - By default, or if set to \"row\", the first data line is used\n"
  2373. " as the table header. Set it to \"no\" to make a table without a header, "
  2374. "or\n"
  2375. " \"column\" to make the first column be the header.\n"
  2376. msgstr ""
  2377. #. type: Plain text
  2378. #: ikiwiki/directive/table.mdwn:49
  2379. msgid ""
  2380. "For tab-delimited tables (often obtained by copying and pasting from HTML or "
  2381. "a spreadsheet), `delimiter` must be set to a literal tab character. These "
  2382. "are difficult to type in most web browsers - copying and pasting one from "
  2383. "the table data is likely to be the easiest way."
  2384. msgstr ""
  2385. #. type: Plain text
  2386. #: ikiwiki/directive/tag.mdwn:2
  2387. msgid ""
  2388. "The `tag` and `taglink` directives are supplied by the [[!iki plugins/tag "
  2389. "desc=tag]] plugin."
  2390. msgstr ""
  2391. #. type: Plain text
  2392. #: ikiwiki/directive/tag.mdwn:4
  2393. msgid "These directives allow tagging pages. List tags as follows:"
  2394. msgstr ""
  2395. #. type: Plain text
  2396. #: ikiwiki/directive/tag.mdwn:6
  2397. #, no-wrap
  2398. msgid "\t\\[[!tag tech life linux]]\n"
  2399. msgstr ""
  2400. #. type: Plain text
  2401. #: ikiwiki/directive/tag.mdwn:12
  2402. msgid ""
  2403. "The tags work the same as if you had put a (hidden) [[ikiwiki/WikiLink]] on "
  2404. "the page for each tag, so you can use a [[ikiwiki/PageSpec]] match all pages "
  2405. "that are tagged with a given tag, for example. The tags will also show up on "
  2406. "blog entries and at the bottom of the tagged pages, as well as in RSS and "
  2407. "Atom feeds."
  2408. msgstr ""
  2409. #. type: Plain text
  2410. #: ikiwiki/directive/tag.mdwn:15
  2411. msgid ""
  2412. "If you want a visible [[ikiwiki/WikiLink]] along with the tag, use taglink "
  2413. "instead:"
  2414. msgstr ""
  2415. #. type: Plain text
  2416. #: ikiwiki/directive/tag.mdwn:18
  2417. #, no-wrap
  2418. msgid ""
  2419. "\t\\[[!taglink foo]]\n"
  2420. "\t\\[[!taglink tagged_as_foo|foo]]\n"
  2421. msgstr ""
  2422. #. type: Plain text
  2423. #: ikiwiki/directive/tag.mdwn:24
  2424. msgid ""
  2425. "Note that if the wiki is configured to use a tagbase, then the tags will be "
  2426. "located under a base directory, such as \"tags/\". This is a useful way to "
  2427. "avoid having to write the full path to tags, if you want to keep them "
  2428. "grouped together out of the way. Also, since ikiwiki then knows where to put "
  2429. "tags, it will automatically create tag pages when new tags are used."
  2430. msgstr ""
  2431. #. type: Plain text
  2432. #: ikiwiki/directive/tag.mdwn:28
  2433. msgid ""
  2434. "Bear in mind that specifying a tagbase means you will need to incorporate it "
  2435. "into the `link()` [[ikiwiki/PageSpec]] you use: e.g., if your tagbase is "
  2436. "`tag`, you would match pages tagged \"foo\" with `link(tag/foo)`."
  2437. msgstr ""
  2438. #. type: Plain text
  2439. #: ikiwiki/directive/tag.mdwn:31
  2440. msgid ""
  2441. "If you want to override the tagbase for a particular tag, you can use "
  2442. "something like this:"
  2443. msgstr ""
  2444. #. type: Plain text
  2445. #: ikiwiki/directive/tag.mdwn:34
  2446. #, no-wrap
  2447. msgid ""
  2448. "\t\\[[!tag /foo]]\n"
  2449. "\t\\[[!taglink /foo]]\n"
  2450. msgstr ""
  2451. #. type: Plain text
  2452. #: ikiwiki/directive/taglink.mdwn:1
  2453. #, no-wrap
  2454. msgid "[[!meta redir=/ikiwiki/directive/tag]]\n"
  2455. msgstr ""
  2456. #. type: Plain text
  2457. #: ikiwiki/directive/template.mdwn:2
  2458. msgid ""
  2459. "The `template` directive is supplied by the [[!iki plugins/template "
  2460. "desc=template]] plugin."
  2461. msgstr ""
  2462. #. type: Plain text
  2463. #: ikiwiki/directive/template.mdwn:7
  2464. msgid ""
  2465. "The template directive allows wiki pages to be used as templates. These "
  2466. "templates can be filled out and inserted into other pages in the wiki using "
  2467. "the directive. The [[templates]] page lists templates that can be used with "
  2468. "this directive."
  2469. msgstr ""
  2470. #. type: Plain text
  2471. #: ikiwiki/directive/template.mdwn:11
  2472. msgid ""
  2473. "The directive has an `id` parameter that identifies the template to use. The "
  2474. "remaining parameters are used to fill out the template."
  2475. msgstr ""
  2476. #. type: Title ##
  2477. #: ikiwiki/directive/template.mdwn:12
  2478. #, no-wrap
  2479. msgid "Example"
  2480. msgstr ""
  2481. #. type: Plain text
  2482. #: ikiwiki/directive/template.mdwn:15
  2483. #, no-wrap
  2484. msgid ""
  2485. "\t\\[[!template id=note text=\"\"\"Here is the text to insert into my "
  2486. "note.\"\"\"]]\n"
  2487. msgstr ""
  2488. #. type: Plain text
  2489. #: ikiwiki/directive/template.mdwn:18
  2490. msgid ""
  2491. "This fills out the `note` template, filling in the `text` field with the "
  2492. "specified value, and inserts the result into the page."
  2493. msgstr ""
  2494. #. type: Title ##
  2495. #: ikiwiki/directive/template.mdwn:19
  2496. #, no-wrap
  2497. msgid "Using a template"
  2498. msgstr ""
  2499. #. type: Plain text
  2500. #: ikiwiki/directive/template.mdwn:25
  2501. msgid ""
  2502. "Generally, a value can include any markup that would be allowed in the wiki "
  2503. "page outside the template. Triple-quoting the value even allows quotes to be "
  2504. "included in it. Combined with multi-line quoted values, this allows for "
  2505. "large chunks of marked up text to be embedded into a template:"
  2506. msgstr ""
  2507. #. type: Plain text
  2508. #: ikiwiki/directive/template.mdwn:26
  2509. #, no-wrap
  2510. msgid ""
  2511. " \\[[!template id=foo name=\"Sally\" color=\"green\" age=8 "
  2512. "notes=\"\"\"\n"
  2513. msgstr ""
  2514. #. type: Bullet: ' * '
  2515. #: ikiwiki/directive/template.mdwn:30
  2516. msgid "\\[[Charley]]'s sister."
  2517. msgstr ""
  2518. #. type: Bullet: ' * '
  2519. #: ikiwiki/directive/template.mdwn:30
  2520. msgid "\"I want to be an astronaut when I grow up.\""
  2521. msgstr ""
  2522. #. type: Bullet: ' * '
  2523. #: ikiwiki/directive/template.mdwn:30
  2524. msgid "Really 8 and a half."
  2525. msgstr ""
  2526. #. type: Title ##
  2527. #: ikiwiki/directive/template.mdwn:32
  2528. #, no-wrap
  2529. msgid "Creating a template"
  2530. msgstr ""
  2531. #. type: Plain text
  2532. #: ikiwiki/directive/template.mdwn:36
  2533. msgid ""
  2534. "The template is a regular wiki page, located in the `templates/` "
  2535. "subdirectory inside the source directory of the wiki."
  2536. msgstr ""
  2537. #. type: Plain text
  2538. #: ikiwiki/directive/template.mdwn:42
  2539. msgid ""
  2540. "(Alternatively, templates can be stored in a directory outside the wiki, as "
  2541. "files with the extension \".tmpl\". By default, these are searched for in "
  2542. "`/usr/share/ikiwiki/templates`; the `templatedir` setting can be used to "
  2543. "make another directory be searched first.)"
  2544. msgstr ""
  2545. #. type: Plain text
  2546. #: ikiwiki/directive/template.mdwn:47
  2547. msgid ""
  2548. "The template uses the syntax used by the [[!cpan HTML::Template]] perl "
  2549. "module, which allows for some fairly complex things to be done. Consult its "
  2550. "documentation for the full syntax, but all you really need to know are a few "
  2551. "things:"
  2552. msgstr ""
  2553. #. type: Bullet: '* '
  2554. #: ikiwiki/directive/template.mdwn:59
  2555. msgid ""
  2556. "Each parameter you pass to the template directive will generate a template "
  2557. "variable. There are also some pre-defined variables like PAGE and BASENAME."
  2558. msgstr ""
  2559. #. type: Bullet: '* '
  2560. #: ikiwiki/directive/template.mdwn:59
  2561. msgid ""
  2562. "To insert the value of a variable, use `<TMPL_VAR variable>`. Wiki markup in "
  2563. "the value will first be converted to html."
  2564. msgstr ""
  2565. #. type: Bullet: '* '
  2566. #: ikiwiki/directive/template.mdwn:59
  2567. msgid ""
  2568. "To insert the raw value of a variable, with wiki markup not yet converted to "
  2569. "html, use `<TMPL_VAR raw_variable>`."
  2570. msgstr ""
  2571. #. type: Bullet: '* '
  2572. #: ikiwiki/directive/template.mdwn:59
  2573. msgid ""
  2574. "To make a block of text conditional on a variable being set use `<TMPL_IF "
  2575. "variable>text</TMPL_IF>`."
  2576. msgstr ""
  2577. #. type: Bullet: '* '
  2578. #: ikiwiki/directive/template.mdwn:59
  2579. msgid ""
  2580. "To use one block of text if a variable is set and a second if it's not, use "
  2581. "`<TMPL_IF variable>text<TMPL_ELSE>other text</TMPL_IF>`"
  2582. msgstr ""
  2583. #. type: Plain text
  2584. #: ikiwiki/directive/template.mdwn:61
  2585. msgid "Here's a sample template:"
  2586. msgstr ""
  2587. #. type: Plain text
  2588. #: ikiwiki/directive/template.mdwn:75
  2589. #, no-wrap
  2590. msgid ""
  2591. " <span class=\"infobox\">\n"
  2592. " Name: \\[[<TMPL_VAR raw_name>]]<br />\n"
  2593. " Age: <TMPL_VAR age><br />\n"
  2594. " <TMPL_IF color>\n"
  2595. " Favorite color: <TMPL_VAR color><br />\n"
  2596. " <TMPL_ELSE>\n"
  2597. " No favorite color.<br />\n"
  2598. " </TMPL_IF>\n"
  2599. " <TMPL_IF notes>\n"
  2600. " <hr />\n"
  2601. " <TMPL_VAR notes>\n"
  2602. " </TMPL_IF>\n"
  2603. " </span>\n"
  2604. msgstr ""
  2605. #. type: Plain text
  2606. #: ikiwiki/directive/template.mdwn:80
  2607. msgid ""
  2608. "The filled out template will be formatted the same as the rest of the page "
  2609. "that contains it, so you can include WikiLinks and all other forms of wiki "
  2610. "markup in the template. Note though that such WikiLinks will not show up as "
  2611. "backlinks to the page that uses the template."
  2612. msgstr ""
  2613. #. type: Plain text
  2614. #: ikiwiki/directive/template.mdwn:85
  2615. msgid ""
  2616. "Note the use of \"raw_name\" inside the [[ikiwiki/WikiLink]] generator in "
  2617. "the example above. This ensures that if the name contains something that "
  2618. "might be mistaken for wiki markup, it's not converted to html before being "
  2619. "processed as a [[ikiwiki/WikiLink]]."
  2620. msgstr ""
  2621. #. type: Plain text
  2622. #: ikiwiki/directive/testpagespec.mdwn:2
  2623. msgid ""
  2624. "The `testpagespec` directive is supplied by the [[!iki plugins/testpagespec "
  2625. "desc=testpagespec]] plugin."
  2626. msgstr ""
  2627. #. type: Plain text
  2628. #: ikiwiki/directive/testpagespec.mdwn:5
  2629. msgid ""
  2630. "This directive allows testing a [[ikiwiki/PageSpec]] to see if it matches a "
  2631. "page, and to see the part that matches, or causes the match to fail."
  2632. msgstr ""
  2633. #. type: Plain text
  2634. #: ikiwiki/directive/testpagespec.mdwn:7
  2635. msgid "Example uses:"
  2636. msgstr ""
  2637. #. type: Plain text
  2638. #: ikiwiki/directive/testpagespec.mdwn:9
  2639. #, no-wrap
  2640. msgid "\t\\[[!testpagespec pagespec=\"foopage and barpage\" match=\"foopage\"]]\n"
  2641. msgstr ""
  2642. #. type: Plain text
  2643. #: ikiwiki/directive/testpagespec.mdwn:13
  2644. msgid ""
  2645. "This will print out something like \"no match: barpage does not match "
  2646. "foopage\", highlighting which part of the [[ikiwiki/PageSpec]] is causing "
  2647. "the match to fail."
  2648. msgstr ""
  2649. #. type: Plain text
  2650. #: ikiwiki/directive/testpagespec.mdwn:15
  2651. #, no-wrap
  2652. msgid "\t\\[[!testpagespec pagespec=\"foopage or !bar*\" match=\"barpage\"]]\n"
  2653. msgstr ""
  2654. #. type: Plain text
  2655. #: ikiwiki/directive/testpagespec.mdwn:18
  2656. msgid ""
  2657. "This will print out something like \"no match: bar* matches barpage\", since "
  2658. "the part of the [[ikiwiki/PageSpec]] that fails is this negated match."
  2659. msgstr ""
  2660. #. type: Plain text
  2661. #: ikiwiki/directive/testpagespec.mdwn:20
  2662. #, no-wrap
  2663. msgid "\t\\[[!testpagespec pagespec=\"foopage or barpage\" match=\"barpage\"]]\n"
  2664. msgstr ""
  2665. #. type: Plain text
  2666. #: ikiwiki/directive/testpagespec.mdwn:23
  2667. msgid ""
  2668. "This will print out something like \"match: barpage matches barpage\", "
  2669. "indicating the part of the [[ikiwiki/PageSpec]] that caused it to match."
  2670. msgstr ""
  2671. #. type: Plain text
  2672. #: ikiwiki/directive/teximg.mdwn:2
  2673. msgid ""
  2674. "The `teximg` directive is supplied by the [[!iki plugins/teximg "
  2675. "desc=teximg]] plugin."
  2676. msgstr ""
  2677. #. type: Plain text
  2678. #: ikiwiki/directive/teximg.mdwn:4
  2679. msgid "This directive renders LaTeX formulas into images."
  2680. msgstr ""
  2681. #. type: Plain text
  2682. #: ikiwiki/directive/teximg.mdwn:9
  2683. #, no-wrap
  2684. msgid ""
  2685. "\t\\[[!teximg code=\"\\frac{1}{2}\"]]\n"
  2686. "\t\\[[!teximg code=\"E = - \\frac{Z^2 \\cdot \\mu \\cdot e^4}{32\\pi^2 "
  2687. "\\epsilon_0^2 \\hbar^2 n^2}\" ]]\n"
  2688. msgstr ""
  2689. #. type: Plain text
  2690. #: ikiwiki/directive/teximg.mdwn:11
  2691. msgid "To scale the image, use height=x:"
  2692. msgstr ""
  2693. #. type: Plain text
  2694. #: ikiwiki/directive/teximg.mdwn:14
  2695. #, no-wrap
  2696. msgid ""
  2697. "\t\\[[!teximg code=\"\\frac{1}{2}\" height=\"17\"]]\n"
  2698. "\t\\[[!teximg code=\"\\frac{1}{2}\" height=\"8\"]]\n"
  2699. msgstr ""
  2700. #. type: Plain text
  2701. #: ikiwiki/directive/teximg.mdwn:18
  2702. msgid ""
  2703. "If no height is chosen the default height 12 is used. Valid heights are: 8, "
  2704. "9, 10, 11, 12, 14, 17, 20. If another height is entered, the closest "
  2705. "available height is used."
  2706. msgstr ""
  2707. #. type: Plain text
  2708. #: ikiwiki/directive/teximg.mdwn:20
  2709. msgid "To add an alt text to the image, use alt=\"text\":"
  2710. msgstr ""
  2711. #. type: Plain text
  2712. #: ikiwiki/directive/teximg.mdwn:22
  2713. #, no-wrap
  2714. msgid "\t\\[[!teximg code=\"\\frac{1}{2}\" alt=\"1/2\"]]\n"
  2715. msgstr ""
  2716. #. type: Plain text
  2717. #: ikiwiki/directive/toc.mdwn:2
  2718. msgid "The `toc` directive is supplied by the [[!iki plugins/toc desc=toc]] plugin."
  2719. msgstr ""
  2720. #. type: Plain text
  2721. #: ikiwiki/directive/toc.mdwn:4
  2722. msgid "Add a table of contents to a page:"
  2723. msgstr ""
  2724. #. type: Plain text
  2725. #: ikiwiki/directive/toc.mdwn:6
  2726. #, no-wrap
  2727. msgid "\t\\[[!toc ]]\n"
  2728. msgstr ""
  2729. #. type: Plain text
  2730. #: ikiwiki/directive/toc.mdwn:11
  2731. msgid ""
  2732. "The table of contents will be automatically generated based on the headers "
  2733. "of the page. By default only the largest headers present on the page will be "
  2734. "shown; to control how many levels of headers are shown, use the `levels` "
  2735. "parameter:"
  2736. msgstr ""
  2737. #. type: Plain text
  2738. #: ikiwiki/directive/toc.mdwn:13
  2739. #, no-wrap
  2740. msgid "\t\\[[!toc levels=2]]\n"
  2741. msgstr ""
  2742. #. type: Plain text
  2743. #: ikiwiki/directive/toc.mdwn:16
  2744. msgid ""
  2745. "The toc directive will take the level of the first header as the topmost "
  2746. "level, even if there are higher levels seen later in the file."
  2747. msgstr ""
  2748. #. type: Plain text
  2749. #: ikiwiki/directive/toc.mdwn:20
  2750. msgid ""
  2751. "To create a table of contents that only shows headers starting with a given "
  2752. "level, use the `startlevel` parameter. For example, to show only h2 and "
  2753. "smaller headers:"
  2754. msgstr ""
  2755. #. type: Plain text
  2756. #: ikiwiki/directive/toc.mdwn:22
  2757. #, no-wrap
  2758. msgid "\t\\[[!toc startlevel=2]]\n"
  2759. msgstr ""
  2760. #. type: Plain text
  2761. #: ikiwiki/directive/toc.mdwn:26
  2762. msgid ""
  2763. "The table of contents will be created as an ordered list. If you want an "
  2764. "unordered list instead, you can change the list-style in your local style "
  2765. "sheet."
  2766. msgstr ""
  2767. #. type: Plain text
  2768. #: ikiwiki/directive/toggle.mdwn:2
  2769. msgid ""
  2770. "The `toggle` and `toggleable` directives are supplied by the [[!iki "
  2771. "plugins/toggle desc=toggle]] plugin."
  2772. msgstr ""
  2773. #. type: Plain text
  2774. #: ikiwiki/directive/toggle.mdwn:5
  2775. msgid ""
  2776. "With these directives you can create links on pages that, when clicked, "
  2777. "toggle display of other parts of the page."
  2778. msgstr ""
  2779. #. type: Plain text
  2780. #: ikiwiki/directive/toggle.mdwn:8
  2781. msgid ""
  2782. "It uses javascript to accomplish this; browsers without javascript will "
  2783. "always see the full page content."
  2784. msgstr ""
  2785. #. type: Plain text
  2786. #: ikiwiki/directive/toggle.mdwn:10
  2787. msgid "Example use:"
  2788. msgstr ""
  2789. #. type: Plain text
  2790. #: ikiwiki/directive/toggle.mdwn:12
  2791. #, no-wrap
  2792. msgid "\t\\[[!toggle id=\"ipsum\" text=\"show\"]]\n"
  2793. msgstr ""
  2794. #. type: Plain text
  2795. #: ikiwiki/directive/toggle.mdwn:13
  2796. #, no-wrap
  2797. msgid "\t\\[[!toggleable id=\"ipsum\" text=\"\"\"\n"
  2798. msgstr ""
  2799. #. type: Plain text
  2800. #: ikiwiki/directive/toggle.mdwn:18
  2801. #, no-wrap
  2802. msgid ""
  2803. "\tLorem ipsum dolor sit amet, consectetur adipisicing elit, sed do\n"
  2804. "\teiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim\n"
  2805. "\tad minim veniam, quis nostrud exercitation ullamco laboris nisi ut\n"
  2806. "\taliquip ex ea commodo consequat.\n"
  2807. msgstr ""
  2808. #. type: Plain text
  2809. #: ikiwiki/directive/toggle.mdwn:19
  2810. #, no-wrap
  2811. msgid "\t[[!toggle id=\"ipsum\" text=\"hide\"]]\n"
  2812. msgstr ""
  2813. #. type: Plain text
  2814. #: ikiwiki/directive/toggle.mdwn:24
  2815. msgid ""
  2816. "Note that you can include wiki markup in the toggleable text, including even "
  2817. "additional toggles, as shown in the above example."
  2818. msgstr ""
  2819. #. type: Plain text
  2820. #: ikiwiki/directive/toggle.mdwn:28
  2821. msgid ""
  2822. "Also, the toggle and the togglable definitions do not need to be next to "
  2823. "each other, but can be located anywhere on the page. There can also be "
  2824. "mutiple toggles that all toggle a single togglable."
  2825. msgstr ""
  2826. #. type: Plain text
  2827. #: ikiwiki/directive/toggle.mdwn:30
  2828. msgid ""
  2829. "The id has a default value of \"default\", so can be omitted in simple "
  2830. "cases."
  2831. msgstr ""
  2832. #. type: Plain text
  2833. #: ikiwiki/directive/toggle.mdwn:33
  2834. msgid ""
  2835. "If you'd like a toggleable to be displayed by default, and toggle to hidden, "
  2836. "then pass a parameter \"open=yes\" when setting up the toggleable."
  2837. msgstr ""
  2838. #. type: Plain text
  2839. #: ikiwiki/directive/toggleable.mdwn:1
  2840. #, no-wrap
  2841. msgid "[[!meta redir=/ikiwiki/directive/toggle]]\n"
  2842. msgstr ""
  2843. #. type: Plain text
  2844. #: ikiwiki/directive/version.mdwn:2
  2845. msgid ""
  2846. "The `version` directive is supplied by the [[!iki plugins/version "
  2847. "desc=version]] plugin."
  2848. msgstr ""
  2849. #. type: Plain text
  2850. #: ikiwiki/directive/version.mdwn:4
  2851. msgid "This directive allows inserting the version of ikiwiki onto a page."
  2852. msgstr ""
  2853. #. type: Plain text
  2854. #: ikiwiki/directive/version.mdwn:7
  2855. msgid ""
  2856. "Whenever ikiwiki is upgraded to a new version, the page will be rebuilt, "
  2857. "updating the version number."
  2858. msgstr ""
  2859. #. type: Plain text
  2860. #: ikiwiki/directive/version.mdwn:9
  2861. msgid "Use is simple:"
  2862. msgstr ""
  2863. #. type: Plain text
  2864. #: ikiwiki/directive/version.mdwn:11
  2865. #, no-wrap
  2866. msgid "\t\\[[!version ]]\n"
  2867. msgstr ""