DocPad plugin providing tag cloud generation
npm install docpad-plugin-tagcloud``
npm install --save docpad-plugin-tagcloud
This plugin supercedes the now deprecated Tagging plugin for Docpad >= 6.46. It works in conjunction with the new Tags plugin.
Generate tag index pages for your documents as described in the Tags plugin.
The plugin adds the @getTagCloud() template helper, which returns an object containing the tag cloud data of the form:
`
yellow:
tag: "yellow" // the tag name
url: "/tags/yellow" // URL of the tag index page
count: 5 // number of documents containing the tag
weight: 0.25 // weight of the tag
blue:
tag: "blue"
url: "/tags/blue"
count: 3
weight: 0.12
...
The following example iterates through the tag cloud and generates links to the tag index pages (in eco):
`
<% for tag, data of @getTagCloud(): %>
<%= tag %>
<% end %>
Note that in this example we've added the count and weight here as HTML5 data fields so that a client-side script can apply the desired styling. You can of course do whatever you wish with the count or weight values, such as adding inline CSS for setting the font-size (but of course we don't do that kind of thing anymore right?)
- collectionName : The collection containing your tag index pages. This should probably be the same as specified for the tags plugin.
- getTagWeight : Override the function used to generate the tag weights (see below).
- logLevel: Override the log level for log messages from this plugin. Defaults to 'info'.
By default, the tag weights are calculated using a simple logarithmic algorithm. If that isn't floating your proverbial boat you are free to override this function with the weight function of your choosing. For example in your docpad config you could add:
`
plugins:
tagging:
getTagWeight: (count, maxCount) ->
return count/maxCount
Here count is the number of occurences of the tag, and maxCount is the count of the tag with the highest number of occurrences.