Preparing Adobe FrameMaker Source Documents : Specifying Wiki Categories or Labels in FrameMaker
Specifying Wiki Categories or Labels in FrameMaker
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.
The following procedure provides an example of how to specify categories for Wiki pages in Adobe FrameMaker source documents using unstructured Adobe FrameMaker 7.2. Steps for specifying categories in Adobe FrameMaker may be different in other versions of Adobe FrameMaker.
To specify a Wiki category or label for a topic in an Adobe FrameMaker source document
1. In your Adobe FrameMaker source document, find the first paragraph on the page for the page for which you want to specify a category or label.
2. Insert your cursor into the paragraph.
3. On the Special menu, click Marker.
4. In the Marker Type field, select WikiCategory from the drop-down list.
5. If the WikiCategory marker type is not on the drop-down list, check with the Stationery designer to obtain the name of the marker type the Stationery designer created to support this functionality and then use the marker type specified by the Stationery designer. For more information, refer to “Implementing Online Features in FrameMaker”.
6. In the Marker Text field, type the category or list of categories you want to specify for the page. If you want to specify more than one category for a page, separate each category with a comma (,).
For example, if you want to specify one category for the page, type category1. If you want to specify multiple categories for the page, type category1, category2, category3, where category is the category you want to specify for the page.
Note: Each Wiki target handles white space in it own way. For example, MoinMoin removes white space in category names, so if you specify Licensing Considerations as a category in a WikiCategory marker, in MoinMoin output the category will display as LicensingConsiderations.
7. Click New Marker.
8. Save your Adobe FrameMaker source document.
9. Generate output for your Wiki target. For more information, see “Generating Output”.
10. Deploy the Wiki output files to a Wiki server. For more information, see “Deploying Output to Output Destinations”.
Note: You must deploy generated Wiki content to a Wiki server before you can view the Wiki content.
11. Verify that your Wiki pages display the categories or labels you specified at the bottom of the pages.