Fix gate-fuel-docs-docs CI job

* Add tox.ini, setup.cfg and setup.py to allow docs building
using tox and setuptools
* Set doc/build as an output dir in setup.cfg to allow doc
publishing by gate-fuel-docs-docs job
* Add '.tox' and '*egg' paths to exclude_patterns in conf.py
* Add stub index.rst with basic info and link to the web verstion
of the docs to fix building of manpages
* Add '.tox' dir to .gitignore

Change-Id: Iaec750d6035bd0e30c10a12142be35514df1fb15

.gitignore

@@ -3,3 +3,5 @@
 /_images/*_svg.jpg
 /_images/*.pdf
 /.idea
+/.tox
+/doc

conf.py

@@ -14,4 +14,4 @@
 # -- Default Settings -----------------------------------------------------
 execfile('./common_conf.py')
 
-exclude_patterns = ['_*', 'pages', 'contents', 'pdf']
+exclude_patterns = ['_*', 'pages', 'contents', 'pdf', '.tox', '*egg']

index.rst

@@ -0,0 +1,30 @@
+:orphan:
+
+.. index:: Fuel Documentation
+
+.. _Manpage:
+
+=============================
+Fuel Documentation
+=============================
+
+Mirantis OpenStack consists of the following components:
+
+* Hardened packages
+    Mirantis OpenStack includes the core OpenStack projects updated with
+    each stable release of OpenStack and supporting a broad range of
+    operating systems, hypervisors, and deployment topologies.
+
+* Fuel software
+    Fuel is an open source, software lifecycle management application
+    that deploys multiple OpenStack (https://www.openstack.org/)
+    environments from a single interface and then enables you to manage
+    those environments post deployment.
+
+* Support
+    After you complete your evaluation of Mirantis OpenStack,
+    get support for Mirantis OpenStack from the industry experts.
+    For more information go to
+    https://www.mirantis.com/services/enterprise-support-services/
+
+To view the HTML version of documentation, go to http://docs.mirantis.com

setup.cfg

@@ -0,0 +1,13 @@
+[metadata]
+name = fuel-docs
+version = 7.0.0
+author = Mirantis
+author-email = fuel-dev@lists.launchpad.net
+
+[build_sphinx]
+all_files = 1
+build-dir = doc/build
+source-dir = .
+
+[wheel]
+universal = 1

setup.py

@@ -0,0 +1,20 @@
+#    Copyright 2015 Mirantis, Inc.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License"); you may
+#    not use this file except in compliance with the License. You may obtain
+#    a copy of the License at
+#
+#         http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+#    License for the specific language governing permissions and limitations
+#    under the License.
+
+import setuptools
+
+
+setuptools.setup(
+    setup_requires=['pbr'],
+    pbr=True)

tox.ini

@@ -0,0 +1,12 @@
+[tox]
+minversion = 1.6
+skipsdist = True
+
+[testenv]
+usedevelop = True
+install_command = pip install --allow-external -U {opts} {packages}
+setenv = VIRTUAL_ENV={envdir}
+deps = -r{toxinidir}/requirements.txt
+
+[testenv:venv]
+commands = {posargs:}