Merge branch 'feature/review-docs-build' into develop

Author: Fantomas42

docs/conf.py

@@ -11,15 +11,17 @@
 #
 # All configuration values have a default; values that are commented out
 # serve to show the default.
-
-import sys
 import os
-import shlex
+import re
+import sys
 
-# If extensions (or modules to document with autodoc) are in another directory,
-# add these directories to sys.path here. If the directory is relative to the
-# documentation root, use os.path.abspath to make it absolute, like shown here.
-#sys.path.insert(0, os.path.abspath('.'))
+from datetime import date
+HERE = os.path.abspath(os.path.dirname(__file__))
+
+sys.path.append(HERE)
+sys.path.append(os.path.join(HERE, '..'))
+
+import tagging
 
 # -- General configuration ------------------------------------------------
 
@@ -34,6 +36,10 @@
     'sphinx.ext.intersphinx',
 ]
 
+intersphinx_mapping = {
+    'django': ('http://readthedocs.org/docs/django/en/latest/', None),
+}
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -49,18 +55,18 @@
 master_doc = 'index'
 
 # General information about the project.
-project = u'django-tagging'
-copyright = u'2015, Fantomas42'
-author = u'Fantomas42'
+project = u'Django Tagging'
+copyright = '%s, %s' % (date.today().year, tagging.__maintainer__)
+author = tagging.__author__
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
-# The short X.Y version.
-version = '0.4'
 # The full version, including alpha/beta/rc tags.
-release = '0.4.dev0'
+release = tagging.__version__
+# The short X.Y version.
+version = re.match(r'\d+\.\d+(?:\.\d+)?', release).group()
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -111,7 +117,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'alabaster'
+html_theme = 'default'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -285,7 +291,3 @@
 
 # If true, do not generate a @detailmenu in the "Top" node's menu.
 #texinfo_no_detailmenu = False
-
-
-# Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'https://docs.python.org/': None}