Initial support to generate local documentation

Author: dmacvicar

docs/.gitignore

@@ -0,0 +1,2 @@
+build
+__pycache__

docs/Makefile

@@ -0,0 +1,21 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = ../website/docs
+BUILDDIR      = build
+ROOT_DIR:=$(shell dirname $(realpath $(lastword $(MAKEFILE_LIST))))
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -b $@ -c $(ROOT_DIR) "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/README.md

@@ -0,0 +1,15 @@
+
+# Generating documentation
+
+Requirements:
+
+* Sphinx
+* Python recommonmark
+* sphinx_rtd_theme
+
+Then do:
+
+```
+make html
+```
+

docs/conf.py

@@ -0,0 +1,38 @@
+# -*- coding: utf-8 -*-
+import subprocess
+import os
+import sys
+sys.path.insert(0, os.path.abspath('.'))
+from recommonmark.transform import AutoStructify
+
+project = 'terraform-provider-libvirt'
+copyright = '2019, Duncan Mac-Vicar P. & contributors'
+author = 'Duncan Mac-Vicar P.'
+
+version = subprocess.check_output(('git', 'describe', '--tags')).decode("utf-8")
+
+source_suffix = {
+    '.html.markdown': 'markdown',
+}
+
+templates_path = ['_templates']
+exclude_patterns = ["_build"]
+html_theme = 'sphinx_rtd_theme'
+extensions = ['removefrontmatter','recommonmark']
+
+html_theme_options = {
+    'collapse_navigation': False,
+}
+
+master_doc = 'toc'
+
+def setup(app):
+    app.add_config_value('recommonmark_config', {
+        'enable_eval_rst': True,
+        'auto_toc_tree_section': 'Resources',
+        'auto_toc_maxdepth': 3,
+        'commonmark_suffixes': ['.html.markdown'],
+    }, 'env')
+    app.add_transform(AutoStructify)
+
+

docs/removefrontmatter.py

@@ -0,0 +1,8 @@
+import re
+
+# Remove the frint matter (YAML) from markdown files
+def source_read_handler(app, docname, source):
+    source[0] = re.sub(r'^---\n(.+\n)*---\n', '', source[0])
+
+def setup(app):
+    app.connect('source-read', source_read_handler)

website/docs/resources.html.markdown

@@ -0,0 +1,9 @@
+
+# Resources
+
+```eval_rst
+.. toctree::
+   :glob:
+
+   r/**
+```

website/docs/toc.html.markdown

@@ -0,0 +1,14 @@
+
+# terraform-provider-libvirt Documentation
+
+```eval_rst
+.. toctree::
+   index
+```
+
+```eval_rst
+.. toctree::
+   :maxdepth: 2
+
+   resources
+```