rough draft

moshez · Mar 9, 2021 · cf0db64 · cf0db64
1 parent aa04c5f
commit cf0db64
Show file tree

Hide file tree

Showing 4 changed files with 39 additions and 0 deletions.
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,2 @@
+__pycache__
+/build
diff --git a/doc/conf.py b/doc/conf.py
@@ -0,0 +1,13 @@
+master_doc = 'index'
+project = "Moshe'z Recipes"
+copyright = '2020, Moshe Zadka'
+author = 'Moshe Zadka'
+version = release = ''
+
+import sphinx_rtd_theme
+
+extensions = [
+    "sphinx_rtd_theme",
+]
+
+html_theme = "sphinx_rtd_theme"
diff --git a/doc/index.rst b/doc/index.rst
@@ -0,0 +1,4 @@
+Picostory
+---------
+
+This is a placeholder until a story is actually written.
diff --git a/noxfile.py b/noxfile.py
@@ -0,0 +1,20 @@
+import functools
+import os
+
+import nox
+
+nox.options.envdir = "build/nox"
+
+@nox.session(python="3.8")
+def docs(session):
+    """Build the documentation."""
+    output_dir = os.path.abspath(os.path.join(session.create_tmp(), "output"))
+    doctrees, html = map(
+        functools.partial(os.path.join, output_dir), ["doctrees", "html"]
+    )
+    print(html)
+    session.run("rm", "-rf", output_dir, external=True)
+    session.install("sphinx", "sphinx-rtd-theme")
+    session.cd("doc")
+    sphinx_cmd = "sphinx-build"
+    session.run(sphinx_cmd, "-b", "html", "-W", "-d", doctrees, ".", html)