diff --git a/api-ref/source/conf.py b/api-ref/source/conf.py index 94049ad..76dd88d 100755 --- a/api-ref/source/conf.py +++ b/api-ref/source/conf.py @@ -106,6 +106,7 @@ html_title = "Application Service Mesh - API Reference" # 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_static_path = ['_static'] +templates_path = ['_templates'] # Do not include sources into the rendered results html_copy_source = False @@ -122,4 +123,12 @@ latex_documents = [ repo = Repo(search_parent_directories=True) commit = repo.head.commit current_commit_hash = commit.hexsha -current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M') \ No newline at end of file +current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M') + +latex_elements = { + 'papersize': 'a4paper', + 'pointsize': '12pt', + 'figure_align': 'H', + 'preamble': r'\newcommand{\githash}{' + current_commit_hash + '}', + 'sphinxsetup': 'hmargin={15mm,15mm}, vmargin={20mm,30mm}, marginpar=10mm' +} \ No newline at end of file diff --git a/doc/best-practice/source/conf.py b/doc/best-practice/source/conf.py index b0a8141..89ab4a4 100644 --- a/doc/best-practice/source/conf.py +++ b/doc/best-practice/source/conf.py @@ -106,6 +106,7 @@ html_title = "Application Service Mesh - Best Practice" # 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_static_path = ['_static'] +templates_path = ['_templates'] # Do not include sources into the rendered results html_copy_source = False @@ -122,4 +123,12 @@ latex_documents = [ repo = Repo(search_parent_directories=True) commit = repo.head.commit current_commit_hash = commit.hexsha -current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M') \ No newline at end of file +current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M') + +latex_elements = { + 'papersize': 'a4paper', + 'pointsize': '12pt', + 'figure_align': 'H', + 'preamble': r'\newcommand{\githash}{' + current_commit_hash + '}', + 'sphinxsetup': 'hmargin={15mm,15mm}, vmargin={20mm,30mm}, marginpar=10mm' +} \ No newline at end of file diff --git a/doc/source/conf.py b/doc/source/conf.py index 71ce8c3..8f859be 100755 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -107,6 +107,7 @@ html_title = "Application Service Mesh - Service Based View" # 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_static_path = ['_static'] +templates_path = ['_templates'] # Do not include sources into the rendered results html_copy_source = False @@ -118,4 +119,12 @@ latex_documents = [] repo = Repo(search_parent_directories=True) commit = repo.head.commit current_commit_hash = commit.hexsha -current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M') \ No newline at end of file +current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M') + +latex_elements = { + 'papersize': 'a4paper', + 'pointsize': '12pt', + 'figure_align': 'H', + 'preamble': r'\newcommand{\githash}{' + current_commit_hash + '}', + 'sphinxsetup': 'hmargin={15mm,15mm}, vmargin={20mm,30mm}, marginpar=10mm' +} \ No newline at end of file diff --git a/tox.ini b/tox.ini index c766917..37b1f45 100644 --- a/tox.ini +++ b/tox.ini @@ -60,6 +60,10 @@ allowlist_externals = commands = mkdir -p doc/build/pdf {[testenv:bindeps]commands} + mkdir -p {toxinidir}/_templates + wget -O {toxinidir}/_templates/longtable.tex.jinja https://gitea.eco.tsi-dev.otc-service.com/infra/docs-templates/raw/branch/main/templates/longtable.tex.jinja + wget -O {toxinidir}/_templates/tabular.tex.jinja https://gitea.eco.tsi-dev.otc-service.com/infra/docs-templates/raw/branch/main/templates/tabular.tex.jinja + wget -O {toxinidir}/_templates/tabulary.tex.jinja https://gitea.eco.tsi-dev.otc-service.com/infra/docs-templates/raw/branch/main/templates/tabulary.tex.jinja {[testenv:umn-pdf-docs]commands} {[testenv:api-ref-pdf-docs]commands} {[testenv:best-practice-pdf-docs]commands} @@ -103,6 +107,7 @@ allowlist_externals = cp commands = rm -rf umn/build/pdf + cp -r {toxinidir}/_templates umn/source/_templates/ sphinx-build -W --keep-going -b latex umn/source umn/build/pdf/ bash -c "for f in umn/build/pdf/*.gif; do convert $f $\{f/%gif/png\}; done || true" bash -c "for f in umn/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" @@ -149,6 +154,7 @@ allowlist_externals = cp commands = rm -rf api-ref/build/pdf + cp -r {toxinidir}/_templates api-ref/source/_templates/ sphinx-build -W --keep-going -b latex api-ref/source api-ref/build/pdf/ bash -c "for f in api-ref/build/pdf/*.gif; do convert $f $\{f/%gif/png\}; done || true" bash -c "for f in api-ref/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" @@ -195,6 +201,7 @@ allowlist_externals = cp commands = rm -rf doc/best-practice/build/pdf + cp -r {toxinidir}/_templates doc/best-practice/source/_templates/ sphinx-build -W --keep-going -b latex doc/best-practice/source doc/best-practice/build/pdf/ bash -c "for f in doc/best-practice/build/pdf/*.gif; do convert $f $\{f/%gif/png\}; done || true" bash -c "for f in doc/best-practice/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" diff --git a/umn/source/conf.py b/umn/source/conf.py index 6a0f7ad..7a3fc97 100644 --- a/umn/source/conf.py +++ b/umn/source/conf.py @@ -106,6 +106,7 @@ html_title = "Application Service Mesh - User Guide" # 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_static_path = ['_static'] +templates_path = ['_templates'] # Do not include sources into the rendered results html_copy_source = False @@ -124,3 +125,10 @@ commit = repo.head.commit current_commit_hash = commit.hexsha current_commit_time = commit.committed_datetime.strftime('%Y-%m-%d %H:%M') +latex_elements = { + 'papersize': 'a4paper', + 'pointsize': '12pt', + 'figure_align': 'H', + 'preamble': r'\newcommand{\githash}{' + current_commit_hash + '}', + 'sphinxsetup': 'hmargin={15mm,15mm}, vmargin={20mm,30mm}, marginpar=10mm' +} \ No newline at end of file