From 23490694ff4980838727db0f44c1079235336570 Mon Sep 17 00:00:00 2001 From: jan Date: Mon, 5 Jul 2021 14:58:39 -0700 Subject: [PATCH] improve doc generation and fix code links --- make_docs.sh | 10 +++++++--- pdoc_templates/config.mako | 2 +- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/make_docs.sh b/make_docs.sh index a29558c..c594313 100755 --- a/make_docs.sh +++ b/make_docs.sh @@ -1,4 +1,7 @@ #!/bin/bash + +set -Eeuo pipefail + cd ~/projects/meanas # Approach 1: pdf to html? @@ -6,9 +9,10 @@ cd ~/projects/meanas # pandoc --metadata=title:"meanas" --toc --toc-depth=4 --from=markdown+abbreviations --to=html --output=doc.html --gladtex -s - # Approach 2: pdf to html with gladtex -pdoc3 --pdf --force --template-dir pdoc_templates -o doc . > doc.md -pandoc --metadata=title:"meanas" --from=markdown+abbreviations --to=html --output=doc.html --gladtex -s --css pdoc_templates/pdoc.css doc.md -gladtex -a -n -d _doc_mathimg -c white doc.html +rm -r _doc_mathimg +pdoc --pdf --force --template-dir pdoc_templates -o doc . > doc.md +pandoc --metadata=title:"meanas" --from=markdown+abbreviations --to=html --output=doc.htex --gladtex -s --css pdoc_templates/pdoc.css doc.md +gladtex -a -n -d _doc_mathimg -c white doc.htex # Approach 3: html with gladtex #pdoc3 --html --force --template-dir pdoc_templates -o doc . diff --git a/pdoc_templates/config.mako b/pdoc_templates/config.mako index 3010348..93cf716 100644 --- a/pdoc_templates/config.mako +++ b/pdoc_templates/config.mako @@ -20,7 +20,7 @@ #git_link_template = 'https://bitbucket.org/USER/PROJECT/src/{commit}/{path}#lines-{start_line}:{end_line}' #git_link_template = 'https://CGIT_HOSTNAME/PROJECT/tree/{path}?id={commit}#n{start_line}' #git_link_template = None - git_link_template = 'https://mpxd.net/code/jan/fdfd_tools/src/commit/{commit}/{path}#L{start_line}-L{end_line}' + git_link_template = 'https://mpxd.net/code/jan/meanas/src/commit/{commit}/{path}#L{start_line}-L{end_line}' # A prefix to use for every HTML hyperlink in the generated documentation. # No prefix results in all links being relative.