ikiwiki/doc/plugins/tag.mdwn

[[template id=plugin name=tag author="[[Joey]]"]]
[[tag type/tags type/link]]

This plugin allows tagging pages. List tags as follows:

	\[[tag tech life linux]]

The tags work the same as if you had put a (hidden) [[ikiwiki/WikiLink]] on
the page for each tag, so you can use a [[ikiwiki/PageSpec]] match all
pages that are tagged with a given tag, for example. The tags will also
show up on blog entries and at the bottom of the tagged pages, as well as
in RSS and Atom feeds.

If you want a visible [[ikiwiki/WikiLink]] along with the tag, use taglink
instead:

	\[[taglink foo]]
	\[[taglink tagged_as_foo|foo]]

This plugin has a configuration option. Set --tagbase=tags and links to tags
will be located under the specified base page. If ikiwiki is configured
this way, then the example above actually tags the page with the tags
tags/tech, tags/life, and tags/linux. This is a useful way to avoid
having to write the full path to tags, if you want to keep them grouped
together out of the way.

[[if test="enabled(tag)" then="""
This wiki has the tag plugin enabled, so you'll see a note below that this
page is tagged with the "tags" tag.
"""]]
simplified plugin definitions 2007-02-13 19:51:21 +01:00			`[[template id=plugin name=tag author="[[Joey]]"]]`
* Allow preprocessor directives to contain python-like triple-quoted text blocks, for easy nesting of quotes inside. * Add a template plugin. * Use the template plugin to add infoboxes to each plugin page listing basic info about the plugin. 2006-08-23 07:41:07 +02:00			`[[tag type/tags type/link]]`

* Patch from Enrico that - allows preprocessor directives to have parameters with no specified value - fixes preprocessor directive parameter parsing so that foo=bar baz now means "foo=bar" and a "baz" with no value - Add a tag plugin that allows more easily tagging pages. The meta plugin can also still be used for this. 2006-07-27 23:38:02 +02:00			`This plugin allows tagging pages. List tags as follows:`

don't need double-escape on indented literal text as markdown doesn't mess with it 2006-07-28 02:33:57 +02:00			`\[[tag tech life linux]]`
* Patch from Enrico that - allows preprocessor directives to have parameters with no specified value - fixes preprocessor directive parameter parsing so that foo=bar baz now means "foo=bar" and a "baz" with no value - Add a tag plugin that allows more easily tagging pages. The meta plugin can also still be used for this. 2006-07-27 23:38:02 +02:00
fix up some links 2007-12-09 02:04:18 +01:00			`The tags work the same as if you had put a (hidden) [[ikiwiki/WikiLink]] on`
			`the page for each tag, so you can use a [[ikiwiki/PageSpec]] match all`
			`pages that are tagged with a given tag, for example. The tags will also`
			`show up on blog entries and at the bottom of the tagged pages, as well as`
			`in RSS and Atom feeds.`
* Patch from Enrico that - allows preprocessor directives to have parameters with no specified value - fixes preprocessor directive parameter parsing so that foo=bar baz now means "foo=bar" and a "baz" with no value - Add a tag plugin that allows more easily tagging pages. The meta plugin can also still be used for this. 2006-07-27 23:38:02 +02:00
fix up some links 2007-12-09 02:04:18 +01:00			`If you want a visible [[ikiwiki/WikiLink]] along with the tag, use taglink`
			`instead:`
* Add taglink preprocessor directive, supporting visible tag links. Closes: #443344 2007-09-20 20:59:27 +02:00
			`\[[taglink foo]]`
make taglink support the same method for specifying link text as a regular wikilink 2007-09-22 19:07:51 +02:00			`\[[taglink tagged_as_foo\|foo]]`
* Add taglink preprocessor directive, supporting visible tag links. Closes: #443344 2007-09-20 20:59:27 +02:00
web commit by JoshTriplett: Fix typo. 2007-02-14 02:57:35 +01:00			`This plugin has a configuration option. Set --tagbase=tags and links to tags`
clarify 2006-08-19 07:26:02 +02:00			`will be located under the specified base page. If ikiwiki is configured`
			`this way, then the example above actually tags the page with the tags`
			`tags/tech, tags/life, and tags/linux. This is a useful way to avoid`
			`having to write the full path to tags, if you want to keep them grouped`
			`together out of the way.`
* Add getopt hook type, this allows plugins to add new command-line options. * Add --tagbase option to tag plugin. 2006-07-28 07:26:49 +02:00
web commit by JoshTriplett: Use conditional. 2007-02-14 03:00:40 +01:00			`[[if test="enabled(tag)" then="""`
			`This wiki has the tag plugin enabled, so you'll see a note below that this`
			`page is tagged with the "tags" tag.`
			`"""]]`