add docstrings and static html documentation

docs/source/_static/custom.css

@@ -0,0 +1,7 @@
+/*
+ * basic.css
+ * https://github.com/sphinx-doc/sphinx/blob/master/sphinx/themes/basic/static/basic.css_t
+ */
+table.indextable tr.cap {
+    background-color: transparent;
+}

docs/source/conf.py

@@ -0,0 +1,80 @@
+# Configuration file for the Sphinx documentation builder.
+#
+# This file only contains a selection of the most common options. For a full
+# list see the documentation:
+# http://www.sphinx-doc.org/en/master/config
+
+# -- Path setup --------------------------------------------------------------
+
+# 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.
+#
+import os
+import sys
+sys.path.insert(0, os.path.abspath('../..'))
+
+
+# -- Project information -----------------------------------------------------
+
+project = 'material'
+copyright = '2019, Daniel Weschke'
+author = 'Daniel Weschke'
+
+# The full version, including alpha/beta/rc tags
+release = '2019.5.18'
+
+
+# -- General configuration ---------------------------------------------------
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions = [
+  'sphinx.ext.autodoc'
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = []
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = 'alabaster'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = ['_static']
+
+html_context = {
+  'css_files': ['_static/custom.css'],
+}
+
+# https://alabaster.readthedocs.io/en/latest/customization.html
+# https://github.com/bitprophet/alabaster/blob/master/alabaster/static/alabaster.css_t
+# https://github.com/bitprophet/alabaster/blob/master/alabaster/theme.conf
+# https://github.com/sphinx-doc/sphinx/blob/master/sphinx/themes/basic/static/basic.css_t
+html_theme_options = {
+  'base_bg': '#292b2e',
+  'base_text': '#b2b2b2',
+  'body_text': '#b2b2b2',
+  'code_text': '#b2b2b2',
+  'code_hover': 'transparent',
+  'sidebar_text': '#b2b2b2',
+  'sidebar_link': '#b2b2b2',
+  'sidebar_header': '#b2b2b2',
+  'link': '#5799b9',
+  'link_hover': '#cc3333',
+  'highlight_bg': '#444F65',
+  'xref_bg': 'transparent',
+  'xref_border': 'transparent',
+}

docs/source/index.rst

@@ -0,0 +1,20 @@
+.. material documentation master file, created by
+   sphinx-quickstart on Sat May 18 15:51:55 2019.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Welcome to material's documentation!
+====================================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`

docs/source/materials.rst

@@ -0,0 +1,7 @@
+materials module
+================
+
+.. automodule:: materials
+    :members:
+    :undoc-members:
+    :show-inheritance:

docs/source/modules.rst

@@ -0,0 +1,7 @@
+src
+===
+
+.. toctree::
+   :maxdepth: 4
+
+   materials