diff --git a/tox.ini b/tox.ini index d0256f8..cb41d2c 100644 --- a/tox.ini +++ b/tox.ini @@ -44,6 +44,7 @@ commands = {[testenv:umn]commands} {[testenv:json-umn]commands} + [testenv:pdf-docs] deps = {[testenv:docs]deps} @@ -57,11 +58,16 @@ 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 + {[testenv:api-ref-pdf-docs]commands} + {[testenv:umn-pdf-docs]commands} + + # HTML version [testenv:api-ref] @@ -90,6 +96,26 @@ commands = mkdir -p api-ref/build/json cp -av doc/build/json/api-ref api-ref/build/json +# PDF version +[testenv:api-ref-pdf-docs] +deps = {[testenv:docs]deps} +allowlist_externals = + rm + mkdir + make + bash + 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[0] $\{f/%gif/png\}; done || true" + bash -c "for f in api-ref/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" + make -C api-ref/build/pdf LATEXMKOPTS="-interaction=nonstopmode" + mkdir -p doc/build/pdf + cp api-ref/build/pdf/rfs-api-ref.pdf doc/build/pdf/ + cp api-ref/build/pdf/rfs-api-ref.pdf doc/build/html/ + # HTML version [testenv:umn] deps = {[testenv:docs]deps} @@ -117,6 +143,26 @@ commands = mkdir -p umn/build/json cp -av doc/build/json/umn umn/build/json +# PDF version +[testenv:umn-pdf-docs] +deps = {[testenv:docs]deps} +allowlist_externals = + rm + mkdir + make + bash + 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[0] $\{f/%gif/png\}; done || true" + bash -c "for f in umn/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" + make -C umn/build/pdf LATEXMKOPTS="-interaction=nonstopmode" + mkdir -p doc/build/pdf + cp umn/build/pdf/rfs-umn.pdf doc/build/pdf/ + cp umn/build/pdf/rfs-umn.pdf doc/build/html/ + [testenv:bindeps] deps = @@ -135,4 +181,4 @@ commands = [doc8] ignore = D001 -extensions = .rst, .yaml +extensions = .rst, .yaml \ No newline at end of file diff --git a/zuul.yaml b/zuul.yaml index 2a71c76..06e4121 100644 --- a/zuul.yaml +++ b/zuul.yaml @@ -6,9 +6,11 @@ - helpcenter-base-jobs vars: sphinx_pdf_files: + - rfs-api-ref.pdf + - rfs-umn.pdf check: jobs: - noop gate: jobs: - - noop + - noop \ No newline at end of file