Customizing Stationery for Output Format-Specific Features : Customizations Specific to Wiki Markup : Defining Wiki Categories or Labels
Defining Wiki Categories or Labels
On Wikis, categories, which are referred to as labels in some Wiki formats, are used to organize Wiki content. Categories help group together pages that have similar subjects.
Note: MoinMoin and Media Wiki use the term category to describe page grouping functionality. Confluence uses the term label to describe page grouping functionality.
Pages are assigned to category groups through the use of category or label tags. When you assign a category or label tag to a Wiki page, the category to which the Wiki page belongs displays in a box at the bottom of the page.
Category and label tags on Wiki pages allow categorized pages to automatically be added to a list on a category page on the Wiki. The category page lists all of the Wiki pages tagged for a certain category. For example, if you tag each page on a Wiki that contains licensing information with a Licensing category tag, then a licensing category page on the Wiki can display a list of all of the pages tagged as containing licensing information.
If you enable Wiki category functionality in your Stationery, writers can use the WikiCategory marker in their source documents to assign topics to a category. The category writers assign to a topic will display in a box at the bottom of the Wiki page when they generate Wiki output, and the topic can be listed as a link on a category page on the Wiki.
To enable specifying category or label tags in source documents you need to enable the WikiCategory marker. By default, ePublisher sets the Marker type option for a marker named WikiCategory to WikiCategory. You can create a marker with a different name and set the Marker type option for that marker to WikiCategory. Then, writers can use this marker in the source documents to specify categories for Wiki topics. For more information about which output formats support this feature, see “Features Available in Each Output Format”.
To assign WikiCategory behavior to WikiCategory markers
1. Open your Stationery design project.
2. On the View menu, click Style Designer.
3. In the Marker Styles, select the marker style you want to modify.
4. On the Options tab, set Marker type to WikiCategory.