From efe84fbb5e8baadd8ffd315d0a6d5de9801bf740 Mon Sep 17 00:00:00 2001 From: Sebastian Gode Date: Wed, 9 Oct 2024 07:56:36 +0000 Subject: [PATCH] Preparations for PDF rollout --- otc_metadata/templates/conf.py.j2 | 9 +++++++++ otc_metadata/templates/tox.ini.j2 | 6 +++++- 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/otc_metadata/templates/conf.py.j2 b/otc_metadata/templates/conf.py.j2 index aea8e3be..757643f9 100644 --- a/otc_metadata/templates/conf.py.j2 +++ b/otc_metadata/templates/conf.py.j2 @@ -119,6 +119,7 @@ html_title = "{{ title }}" # 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 @@ -138,3 +139,11 @@ 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') + +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' +} diff --git a/otc_metadata/templates/tox.ini.j2 b/otc_metadata/templates/tox.ini.j2 index 8be94f0e..7cabef17 100644 --- a/otc_metadata/templates/tox.ini.j2 +++ b/otc_metadata/templates/tox.ini.j2 @@ -28,7 +28,6 @@ commands = {posargs} [testenv:docs] deps = -r{toxinidir}/doc/requirements.txt - -c https://raw.githubusercontent.com/opentelekomcloud-docs/docs-constraints/main/constraints.txt allowlist_externals = mkdir cp @@ -58,6 +57,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 {%- for doc in docs %} {%- if doc.pdf_name %} {[testenv:{{ doc.type }}-pdf-docs]commands} @@ -115,6 +118,7 @@ allowlist_externals = cp commands = rm -rf {{ loc }}/build/pdf + cp -r {toxinidir}/_templates {{ loc }}/source/_templates/ sphinx-build -W --keep-going -b latex {{ loc }}/source {{ loc }}/build/pdf/ bash -c "for f in {{ loc }}/build/pdf/*.gif; do convert $f $\{f/%gif/png\}; done || true" bash -c "for f in {{ loc }}/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done"