Switch to PDF enabled

Reviewed-by: tischrei <tino.schreiber@t-systems.com>
Co-authored-by: Sebastian Gode <sebastian.gode@telekom.de>
Co-committed-by: Sebastian Gode <sebastian.gode@telekom.de>

otc_metadata/data/documents/dbss-api-ref.yaml

@@ -0,0 +1,9 @@
+---
+hc_location: api/dbss
+html_location: docs/dbss/api-ref
+link: /database-security-service/api-ref/
+pdf_name: dbss-api-ref
+rst_location: api-ref/source
+service_type: dbss
+title: API Reference
+type: api-ref

otc_metadata/data/documents/pc-api-ref.yaml

@@ -1,5 +1,4 @@
 ---
-environment: internal
 link: /price-calculator/api-ref/
 pdf_name: pc-api-ref
 rst_location: api-ref/source

otc_metadata/data/documents/rms-api-ref.yaml

@@ -1,9 +0,0 @@
----
-hc_location: api/rms
-html_location: docs/rms/api-ref
-link: /resource-management-service/api-ref/
-pdf_name: rms-api-ref
-rst_location: api-ref/source
-service_type: rms
-title: API Reference
-type: api-ref

otc_metadata/data/documents/rms-umn.yaml

@@ -1,9 +0,0 @@
----
-hc_location: usermanual/rms
-html_location: docs/rms/umn
-link: /resource-management-service/umn/
-pdf_name: rms-umn
-rst_location: umn/source
-service_type: rms
-title: User Guide
-type: umn

otc_metadata/data/services/aom.yaml

@@ -12,5 +12,5 @@ service_title: Application Operations Management
 service_type: aom
 service_uri: application-operations-management
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/aom2.yaml

@@ -12,5 +12,5 @@ service_title: Application Operations Management 2.0
 service_type: aom2
 service_uri: application-operations-management-2
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/apig.yaml

@@ -12,5 +12,5 @@ service_title: API Gateway (APIG)
 service_type: apig
 service_uri: api-gateway
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/apm.yaml

@@ -7,10 +7,10 @@ repositories:
 - environment: public
   repo: opentelekomcloud-docs/application-performance-management
   type: github
-service_category: md
+service_category: application
 service_title: Application Performance Management
 service_type: apm
 service_uri: application-performance-management
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/ces.yaml

@@ -12,5 +12,5 @@ service_title: Cloud Eye
 service_type: ces
 service_uri: cloud-eye
 teams:
-- name: docs-orchestration-rw
+- name: docs-cms-rw
   permission: write

otc_metadata/data/services/config.yaml

@@ -12,5 +12,5 @@ service_title: Config
 service_type: config
 service_uri: config
 teams:
-- name: docs-orchestration-rw
+- name: docs-cms-rw
   permission: write

otc_metadata/data/services/cse.yaml

@@ -12,5 +12,5 @@ service_title: Cloud Service Engine
 service_type: cse
 service_uri: cloud-service-engine
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/cts.yaml

@@ -12,5 +12,5 @@ service_title: Cloud Trace Service
 service_type: cts
 service_uri: cloud-trace-service
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/dcs.yaml

@@ -12,5 +12,5 @@ service_title: Distributed Cache Service
 service_type: dcs
 service_uri: distributed-cache-service
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/dms.yaml

@@ -12,5 +12,5 @@ service_title: Distributed Message Service
 service_type: dms
 service_uri: distributed-message-service
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/ed.yaml

@@ -1,9 +1,6 @@
 ---
 environment: public
 repositories:
-- environment: internal
-  repo: docs/enterprise-dashboard
-  type: gitea
 - environment: public
   repo: opentelekomcloud-docs/enterprise-dashboard
   type: github

otc_metadata/data/services/fg.yaml

@@ -12,5 +12,5 @@ service_title: FunctionGraph
 service_type: fg
 service_uri: function-graph
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/lts.yaml

@@ -12,5 +12,5 @@ service_title: Log Tank Service
 service_type: lts
 service_uri: log-tank-service
 teams:
-- name: docs-orchestration-rw
+- name: docs-paas-rw
   permission: write

otc_metadata/data/services/pc.yaml

@@ -1,5 +1,5 @@
 ---
-environment: hidden
+environment: public
 repositories:
 - environment: internal
   repo: docs/price-calculator

otc_metadata/data/services/rfs.yaml

@@ -12,5 +12,5 @@ service_title: Resource Formation Service
 service_type: rfs
 service_uri: resource-formation-service
 teams:
-- name: docs-orchestration-rw
+- name: docs-cms-rw
   permission: write

otc_metadata/data/services/rms.yaml

@@ -1,16 +0,0 @@
----
-environment: public
-repositories:
-- environment: internal
-  repo: docs/resource-management-service
-  type: gitea
-- environment: public
-  repo: opentelekomcloud-docs/resource-management-service
-  type: github
-service_category: md
-service_title: Resource Management Service
-service_type: rms
-service_uri: resource-management-service
-teams:
-- name: docs-orchestration-rw
-  permission: write

otc_metadata/data/services/smn.yaml

@@ -12,5 +12,5 @@ service_title: Simple Message Notification
 service_type: smn
 service_uri: simple-message-notification
 teams:
-- name: docs-orchestration-rw
+- name: docs-cms-rw
   permission: write

otc_metadata/data/services/tms.yaml

@@ -12,5 +12,5 @@ service_title: Tag Management Service
 service_type: tms
 service_uri: tag-management-service
 teams:
-- name: docs-orchestration-rw
+- name: docs-cms-rw
   permission: write

otc_metadata/templates/conf.py.j2

@@ -144,6 +144,11 @@ latex_elements = {
   'papersize': 'a4paper',
   'pointsize': '12pt',
   'figure_align': 'H',
-  'preamble': r'\newcommand{\githash}{' + current_commit_hash + '}',
+  'preamble': rf'''{% raw %}
+        \newcommand{{\githash}}{{{current_commit_hash}}}
+        \newcommand{{\gitcommittime}}{{{current_commit_time}}}
+        \newcommand{{\doctitle}}{{{otcdocs_doc_title}}}
+        \newcommand{{\servicetitle}}{{{otcdocs_service_title}}}{% endraw %}
+  ''',
   'sphinxsetup': 'hmargin={15mm,15mm}, vmargin={20mm,30mm}, marginpar=10mm'
 }

otc_metadata/templates/tox.ini.j2

@@ -44,7 +44,7 @@ commands =
   {[testenv:json-{{ doc.type }}]commands}
 {%- endfor %}
 
-[testenv:docs-pdf]
+[testenv:pdf-docs]
 deps =
   {[testenv:docs]deps}
   {[testenv:bindeps]deps}

otc_metadata/templates/zuul.yaml.j2

@@ -4,6 +4,13 @@
     default-branch: main
     templates:
       - 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

tools/generate_doc_confpy.py

@@ -299,6 +299,12 @@ def process_repositories(args, service):
 
     if args.update_zuul:
         """Update zuul.yaml"""
+        context = dict(docs=[])
+        for doc in service_docs:
+            if doc["type"] == "dev":
+                doc["type"] = "dev-guide"
+            context["docs"].append(doc)
+        context["service_type"] = service['service_type']
 
         zuul_yaml_content = zuul_yaml_template.render(**context)
         zuul_yaml_path = pathlib.Path(copy_to, "zuul.yaml")