From 3607907428bb3c8cd569b7d3cb05480d645893d9 Mon Sep 17 00:00:00 2001 From: "halil.cakal" Date: Wed, 16 Nov 2022 13:24:44 +0000 Subject: Fix breaking API documentation generation Add extension lfdocs-conf and replace ROBOT_VENV with ROBOT3_VENV Issue-ID: CCSDK-3815 Change-Id: I565ee15bd5862cca0365d153358941b27befb94a Signed-off-by: halil.cakal --- docs/conf.py | 21 ++++++++++++++++++++- docs/requirements-docs.txt | 2 ++ 2 files changed, 22 insertions(+), 1 deletion(-) (limited to 'docs') diff --git a/docs/conf.py b/docs/conf.py index a9c42b67..ee7f207a 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -22,7 +22,9 @@ extensions = [ 'sphinxcontrib.blockdiag', 'sphinxcontrib.seqdiag', 'sphinxcontrib.swaggerdoc', - 'sphinxcontrib.plantuml' + 'sphinxcontrib.plantuml', + 'sphinxcontrib.redoc', + 'sphinx_tabs.tabs' ] # @@ -32,6 +34,23 @@ extensions = [ branch = 'latest' +redoc = [ + { + 'name': 'PMS API', + 'page': 'offeredapis/pms-api', + 'spec': './offeredapis/swagger/pms-api.json', + 'embed': True, + }, + { + 'name': 'A1 ADAPTER API', + 'page': 'offeredapis/a1-adapter-api', + 'spec': './offeredapis/swagger/a1-adapter-api.json', + 'embed': True, + } + ] + +redoc_uri = 'https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js' + intersphinx_mapping = {} doc_url = 'https://docs.onap.org/projects' master_doc = 'index' diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt index 71df2ab0..009b997a 100644 --- a/docs/requirements-docs.txt +++ b/docs/requirements-docs.txt @@ -1,3 +1,4 @@ +lfdocs-conf sphinx>=4.2.0 # BSD sphinx-rtd-theme>=1.0.0 # MIT sphinxcontrib-blockdiag # BSD @@ -5,3 +6,4 @@ sphinxcontrib-seqdiag # BSD sphinxcontrib-swaggerdoc sphinxcontrib-spelling sphinxcontrib-plantuml +sphinxcontrib-redoc -- cgit 1.2.3-korg