diff options
-rw-r--r-- | share/templater/sphinx/files/Makefile.sphinx | 6 | ||||
-rw-r--r-- | share/templater/sphinx/files/conf.py | 14 |
2 files changed, 19 insertions, 1 deletions
diff --git a/share/templater/sphinx/files/Makefile.sphinx b/share/templater/sphinx/files/Makefile.sphinx index 6f8ddaa..3369b20 100644 --- a/share/templater/sphinx/files/Makefile.sphinx +++ b/share/templater/sphinx/files/Makefile.sphinx @@ -94,6 +94,8 @@ epub: $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub @echo @echo "Build finished. The epub file is in $(BUILDDIR)/epub." + @cp $(BUILDDIR)/epub/*epub _static/ + @echo "A copy was made to _static/." latex: $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex @@ -107,6 +109,8 @@ latexpdf: @echo "Running LaTeX files through pdflatex..." $(MAKE) -C $(BUILDDIR)/latex all-pdf @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." + @cp $(BUILDDIR)/latex/*pdf _static/ + @echo "A copy was made to _static/." text: $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text @@ -152,7 +156,7 @@ doctest: @echo "Testing of doctests in the sources finished, look at the " \ "results in $(BUILDDIR)/doctest/output.txt." -web: clean html +web: clean epub latexpdf html web_deploy: @rsync -avz --delete _build/html/ templates:/var/sites/templates/www/ diff --git a/share/templater/sphinx/files/conf.py b/share/templater/sphinx/files/conf.py index a605478..a8aa2d8 100644 --- a/share/templater/sphinx/files/conf.py +++ b/share/templater/sphinx/files/conf.py @@ -12,6 +12,8 @@ # serve to show the default. import sys, os +import recommonmark +from recommonmark.transform import AutoStructify # 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 @@ -291,3 +293,15 @@ epub_copyright = u'2016, Templates' # Allow duplicate toc entries. #epub_tocdup = True + +# See http://recommonmark.readthedocs.io +#github_doc_root = 'https://github.com/rtfd/recommonmark/tree/master/doc/' +def setup(app): + app.add_config_value('recommonmark_config', { + #'url_resolver': lambda url: github_doc_root + url, + 'auto_toc_tree_section': 'Index', + 'enable_auto_toc_tree' : True, + 'enable_auto_doc_ref' : True, + 'enable_eval_rst' : True, + }, True) + app.add_transform(AutoStructify) |