Make examples buildable

It now excludes .tox from conf.py.
It locally clones docutils cheatsheet as examples (it should be noted
that cheatsheet.txt is renamed index.rst in it).

[1] https://docutils.sourceforge.io/docs/user/rst/cheatsheet.txt

Issue-ID: DOC-772

Signed-off-by: Cédric Ollivier <cedric.ollivier@orange.com>
Change-Id: Ifd616b797d5a48da5df77b0dfaa0613497b742d8

1 files changed, 19 insertions, 0 deletions

diff --git a/examples/sphinx/istanbul/conf.py b/examples/sphinx/istanbul/conf.py
new file mode 100644
index 000000000..1d6c7d357
--- /dev/null
+++ b/examples/sphinx/istanbul/conf.py
@@ -0,0 +1,19 @@
+from docs_conf.conf import *
+
+branch = 'istanbul'
+master_doc = 'index'
+
+linkcheck_ignore = [
+    'http://localhost',
+]
+
+exclude_patterns = [
+    '.tox'
+]
+
+intersphinx_mapping = {}
+
+html_last_updated_fmt = '%d-%b-%y %H:%M'
+
+def setup(app):
+    app.add_css_file("css/ribbon.css")