docs/conf.py

   1 #  ============LICENSE_START===============================================
   2 #  Copyright (C) 2021-2023 Nordix Foundation. All rights reserved.
   3 #  Copyright (C) 2023 OpenInfra Foundation Europe. All rights reserved.
   4 #  ========================================================================
   5 #  Licensed under the Apache License, Version 2.0 (the "License");
   6 #  you may not use this file except in compliance with the License.
   7 #  You may obtain a copy of the License at
   8 #
   9 #       http://www.apache.org/licenses/LICENSE-2.0
  10 #
  11 #  Unless required by applicable law or agreed to in writing, software
  12 #  distributed under the License is distributed on an "AS IS" BASIS,
  13 #  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 #  See the License for the specific language governing permissions and
  15 #  limitations under the License.
  16 #  ============LICENSE_END=================================================
  17 #
  18
  19 # NB: This is the only conf.yaml file used by the upstream readthedocs job  (ref '.readthedocs.yaml')
  20 #     Where possible include contents of the sub-folders' 'conf.yaml' files here if appropriate
  21
  22 from docs_conf.conf import *
  23
  24 branch = 'latest'
  25 subsitesbranch = 'latest' # set this to latest for the first build on a new branch. Then change in next commit.
  26
  27 baseurl = 'https://docs.o-ran-sc.org/projects/'
  28 selfurl = '%s/o-ran-sc-nonrtric-plt-ranpm/en/%s' %(baseurl, branch)
  29 subsitesurl = '%s/o-ran-sc-nonrtric-plt-ranpm/en/%s' %(baseurl, subsitesbranch)
  30
  31 linkcheck_ignore = [
  32     'http://localhost.*',
  33     'http://127.0.0.1.*',
  34     'https://gerrit.o-ran-sc.org.*'
  35 ]
  36
  37 extensions = [
  38     'sphinx.ext.intersphinx',
  39     'sphinx.ext.autosectionlabel',
  40 ]
  41
  42 #intershpinx mapping with other projects
  43 intersphinx_mapping = {}
  44 intersphinx_mapping['nonrtric'] = ('%s/o-ran-sc-nonrtric/en/%s' %(baseurl, branch), None)
  45 ## Note there is a circular dependency here - sub-project pages must exist before they can be checked
  46 intersphinx_mapping['influxlogger'] = ('%s/influxlogger' %subsitesurl, None)
  47 intersphinx_mapping['datafilecollector'] = ('%s/datafilecollector' %subsitesurl, None)
  48 intersphinx_mapping['pmproducer'] = ('%s/pmproducer' %subsitesurl, None)
  49 intersphinx_mapping['pm-file-converter'] = ('%s/pm-file-converter' %subsitesurl, None)
  50
  51 intersphinx_disabled_reftypes = ["*"]