Merge pull request #288 from eric-wieser/docs-use-rst

Use an rst file for galgebra_guide instead of a notebook.

Author: eric-wieser

doc/Makefile

@@ -26,5 +26,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	notedown galgebra.md > galgebra_guide.ipynb
 	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

doc/README.md

@@ -12,11 +12,9 @@ The structure of the `doc` diretory is:
 │                                   #
 ├─ index.rst                        # The entry point of the Sphinx doc, it references both
 │                                   # galgebra_guide.ipynb and api.rst
-├─ galgebra.tex                     # The orignal LaTeX source that generated books/galgebra.pdf
-├─ galgebra.md                      # The Markdown source semi-auto converted from galgebra.tex
-│                                   # please edit this instead of galgebra.tex (deprecated by it)
-│                                   # or galgebra_guide.ipynb (auto generated from it)
-├─ galgebra_guide.ipynb             # The Jupyter notebook converted from galgebra.md
+├─ galgebra.tex                     # The original LaTeX source that generated books/galgebra.pdf
+├─ galgebra_guide.rst               # The convert vertion of the latex document.
+│                                   # This was converted to markdown manually, then to rST via nodedown and nbsphinx.
 ├─ api.rst                          # Use automodule to extract doc from galgebra Python source files
 │
 │                                   # Configurations: