A popular way of displaying all of the Tags on a wiki is called a tag cloud (also called a weighted list). This ranks the tags by popularity (i.e., how often they occur on wiki pages) and displays the result as a cloud, a bounded area showing all tags. As implemented on sites like Flickr or del.icio.us, tag clouds provide an easy means to categorize and navigate based on user-assigned properties.

As described on Wikipedia's Tag Cloud page:

The TagCloudPlugin is an implementation of the second type described above.

---

Description#

The TagCloudPlugin provides a display of all available tags, displayed either as a tag cloud, or in various other ways.

Parameters#

output='format'

an optional parameter setting the formatting of the generated output. Values include: "cloud" (the default), "none", "count", "list", "bullet", "number", "space", "comma", "colon", and "bar". For the complete description of output formats, see Alternative Output Formats.

exclude='regex'

an optional parameter that excludes tags matching the 'regex' (Regular Expression) from being displayed.

Output Styles#

The display of the generated output is dictated entirely by the CSS stylesheet. There are seven selectors in the jspwiki.css stylesheet: .tagcloud, .tagcloud a, .tagcloud .s1, .tagcloud .s2, .tagcloud .s3, .tagcloud .s4, .tagcloud .s5, the last five corresponding to color and size changes for the five tag incidence levels.

---

Examples#

The default output:

  [{TagCloud}]

Excluding all tags beginning with "P" (or "p"):

  [{TagCloud exclude='[Pp].*'}]

Excluding all tags having only a single incidence:

  [{TagCloud mincount='2'}]

Excluding all tags having only a single incidence and all tags beginning with "P" (or "p"):

  [{TagCloud mincount='2' exclude='[Pp].*'}]

Displayed as a comma-separated list:

  [{TagCloud output='comma'}]

---