RTD: Improve branchname parameterisation in docs build script 26/15426/2
authorJohnKeeney <john.keeney@est.tech>
Wed, 17 Dec 2025 12:13:32 +0000 (12:13 +0000)
committerJohn Keeney <john.keeney@est.tech>
Wed, 17 Dec 2025 12:25:06 +0000 (12:25 +0000)
Issue-ID: NONRTRIC-1095
Change-Id: I552930aa8b5470bb23be4b747e9e74b7518d6a1f
Signed-off-by: JohnKeeney <john.keeney@est.tech>
docs/conf.py

index 6b633c6..a7f0db0 100755 (executable)
@@ -18,9 +18,13 @@ from docs_conf.conf import *
 
 #branch configuration
 
-branch = 'latest'
+selfbranch = 'latest'
+participantsbranch = 'latest'  #sometimes this may be different from self.branch, e.g. on first build, it may not exist yet, so linkcheck will fail
+nonrtricbranch = 'latest' #sometimes this may be different from self.branch, e.g. on first build, it may not exist yet, so linkcheck will fail
 baseurl = 'https://docs.o-ran-sc.org/projects/'
-selfurl = '%s/o-ran-sc-nonrtric-plt-rappmanager/en/%s' %(baseurl, branch)
+selfurl = '%s/o-ran-sc-nonrtric-plt-rappmanager/en/%s' %(baseurl, selfbranch)
+participantsurl = '%s/o-ran-sc-nonrtric-plt-rappmanager/en/%s/participants' %(baseurl, participantsbranch)
+nonrtricurl = '%s/o-ran-sc-nonrtric/en/%s' %(baseurl, nonrtricbranch)
 
 linkcheck_ignore = [
     'http://localhost.*',
@@ -45,6 +49,6 @@ redoc_uri = 'https://cdn.jsdelivr.net/npm/redoc@2.5.0/bundles/redoc.standalone.j
 #intershpinx mapping with other projects
 intersphinx_mapping = {}
 
-intersphinx_mapping['nonrtric'] = ('%s/o-ran-sc-nonrtric/en/%s' %(baseurl, branch), None)
-intersphinx_mapping['participants'] = ('%s/participants' % selfurl, None)
+intersphinx_mapping['nonrtric'] = ('%s' %(nonrtricurl), None)
+intersphinx_mapping['participants'] = ('%s' %(participantsurl), None)
 intersphinx_disabled_reftypes = ["*"]