2 # -*- coding: utf-8 -*-
3 # SPDX-License-Identifier: EPL-1.0
4 ##############################################################################
5 # Copyright (c) 2018 The Linux Foundation and others.
7 # All rights reserved. This program and the accompanying materials
8 # are made available under the terms of the Eclipse Public License v1.0
9 # which accompanies this distribution, and is available at
10 # http://www.eclipse.org/legal/epl-v10.html
11 ##############################################################################
13 from docs_conf.conf import *
17 def update_intersphinx_mapping():
18 with open('../projects_list.tsv') as fd:
19 rd = csv.reader(fd, delimiter="\t", quotechar='"')
26 intersphinx_mapping[project] = (f'https://docs.opendaylight.org/projects/{project}/en/{version}/', None)
29 # Append to intersphinx_mapping
30 update_intersphinx_mapping()
32 # OpenDaylight Documentation Releases
33 intersphinx_mapping['odl-potassium'] = ('https://docs.opendaylight.org/en/latest/', None)
34 intersphinx_mapping['odl-argon'] = ('https://docs.opendaylight.org/en/stable-argon/', None)
35 intersphinx_mapping['odl-chlorine'] = ('https://docs.opendaylight.org/en/stable-chlorine/', None)
36 intersphinx_mapping['odl-sulfur'] = ('https://docs.opendaylight.org/en/stable-sulfur/', None)
37 intersphinx_mapping['odl-phosphorus'] = ('https://docs.opendaylight.org/en/stable-phosphorus/', None)
38 intersphinx_mapping['odl-silicon'] = ('https://docs.opendaylight.org/en/stable-silicon/', None)
39 intersphinx_mapping['odl-aluminium'] = ('https://docs.opendaylight.org/en/stable-aluminium/', None)
40 intersphinx_mapping['odl-magnesium'] = ('https://docs.opendaylight.org/en/stable-magnesium/', None)
41 intersphinx_mapping['odl-sodium'] = ('https://docs.opendaylight.org/en/stable-sodium/', None)
42 intersphinx_mapping['odl-neon'] = ('https://docs.opendaylight.org/en/stable-neon/', None)
43 intersphinx_mapping['odl-fluorine'] = ('https://docs.opendaylight.org/en/stable-fluorine/', None)
44 intersphinx_mapping['odl-oxygen'] = ('https://docs.opendaylight.org/en/stable-oxygen/', None)
45 intersphinx_mapping['odl-nitrogen'] = ('https://docs.opendaylight.org/en/stable-nitrogen/', None)
46 intersphinx_mapping['odl-carbon'] = ('https://docs.opendaylight.org/en/stable-carbon/', None)
50 # Ignore ssh:// links from linkcheck
52 # Ignore jenkins because it's often slow to respond.
53 'https://jenkins.opendaylight.org/releng',
54 'https://jenkins.opendaylight.org/sandbox',
55 # The '#' in the path makes sphinx think it's an anchor
56 'https://git.opendaylight.org/gerrit/#/admin/projects/releng/builder',
57 'https://git.opendaylight.org/gerrit/#/c/',
58 'https://git.opendaylight.org/gerrit/gitweb',
59 # URL returns a 403 Forbidden
60 'https://www.osgi.org',
61 # Ignore anchors on github.com because linkcheck fails on them
62 '^https?://github.com/.*#',
63 # Ignore webchat anchors because '#' is not an anchor for this app
64 'https://web.libera.chat/#',
65 # Ignore google docs anchors
66 'https://docs.google.com/presentation/d/1bnwj8CrFGo5KekONYSeIHySdkoXZiewJxkHcZjXnzkQ/edit#slide=id.g17d8ae4d92_0_137',
67 # Ignore local static contents
68 '../_static/OpenDaylight-Technical-Charter-LFN-Projects-LLC-FINAL.pdf',
69 # Ignore IETF URLs often not reachable from Jenkins minions
70 # because of hosting connectivity issues
71 '^https?://tools.ietf.org/html/.*',
72 # anchors not correctly detected by sphinx on the gate
73 'http://checkstyle.sourceforge.net/config_coding.html#.*',
74 # this url often has connectivity issues on the gate
75 'https://www.mojohaus.org/animal-sniffer/animal-sniffer-maven-plugin/examples/checking-signatures.html',
76 #Ignore announce page link till it is up
77 'https://www.opendaylight.org/current-release-chlorine',
78 'https://www.opendaylight.org/current-release-argon',
80 linkcheck_timeout = 300
85 spelling_warning = True
86 spelling_exclude_patterns = ['release-notes/release-notes-*', 'release-notes/projects/*']
89 'version_status': 'supported',
92 # Helper for JIRA references
93 sys.path.append(os.path.abspath('ext'))
94 extensions.append('odl-jira')
96 # Set language to English
101 app.add_css_file("css/ribbon.css")