ikiwiki/doc/plugins/tag.mdwn

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

This plugin provides the [[ikiwiki/directive/tag]] and 
[[ikiwiki/directive/taglink]] [[directives|ikiwiki/directive]].
These directives allow tagging pages.

It also provides the `tagged()` [[ikiwiki/PageSpec]], which can be used to
match pages that are tagged with a specific tag.

The `tagbase` setting can be used to make tags default to being put in a
particular subdirectory.

The `tag_autocreate` setting can be used to control whether new tag pages
are created as needed. It defaults to being done only if a `tagbase` is
set.

The `tag_autocreate_commit` setting is enabled by default, and causes
new tag pages to be checked into version control.

[[!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.
"""]]
Migrate doc/plugins via prefix_directives This is a partial commit of: egrep -rl '\[\[[a-z]+ ' doc \| xargs --max-args 1 ./ikiwiki-transition prefix_directives 2008-07-21 13:31:57 +02:00			`[[!template id=plugin name=tag author="[[Joey]]"]]`
			`[[!tag type/tags type/link]]`
* 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
reword after reorg There was a duplicated paragraph, an example on the wrong page, and some rewording needed after will's reorg. 2008-09-12 00:14:26 +02:00			`This plugin provides the [[ikiwiki/directive/tag]] and`
			`[[ikiwiki/directive/taglink]] [[directives\|ikiwiki/directive]].`
patch plugin documentation to refer to directive pages 2008-09-11 23:05:51 +02:00			`These directives allow tagging pages.`
* Add taglink preprocessor directive, supporting visible tag links. Closes: #443344 2007-09-20 20:59:27 +02:00
rename tag() to tagged(); add docs 2009-02-20 00:54:25 +01:00			It also provides the `tagged()` [[ikiwiki/PageSpec]], which can be used to
			`match pages that are tagged with a specific tag.`

turn on tag_autocreate by default if tagbase is set 2010-04-22 02:39:20 +02:00			The `tagbase` setting can be used to make tags default to being put in a
			`particular subdirectory.`

			The `tag_autocreate` setting can be used to control whether new tag pages
			are created as needed. It defaults to being done only if a `tagbase` is
			`set.`
document tag_autocreate 2010-04-21 21:22:05 +02:00
documentation 2011-02-09 19:27:22 +01:00			The `tag_autocreate_commit` setting is enabled by default, and causes
			`new tag pages to be checked into version control.`

misc minor changes 2008-09-12 00:29:07 +02: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.`
			`"""]]`