Switch branches/tags
Nothing to show
Find file History
Pull request Compare This branch is 2 commits ahead, 217 commits behind getpelican:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



This is a modified version of the default tag_cloud, which creates a tag cloud for each category. To read more about it, see my blog post here: http://tommyblanchard.com/unique-tag-cloud-for-each-category-in-pelican


In order to use to use this plugin, you have to edit(*) or create(+) the following files:

  ├── pelicanconf.py *
  ├── content
  ├── plugins +
  │     └── tag_cloud.py +
  └── themes
        └── mytheme
              ├── templates
              │      └── base.html *
              └── static
                    └── css
                         └── style.css *

In pelicanconf.py you have to activate the plugin:

PLUGIN_PATHS = ["plugins"]
PLUGINS = ["tag_cloud"]

Into your plugins folder, you should add tag_cloud.py (from this repository).

In your theme files, you should change base.html to apply formats (and sizes) defined in style.css, as specified in "Settings", below.


Setting name (followed by default value) What does it do?
TAG_CLOUD_STEPS = 4 Count of different font sizes in the tag cloud.
TAG_CLOUD_MAX_ITEMS = 100 Maximum number of tags in the cloud.
TAG_CLOUD_SORTING = 'random' The tag cloud ordering scheme. Valid values: random, alphabetically, alphabetically-rev, size and size-rev
TAG_CLOUD_BADGE = True Optionnal setting : can bring badges, which mean say : display the number of each tags present on all articles.

The default theme does not include a tag cloud, but it is pretty easy to add one (should be added to the article.html template):

<div id="tagcloud">
{% for cat in tag_cloud %}
{% if article.category == cat.0 %}

<b><center>{{ cat.0 }} Tags</center></b> <ul class="tagcloud">

{% for tag in cat.1 %}
<li class="tag-{{ tag.1 }}">
<a href="{{ SITEURL }}/{{ tag.0.url }}">

{{ tag.0 }} {% if TAG_CLOUD_BADGE %}

<span class="badge">({{ tag.2 }})</span>

{% endif %}



{% endfor %}


{% endif %}

{% endfor %}


The placement of the code depends a bit on how you plan to style it and where you want it to show up. I have mine near the top, right below {% block content %}

To add the tag cloud to the tags and categories pages, the same code needs to be added to index.html. Place it within the first item conditional, right after this:

{# First item #} {% if loop.first and not articles_page.has_previous() %}

You should then also define CSS styles with appropriate classes (tag-1 to tag-N, where N matches TAG_CLOUD_STEPS), tag-1 being the most frequent, and define a ul.tagcloud class with appropriate list-style to create the cloud. You should copy/paste this badge CSS rule ul.tagcloud .list-group-item <span>.badge if you're using TAG_CLOUD_BADGE setting. (this rule, potentially long , is suggested to avoid conflicts with CSS libs as twitter Bootstrap)

For example:

ul.tagcloud {
  list-style: none;
    padding: 0;

ul.tagcloud li {
    display: inline-block;

li.tag-1 {
    font-size: 150%;

li.tag-2 {
    font-size: 120%;


ul.tagcloud .list-group-item <span>.badge {
    background-color: grey;
    color: white;

By default the tags in the cloud are sorted randomly, but if you prefers to have it alphabetically use the alphabetically (ascending) and alphabetically-rev (descending). Also is possible to sort the tags by it's size (number of articles with this specific tag) using the values size (ascending) and size-rev (descending).