updating documentation and plex_posters

plex-posters/docs/source/_static/custom.css

@@ -0,0 +1,31 @@
+@import url("css/theme.css");
+
+.modname {
+    font-size: 0.8em;
+    opacity: 0.4;
+}
+.modname::before {
+    content: '- ';
+}
+.title {
+    font-weight: bold;
+    font-size: 1.2em;
+    background-color: #eee;
+    display: block;
+    padding: 1px 5px;
+    border-left: 2px solid #ddd;
+}
+
+.wy-menu-vertical header, .wy-menu-vertical p.caption{
+    color: ##466A54;;
+}
+
+.wy-side-nav-search{
+    background-color: #0E6458;
+}
+
+.rst-content dl:not(.docutils) dt{
+    background: #F2E7D3;
+    color: #499265;
+    border-top: solid 3px #87CB7C;
+}

plex-posters/docs/source/changelog.rst

@@ -0,0 +1,7 @@
+Version history
+================
+
+0.1.0 (28/11/19)
+----------------
+
+- Initial release.

plex-posters/docs/source/conf.py

@@ -0,0 +1,94 @@
+# 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:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- 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('.'))
+import plex_posters
+from plex_posters.__version__ import __version__ as version
+import sphinx_rtd_theme
+
+# -- Project information -----------------------------------------------------
+
+project = 'plex_posters'
+copyright = '2019, Daniel Tomlinson'
+author = 'Daniel Tomlinson'
+
+# The full version, including alpha/beta/rc tags
+release = version
+
+
+# -- 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',
+    'sphinx.ext.viewcode',
+    'sphinx.ext.napoleon',
+    'sphinx.ext.todo',
+]
+
+# -- Napoleon Settings -----------------------------------------------------
+napoleon_google_docstring = False
+napoleon_numpy_docstring = True
+napoleon_include_init_with_doc = True
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = False
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = True
+napoleon_use_param = True
+napoleon_use_rtype = True
+napoleon_use_keyword = True
+autodoc_member_order = 'bysource'
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ['_templates']
+
+# The master toctree document.
+master_doc = 'index'
+
+# 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 = "sphinx_rtd_theme"
+
+# 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_theme = "sphinx_rtd_theme"
+html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
+html_static_path = ['_static']
+html_context = {'css_files': ['_static/custom.css']}
+html_theme_options = {
+    'collapse_navigation': True,
+    'display_version': True,
+    #'navigation_depth': 3,
+}
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = 'sphinx'
+
+# Enable todo
+todo_include_todos = True

plex-posters/docs/source/configuration.rst

@@ -0,0 +1,4 @@
+Configuration
+=============
+
+.. todo:: fill in configuration options

plex-posters/docs/source/global.rst

@@ -0,0 +1,5 @@
+.. role:: modname
+   :class: modname
+
+.. role:: title
+   :class: title

plex-posters/docs/source/index.rst

@@ -0,0 +1,3 @@
+Table of Contents
+=================
+.. include:: toc.rst

plex-posters/docs/source/introduction.rst

@@ -0,0 +1 @@
+.. include:: ../../README.rst

plex-posters/docs/source/modules/modules.rst

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

plex-posters/docs/source/modules/plex_posters.config.config.rst

@@ -0,0 +1,9 @@
+.. include:: ../global.rst
+
+Config :modname:`plex_posters.config.config`
+---------------------------------------------
+
+.. automodule:: plex_posters.config.config
+   :members:
+   :undoc-members:
+   :show-inheritance:

plex-posters/docs/source/modules/plex_posters.config.rst

@@ -0,0 +1,16 @@
+.. include:: ../global.rst
+
+Config :modname:`plex_posters.config`
+-------------------------------------
+
+.. automodule:: plex_posters.config
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Submodules
+----------
+
+.. toctree::
+
+   plex_posters.config.config

plex-posters/docs/source/modules/plex_posters.lib.rst

@@ -0,0 +1,9 @@
+.. include:: ../global.rst
+
+Lib :modname:`plex_posters.lib`
+------------------------------------
+
+.. automodule:: plex_posters.lib
+   :members:
+   :undoc-members:
+   :show-inheritance:

plex-posters/docs/source/modules/plex_posters.rst

@@ -0,0 +1,17 @@
+.. include:: ../global.rst
+
+plex_posters :modname:`plex_posters`
+------------------------------------
+
+.. automodule:: plex_posters
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Subpackages
+-----------
+
+.. toctree::
+
+   plex_posters.config
+   plex_posters.lib

plex-posters/docs/source/toc.rst

@@ -0,0 +1,24 @@
+.. toctree::
+   :maxdepth: 1
+   :caption: Overview
+   :titlesonly:
+
+   introduction
+   configuration
+   changelog
+
+.. toctree::
+   :maxdepth: 4
+   :caption: Modules
+   :titlesonly:
+
+   modules/plex_posters.rst
+
+.. toctree::
+   :maxdepth: 4
+   :caption: Submodules
+   :titlesonly:
+
+   modules/plex_posters.config.config.rst
+   modules/plex_posters.lib.rst
+