diff --git a/otc_metadata/templates/conf.py.j2 b/otc_metadata/templates/conf.py.j2 index 6b45d8e..26fffc8 100644 --- a/otc_metadata/templates/conf.py.j2 +++ b/otc_metadata/templates/conf.py.j2 @@ -127,9 +127,13 @@ html_copy_source = False # -- Options for PDF output -------------------------------------------------- latex_documents = [ -{%- if pdf_name is defined %} +{%- if doc_type %} ('index', - '{{ pdf_name }}.tex', + {%- if doc_type == 'dev' %} + '{{ service_type }}-dev-guide.tex', + {%- else %} + '{{ service_type }}-{{ doc_type }}.tex', + {% endif -%} u'{{ title }}', u'OpenTelekomCloud', 'manual'), {% endif -%} diff --git a/otc_metadata/templates/tox.ini.j2 b/otc_metadata/templates/tox.ini.j2 index cdac3b7..edfd5f1 100644 --- a/otc_metadata/templates/tox.ini.j2 +++ b/otc_metadata/templates/tox.ini.j2 @@ -13,6 +13,8 @@ commands = stestr run {posargs} stestr slowest [testenv:pep8] +allowlist_externals = + doc8 commands = doc8 doc/source README.rst @@ -26,7 +28,7 @@ commands = {posargs} [testenv:docs] deps = -r{toxinidir}/doc/requirements.txt - -c https://raw.githubusercontent.com/opentelekomcloud-docs-swiss/docs-constraints/main/constraints.txt + -c https://raw.githubusercontent.com/opentelekomcloud-docs/docs-constraints/main/constraints.txt allowlist_externals = mkdir cp @@ -42,7 +44,8 @@ commands = {[testenv:json-{{ doc.type }}]commands} {%- endfor %} -[testenv:docs-pdf] +{% if docs|length > 0 %} +[testenv:pdf-docs] deps = {[testenv:docs]deps} {[testenv:bindeps]deps} @@ -55,16 +58,18 @@ allowlist_externals = cp commands = mkdir -p doc/build/pdf + mkdir -p doc/build/html {[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 %} +{%- if doc.pdf_enabled %} {[testenv:{{ doc.type }}-pdf-docs]commands} {%- endif %} {%- endfor %} +{% endif %} {% for doc in docs -%} {% set loc = doc.rst_location | replace('/source', '') %} @@ -105,7 +110,6 @@ commands = cp -av doc/build/json/{{ doc.type }} {{ doc.type }}/build/json {%- endif %} -{% if doc.pdf_name -%} # PDF version [testenv:{{ doc.type }}-pdf-docs] deps = {[testenv:docs]deps} @@ -119,12 +123,12 @@ 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/*.gif; do convert $f[0] $\{f/%gif/png\}; done || true" bash -c "for f in {{ loc }}/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" - make -C {{ loc }}/build/pdf + make -C {{ loc }}/build/pdf LATEXMKOPTS="-interaction=nonstopmode" mkdir -p doc/build/pdf - cp {{ loc }}/build/pdf/{{ doc.pdf_name }}.pdf doc/build/pdf/ -{% endif %} + cp {{ loc }}/build/pdf/{{ service_type }}-{{ doc.type }}.pdf doc/build/pdf/ + cp {{ loc }}/build/pdf/{{ service_type }}-{{ doc.type }}.pdf doc/build/html/ {% endfor %} [testenv:bindeps] diff --git a/otc_metadata/templates/zuul.yaml.j2 b/otc_metadata/templates/zuul.yaml.j2 index 3118082..f0f6112 100644 --- a/otc_metadata/templates/zuul.yaml.j2 +++ b/otc_metadata/templates/zuul.yaml.j2 @@ -3,7 +3,14 @@ merge-mode: squash-merge default-branch: main templates: - - helpcenter-swiss-base-jobs + - helpcenter-base-jobs + vars: + sphinx_pdf_files: + {%- for doc in docs %} + {%- if doc.pdf_enabled %} + - {{ service_type }}-{{ doc.type }}.pdf + {%- endif %} + {%- endfor %} check: jobs: - noop