From c5d660ffe9cf9bfab29a9583a85671cba378aa33 Mon Sep 17 00:00:00 2001 From: Sebastian Gode Date: Mon, 6 Nov 2023 14:02:55 +0000 Subject: [PATCH] Update tox.ini && conf.py file Performed-by: gitea/infra/otc-metadata/tools/generate_doc_confpy.py --- doc/requirements.txt | 3 + doc/source/conf.py | 11 +++ tox.ini | 160 ++++++++++++++++++++++++++++++------------- 3 files changed, 125 insertions(+), 49 deletions(-) diff --git a/doc/requirements.txt b/doc/requirements.txt index ea0c4de..c022286 100644 --- a/doc/requirements.txt +++ b/doc/requirements.txt @@ -1,7 +1,10 @@ sphinx>=2.0.0,!=2.1.0 # BSD + otcdocstheme # Apache-2.0 + # releasenotes reno>=3.1.0 # Apache-2.0 otc-sphinx-directives>=0.1.0 +sphinx-minify>=0.0.1 # Apache-2.0 git+https://gitea.eco.tsi-dev.otc-service.com/infra/otc-metadata.git#egg=otc_metadata \ No newline at end of file diff --git a/doc/source/conf.py b/doc/source/conf.py index d37aac2..bd1bbf7 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -31,6 +31,17 @@ otcdocs_repo_name = 'docs/mapreduce-service' otcdocs_git_fqdn = 'gitea.eco.tsi-dev.otc-service.com' otcdocs_git_type = 'gitea' +# Those variables are needed for indexing into OpenSearch +otcdocs_doc_environment = '' +otcdocs_doc_link = '' +otcdocs_doc_title = '' +otcdocs_doc_type = '' +otcdocs_service_category = 'big_data' +otcdocs_service_title = 'MapReduce Service' +otcdocs_service_type = 'mrs' +otcdocs_search_environment = 'hc_de' +otcdocs_search_url = "https://opensearch.eco.tsi-dev.otc-service.com/" + # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the # documentation root, use os.path.abspath to make it absolute, like shown here. diff --git a/tox.ini b/tox.ini index a29aef6..86ddbda 100644 --- a/tox.ini +++ b/tox.ini @@ -34,16 +34,19 @@ allowlist_externals = rm sphinx-build commands = - rm -rf doc/build/html doc/build/doctrees - sphinx-build -a -E -W -d doc/build/doctrees -b html doc/source doc/build/html + rm -rf doc/build/html doc/build/html_temp doc/build/doctrees + sphinx-build -a -E -W -d doc/build/doctrees -b html doc/source doc/build/html_temp + sphinx-minify --input-directory doc/build/html_temp/ --output-directory doc/build/html {[testenv:operation-guide-lts]commands} {[testenv:json-operation-guide-lts]commands} {[testenv:umn]commands} {[testenv:json-umn]commands} - {[testenv:operation-guide]commands} - {[testenv:json-operation-guide]commands} {[testenv:api-ref]commands} {[testenv:json-api-ref]commands} + {[testenv:operation-guide]commands} + {[testenv:json-operation-guide]commands} + {[testenv:best-practice]commands} + {[testenv:json-best-practice]commands} [testenv:docs-pdf] deps = {[testenv:docs]deps} @@ -57,8 +60,9 @@ commands = mkdir -p doc/build/pdf {[testenv:operation-guide-lts-pdf-docs]commands} {[testenv:umn-pdf-docs]commands} - {[testenv:operation-guide-pdf-docs]commands} {[testenv:api-ref-pdf-docs]commands} + {[testenv:operation-guide-pdf-docs]commands} + {[testenv:best-practice-pdf-docs]commands} # HTML version @@ -68,7 +72,10 @@ allowlist_externals = cp mkdir commands = - sphinx-build -W --keep-going -b html doc/component-operation-guide-lts/source doc/build/html/operation-guide-lts + sphinx-build -W --keep-going -b html doc/component-operation-guide-lts/source doc/build/html_temp/operation-guide-lts + sphinx-minify --input-directory doc/build/html_temp/operation-guide-lts --output-directory doc/build/html/operation-guide-lts + mkdir -p operation-guide-lts/build/html + cp -av doc/build/html/operation-guide-lts operation-guide-lts/build/html # Json version (for search) [testenv:json-operation-guide-lts] @@ -82,6 +89,8 @@ commands = # Drop data useless for the search - wrap it also with sh/xargs due to bugs # in tox sh -c "find doc/build/json -type d -and '(' -name '_images' -or -name '_static' -or -name '_sources' ')' -print0 | xargs -0 rm -rf" + mkdir -p operation-guide-lts/build/json + cp -av doc/build/json/operation-guide-lts operation-guide-lts/build/json # PDF version [testenv:operation-guide-lts-pdf-docs] @@ -109,7 +118,8 @@ allowlist_externals = cp mkdir commands = - sphinx-build -W --keep-going -b html umn/source doc/build/html/umn + sphinx-build -W --keep-going -b html umn/source doc/build/html_temp/umn + sphinx-minify --input-directory doc/build/html_temp/umn --output-directory doc/build/html/umn mkdir -p umn/build/html cp -av doc/build/html/umn umn/build/html @@ -147,47 +157,6 @@ commands = cp umn/build/pdf/mrs-umn.pdf doc/build/pdf/ -# HTML version -[testenv:operation-guide] -deps = {[testenv:docs]deps} -allowlist_externals = - cp - mkdir -commands = - sphinx-build -W --keep-going -b html doc/component-operation-guide/source doc/build/html/operation-guide - -# Json version (for search) -[testenv:json-operation-guide] -deps = {[testenv:docs]deps} -allowlist_externals = - cp - mkdir - sh -commands = - sphinx-build -W --keep-going -b json doc/component-operation-guide/source doc/build/json/operation-guide - # Drop data useless for the search - wrap it also with sh/xargs due to bugs - # in tox - sh -c "find doc/build/json -type d -and '(' -name '_images' -or -name '_static' -or -name '_sources' ')' -print0 | xargs -0 rm -rf" - -# PDF version -[testenv:operation-guide-pdf-docs] -deps = {[testenv:docs]deps} -allowlist_externals = - rm - mkdir - make - bash - cp -commands = - rm -rf doc/component-operation-guide/build/pdf - sphinx-build -W --keep-going -b latex doc/component-operation-guide/source doc/component-operation-guide/build/pdf/ - bash -c "for f in doc/component-operation-guide/build/pdf/*.gif; do convert $f $\{f/%gif/png\}; done || true" - bash -c "for f in doc/component-operation-guide/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" - make -C doc/component-operation-guide/build/pdf - mkdir -p doc/build/pdf - cp doc/component-operation-guide/build/pdf/mrs-component-operation-guide.pdf doc/build/pdf/ - - # HTML version [testenv:api-ref] deps = {[testenv:docs]deps} @@ -195,7 +164,8 @@ allowlist_externals = cp mkdir commands = - sphinx-build -W --keep-going -b html api-ref/source doc/build/html/api-ref + sphinx-build -W --keep-going -b html api-ref/source doc/build/html_temp/api-ref + sphinx-minify --input-directory doc/build/html_temp/api-ref --output-directory doc/build/html/api-ref mkdir -p api-ref/build/html cp -av doc/build/html/api-ref api-ref/build/html @@ -233,6 +203,98 @@ commands = cp api-ref/build/pdf/mrs-api-ref.pdf doc/build/pdf/ +# HTML version +[testenv:operation-guide] +deps = {[testenv:docs]deps} +allowlist_externals = + cp + mkdir +commands = + sphinx-build -W --keep-going -b html doc/component-operation-guide/source doc/build/html_temp/operation-guide + sphinx-minify --input-directory doc/build/html_temp/operation-guide --output-directory doc/build/html/operation-guide + mkdir -p operation-guide/build/html + cp -av doc/build/html/operation-guide operation-guide/build/html + +# Json version (for search) +[testenv:json-operation-guide] +deps = {[testenv:docs]deps} +allowlist_externals = + cp + mkdir + sh +commands = + sphinx-build -W --keep-going -b json doc/component-operation-guide/source doc/build/json/operation-guide + # Drop data useless for the search - wrap it also with sh/xargs due to bugs + # in tox + sh -c "find doc/build/json -type d -and '(' -name '_images' -or -name '_static' -or -name '_sources' ')' -print0 | xargs -0 rm -rf" + mkdir -p operation-guide/build/json + cp -av doc/build/json/operation-guide operation-guide/build/json + +# PDF version +[testenv:operation-guide-pdf-docs] +deps = {[testenv:docs]deps} +allowlist_externals = + rm + mkdir + make + bash + cp +commands = + rm -rf doc/component-operation-guide/build/pdf + sphinx-build -W --keep-going -b latex doc/component-operation-guide/source doc/component-operation-guide/build/pdf/ + bash -c "for f in doc/component-operation-guide/build/pdf/*.gif; do convert $f $\{f/%gif/png\}; done || true" + bash -c "for f in doc/component-operation-guide/build/pdf/*.tex; do sed -iorig 's/\.gif//g' $f; done" + make -C doc/component-operation-guide/build/pdf + mkdir -p doc/build/pdf + cp doc/component-operation-guide/build/pdf/mrs-component-operation-guide.pdf doc/build/pdf/ + + +# HTML version +[testenv:best-practice] +deps = {[testenv:docs]deps} +allowlist_externals = + cp + mkdir +commands = + sphinx-build -W --keep-going -b html doc/best-practice/source doc/build/html_temp/best-practice + sphinx-minify --input-directory doc/build/html_temp/best-practice --output-directory doc/build/html/best-practice + mkdir -p best-practice/build/html + cp -av doc/build/html/best-practice best-practice/build/html + +# Json version (for search) +[testenv:json-best-practice] +deps = {[testenv:docs]deps} +allowlist_externals = + cp + mkdir + sh +commands = + sphinx-build -W --keep-going -b json doc/best-practice/source doc/build/json/best-practice + # Drop data useless for the search - wrap it also with sh/xargs due to bugs + # in tox + sh -c "find doc/build/json -type d -and '(' -name '_images' -or -name '_static' -or -name '_sources' ')' -print0 | xargs -0 rm -rf" + mkdir -p best-practice/build/json + cp -av doc/build/json/best-practice best-practice/build/json + +# PDF version +[testenv:best-practice-pdf-docs] +deps = {[testenv:docs]deps} +allowlist_externals = + rm + mkdir + make + bash + cp +commands = + rm -rf doc/best-practice/build/pdf + 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" + make -C doc/best-practice/build/pdf + mkdir -p doc/build/pdf + cp doc/best-practice/build/pdf/mrs-best-practice.pdf doc/build/pdf/ + + [doc8] ignore = D001