Compare commits
1 Commits
minify-tem
...
various_fi
Author | SHA1 | Date | |
---|---|---|---|
d3e03e87fe |
@ -46,7 +46,6 @@ otcdocs_service_category = '{{ service_category }}'
|
|||||||
otcdocs_service_title = '{{ service_title }}'
|
otcdocs_service_title = '{{ service_title }}'
|
||||||
otcdocs_service_type = '{{ service_type }}'
|
otcdocs_service_type = '{{ service_type }}'
|
||||||
otcdocs_search_environment = 'hc_swiss'
|
otcdocs_search_environment = 'hc_swiss'
|
||||||
otcdocs_search_index = 'search_index_swiss'
|
|
||||||
otcdocs_search_url = "https://opensearch.eco.tsi-dev.otc-service.com/"
|
otcdocs_search_url = "https://opensearch.eco.tsi-dev.otc-service.com/"
|
||||||
|
|
||||||
# If extensions (or modules to document with autodoc) are in another directory,
|
# If extensions (or modules to document with autodoc) are in another directory,
|
||||||
|
@ -4,5 +4,4 @@ otcdocstheme # Apache-2.0
|
|||||||
reno>=3.1.0 # Apache-2.0
|
reno>=3.1.0 # Apache-2.0
|
||||||
|
|
||||||
otc-sphinx-directives>=0.1.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-swiss.git#egg=otc_metadata
|
git+https://gitea.eco.tsi-dev.otc-service.com/infra/otc-metadata-swiss.git#egg=otc_metadata
|
||||||
|
@ -34,9 +34,8 @@ allowlist_externals =
|
|||||||
rm
|
rm
|
||||||
sphinx-build
|
sphinx-build
|
||||||
commands =
|
commands =
|
||||||
rm -rf doc/build/html doc/build/html_temp doc/build/doctrees
|
rm -rf doc/build/html doc/build/doctrees
|
||||||
sphinx-build -a -E -W -d doc/build/doctrees -b html doc/source doc/build/html_temp
|
sphinx-build -a -E -W -d doc/build/doctrees -b html doc/source doc/build/html
|
||||||
sphinx-minify --input-directory doc/build/html_temp/ --output-directory doc/build/html
|
|
||||||
{%- for doc in docs %}
|
{%- for doc in docs %}
|
||||||
{[testenv:{{ doc.type }}]commands}
|
{[testenv:{{ doc.type }}]commands}
|
||||||
{[testenv:json-{{ doc.type }}]commands}
|
{[testenv:json-{{ doc.type }}]commands}
|
||||||
@ -67,14 +66,16 @@ allowlist_externals =
|
|||||||
cp
|
cp
|
||||||
mkdir
|
mkdir
|
||||||
commands =
|
commands =
|
||||||
sphinx-build -W --keep-going -b html {{ loc }}/source doc/build/html_temp/{{ doc.type }}
|
sphinx-build -W --keep-going -b html {{ loc }}/source doc/build/html/{{ doc.type }}
|
||||||
sphinx-minify --input-directory doc/build/html_temp/{{ doc.type }} --output-directory doc/build/html/{{ doc.type }}
|
{%- if doc.type == 'api-ref' %}
|
||||||
{%- if doc.type == 'dev-guide' %}
|
mkdir -p api-ref/build/html
|
||||||
|
cp -av doc/build/html/api-ref api-ref/build/html
|
||||||
|
{%- elif doc.type == 'umn' %}
|
||||||
|
mkdir -p umn/build/html
|
||||||
|
cp -av doc/build/html/umn umn/build/html
|
||||||
|
{%- elif doc.type == 'dev-guide' %}
|
||||||
mkdir -p dev_guide/build/html
|
mkdir -p dev_guide/build/html
|
||||||
cp -av doc/build/html/dev-guide dev_guide/build/html
|
cp -av doc/build/html/dev-guide dev_guide/build/html
|
||||||
{%- else %}
|
|
||||||
mkdir -p {{ doc.type }}/build/html
|
|
||||||
cp -av doc/build/html/{{ doc.type }} {{ doc.type }}/build/html
|
|
||||||
{%- endif %}
|
{%- endif %}
|
||||||
|
|
||||||
# Json version (for search)
|
# Json version (for search)
|
||||||
@ -89,12 +90,15 @@ commands =
|
|||||||
# Drop data useless for the search - wrap it also with sh/xargs due to bugs
|
# Drop data useless for the search - wrap it also with sh/xargs due to bugs
|
||||||
# in tox
|
# in tox
|
||||||
sh -c "find doc/build/json -type d -and '(' -name '_images' -or -name '_static' -or -name '_sources' ')' -print0 | xargs -0 rm -rf"
|
sh -c "find doc/build/json -type d -and '(' -name '_images' -or -name '_static' -or -name '_sources' ')' -print0 | xargs -0 rm -rf"
|
||||||
{%- if doc.type == 'dev-guide' %}
|
{%- if doc.type == 'api-ref' %}
|
||||||
|
mkdir -p api-ref/build/json
|
||||||
|
cp -av doc/build/json/api-ref api-ref/build/json
|
||||||
|
{%- elif doc.type == 'umn' %}
|
||||||
|
mkdir -p umn/build/json
|
||||||
|
cp -av doc/build/json/umn umn/build/json
|
||||||
|
{%- elif doc.type == 'dev-guide' %}
|
||||||
mkdir -p dev_guide/build/json
|
mkdir -p dev_guide/build/json
|
||||||
cp -av doc/build/json/dev-guide dev_guide/build/json
|
cp -av doc/build/json/dev-guide dev_guide/build/json
|
||||||
{%- else %}
|
|
||||||
mkdir -p {{ doc.type }}/build/json
|
|
||||||
cp -av doc/build/json/{{ doc.type }} {{ doc.type }}/build/json
|
|
||||||
{%- endif %}
|
{%- endif %}
|
||||||
|
|
||||||
{% if doc.pdf_name -%}
|
{% if doc.pdf_name -%}
|
||||||
|
@ -148,30 +148,8 @@ def process_repositories(args, service):
|
|||||||
context["html_options"] = dict(
|
context["html_options"] = dict(
|
||||||
disable_search=True,
|
disable_search=True,
|
||||||
site_name="Internal Documentation Portal",
|
site_name="Internal Documentation Portal",
|
||||||
logo_url="https://docs-int.sc.otc.t-systems.com",
|
logo_url="https://docs-int.otc-service.com",
|
||||||
)
|
)
|
||||||
else:
|
|
||||||
context["html_options"] = dict(
|
|
||||||
site_name="Swiss Open Telekom Cloud Docs",
|
|
||||||
logo_url="https://docs-beta.sc.otc.t-systems.com",
|
|
||||||
)
|
|
||||||
context["doc_environment"] = args.target_environment
|
|
||||||
if doc['link']:
|
|
||||||
context["doc_link"] = doc['link']
|
|
||||||
else:
|
|
||||||
context["doc_link"] = (
|
|
||||||
'/'
|
|
||||||
+ service['service_uri']
|
|
||||||
+ '/'
|
|
||||||
+ doc['type']
|
|
||||||
+ '/'
|
|
||||||
)
|
|
||||||
context["doc_title"] = doc['title']
|
|
||||||
context["doc_type"] = doc['type']
|
|
||||||
context["service_category"] = service['service_category']
|
|
||||||
context["service_title"] = service['service_title']
|
|
||||||
context["service_type"] = service['service_type']
|
|
||||||
|
|
||||||
conf_py_content = conf_py_template.render(**context)
|
conf_py_content = conf_py_template.render(**context)
|
||||||
with open(conf_py_path, "w", encoding="utf-8", newline="") as out:
|
with open(conf_py_path, "w", encoding="utf-8", newline="") as out:
|
||||||
logging.debug(f"Generating {conf_py_path} from template...")
|
logging.debug(f"Generating {conf_py_path} from template...")
|
||||||
@ -189,8 +167,6 @@ def process_repositories(args, service):
|
|||||||
title=f"{service['service_title']} - Service Based View",
|
title=f"{service['service_title']} - Service Based View",
|
||||||
service_type=service["service_type"]
|
service_type=service["service_type"]
|
||||||
)
|
)
|
||||||
context["service_category"] = service['service_category']
|
|
||||||
context["service_title"] = service['service_title']
|
|
||||||
if not copy_path.exists():
|
if not copy_path.exists():
|
||||||
logging.info("Path for sbv does not exist")
|
logging.info("Path for sbv does not exist")
|
||||||
copy_path.mkdir(parents=True, exist_ok=True)
|
copy_path.mkdir(parents=True, exist_ok=True)
|
||||||
@ -203,12 +179,7 @@ def process_repositories(args, service):
|
|||||||
context["html_options"] = dict(
|
context["html_options"] = dict(
|
||||||
disable_search=True,
|
disable_search=True,
|
||||||
site_name="Internal Documentation Portal",
|
site_name="Internal Documentation Portal",
|
||||||
logo_url="https://docs-int.sc.otc.t-systems.com",
|
logo_url="https://docs-int.otc-service.com",
|
||||||
)
|
|
||||||
else:
|
|
||||||
context["html_options"] = dict(
|
|
||||||
site_name="Swiss Open Telekom Cloud Docs",
|
|
||||||
logo_url="https://docs-beta.sc.otc.t-systems.com",
|
|
||||||
)
|
)
|
||||||
sbv_title = (service["service_title"] + "\n"
|
sbv_title = (service["service_title"] + "\n"
|
||||||
+ ('=' * len(service["service_title"])))
|
+ ('=' * len(service["service_title"])))
|
||||||
@ -277,7 +248,7 @@ def process_repositories(args, service):
|
|||||||
args.commit_description
|
args.commit_description
|
||||||
)
|
)
|
||||||
push_args = ["--set-upstream", "origin", branch_name]
|
push_args = ["--set-upstream", "origin", branch_name]
|
||||||
if args.force_push:
|
if args.branch_force:
|
||||||
push_args.append("--force")
|
push_args.append("--force")
|
||||||
repo_to.git.push(*push_args)
|
repo_to.git.push(*push_args)
|
||||||
if "github" in url_to:
|
if "github" in url_to:
|
||||||
@ -357,11 +328,6 @@ def main():
|
|||||||
help=("Whether to overwrite index.rst for service-based-view."
|
help=("Whether to overwrite index.rst for service-based-view."
|
||||||
+ "\nCan only be used if --update-sbv is also specified")
|
+ "\nCan only be used if --update-sbv is also specified")
|
||||||
)
|
)
|
||||||
parser.add_argument(
|
|
||||||
"--force-push",
|
|
||||||
action="store_true",
|
|
||||||
help="Whether to force push the commit"
|
|
||||||
)
|
|
||||||
parser.add_argument(
|
parser.add_argument(
|
||||||
"--commit-description",
|
"--commit-description",
|
||||||
default=(
|
default=(
|
||||||
|
Reference in New Issue
Block a user