From 28ed75778ada23fa3130a6a0cc4d841288b56d55 Mon Sep 17 00:00:00 2001
From: Daniel Goldsmith <dgold@ascraeus.org>
Date: Tue, 6 Aug 2013 13:17:25 +0100
Subject: [PATCH] Made tag_cloud a list as per apparent consensus.

---
 docs/settings.rst | 32 +++++++++++++++++++++-----------
 1 file changed, 21 insertions(+), 11 deletions(-)

diff --git a/docs/settings.rst b/docs/settings.rst
index 44585b32..aafeb22e 100644
--- a/docs/settings.rst
+++ b/docs/settings.rst
@@ -521,22 +521,32 @@ Setting name (default value)                        What does it do?
 
 The default theme does not include a tag cloud, but it is pretty easy to add::
 
-    <p>
+    <ul class="tagcloud">
         {% for tag in tag_cloud %}
-            <span class="tag-{{ tag.1 }}"><a href="{{ SITEURL }}/{{ tag.0.url }}">{{ tag.0 }}</a>&nbsp;</span>
+            <li class="tag-{{ tag.1 }}"><a href="{{ SITEURL }}/{{ tag.0.url }}">{{ tag.0 }}</a></li>
         {% endfor %}
-    </p>
+    </ul>
 
-You should then also define a CSS style with the appropriate classes (tag-0 to tag-N, where
-N matches `TAG_CLOUD_STEPS` -1), tag-0 being the largest.
+You should then also define CSS styles with appropriate classes (tag-0 to tag-N, where
+N matches `TAG_CLOUD_STEPS` -1), tag-0 being the most frequent, and define a ul.tagcloud 
+class with appropriate list-style to create the cloud, for example::
 
-      span.tag-0 {
-      font-size: 150%;
-      }
+    ul.tagcloud {
+    	list-style: none;
+        padding: 0;
+    }
 
-      span.tag-1 {
-      font-size: 120%;
-      }
+    ul.tagcloud li {
+        display: inline-block;
+    }
+
+    li.tag-0 {
+        font-size: 150%;
+    }
+
+    li.tag-1 {
+        font-size: 120%;
+    }
 
       ...