docs: change theme to sphinx_rtd_theme

Changed docs theme to a better, mobile friendly one:
https://github.com/readthedocs/sphinx_rtd_theme

The duplicate labels were removed, as the sphinx extension
sphinx.ext.autosectionlabel requires unique titles (labels).

Change-Id: Ife17206c3b2370250388692a9330585f5193e450

doc/source/conf.py

@@ -34,7 +34,8 @@ from cloudbaseinit import version as cbs_version
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.viewcode',
-    'oslo_config.sphinxext'
+    'oslo_config.sphinxext',
+    'sphinx.ext.autosectionlabel',
 
 ]
 
@@ -116,7 +117,7 @@ todo_include_todos = False
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'classic'
+html_theme = 'sphinx_rtd_theme'
 
 # 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

doc/source/intro.rst

@@ -1,5 +1,3 @@
-.. _intro:
-
 Intro
 =====
 

doc/source/plugins.rst

@@ -1,5 +1,3 @@
-.. _plugins:
-
 Plugins
 =======
 
@@ -69,7 +67,8 @@ password isn't found in metadata, then an attempt of using an already set
 password is done (usually a random value by the `createuser` plugin).
 With `first_logon_behaviour` you can control what happens with the password at
 the next logon. If this option is set to "always", the user will be forced to
-change the password at the next logon. If it is set to "clear_text_injected_only",
+change the password at the next logon.
+If it is set to "clear_text_injected_only",
 the user will be forced to change the password only if the password is a
 clear text password, coming from the metadata. The last option is "no",
 when the user is never forced.

doc/source/services.rst

@@ -1,5 +1,3 @@
-.. _services:
-
 Services
 ========
 
@@ -118,8 +116,8 @@ Config options:
 .. note:: http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html
 
 
-CloudStack
-----------
+Apache CloudStack
+-----------------
 
 .. class:: cloudbaseinit.metadata.services.cloudstack.CloudStack
 
@@ -145,8 +143,8 @@ Config options:
           server.
 
 
-OpenNebula
-----------
+OpenNebula Service
+------------------
 
 .. class:: cloudbaseinit.metadata.services.opennebulaservice.OpenNebulaService
 
@@ -180,8 +178,9 @@ Capabilities:
     * authentication certificates (x509)
     * user data
 
-OVF
----
+
+Open Virtualization Format (OVF)
+--------------------------------
 
 .. class:: cloudbaseinit.metadata.services.ovfservice.OvfService
 

doc/source/tutorial.rst

@@ -1,5 +1,3 @@
-.. _tutorial:
-
 Tutorial
 ========
 

doc/source/userdata.rst

@@ -1,5 +1,3 @@
-.. _userdata:
-
 Userdata
 ========
 

tox.ini

@@ -38,6 +38,8 @@ commands =
 
 [testenv:docs]
 basepython = python3
+deps =
+  sphinx_rtd_theme
 commands =
   sphinx-build -a -E -W -d doc/build/doctrees -b html doc/source doc/build/html