diff --git a/ckan/templates/base.jinja.html b/ckan/templates/base.jinja.html
index 2e7068aab52..55bedab4c0b 100644
--- a/ckan/templates/base.jinja.html
+++ b/ckan/templates/base.jinja.html
@@ -1,20 +1,92 @@
+{# Allows the DOCTYPE to be set on a page by page basis #}
{% block doctype %}{% endblock %}
+
+{# Allows custom attributes to be added to the tag #}
{% block htmltag %}{% endblock %}
+
+ {# Allows custom attributes to be added to the
tag #}
{% block headtag %}{% endblock %}
+ {#
+ Add custom meta tags to the page. Call super() to get the default tags
+ such as charset, viewport and generator.
+
+ Example:
+
+ {% block meta %}
+ {{ super() }}
+
@@ -13,19 +21,50 @@
{% block actions %}{% endblock %}
{% endblock %}
+
{% block primary %}
+ {#
+ The primary_content block can be used to add content to the page.
+ This is the main block that is likely to be used within a template.
+
+ Example:
+
+ {% block primary_content %}
+
My page content
+
Some content for the page
+ {% endblock %}
+ #}
{% block primary_content %}{% endblock %}
{% endblock %}
+
{% block secondary %}
{% endblock %}
{% endblock %}
+
+ {#
+ Override the footer on a page by page basis by extending this block. If
+ making sitewide header changes it is preferable to override the footer.html
+ file.
+ #}
{% block footer %}
{% include "footer.jinja.html" %}
{% endblock %}