conf.py

# icalendar documentation build configuration file
import importlib.metadata
import datetime
import os

on_rtd = os.environ.get('READTHEDOCS', None) == 'True'

try:
    import sphinx_rtd_theme
    html_theme = 'sphinx_rtd_theme'
    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
except ImportError:
    html_theme = 'default'
    if not on_rtd:
        print('-' * 74)
        print('Warning: sphinx-rtd-theme not installed, building with default '
              'theme.')
        print('-' * 74)

extensions = [
    'sphinx.ext.autodoc',
    'sphinx.ext.coverage',
    'sphinx.ext.viewcode',
    'sphinx_copybutton',
    'sphinx.ext.intersphinx',
    'sphinx.ext.autosectionlabel',
]
source_suffix = '.rst'
master_doc = 'index'

project = 'icalendar'
this_year = datetime.date.today().year
copyright = f'{this_year}, Plone Foundation'
version = importlib.metadata.version('icalendar')
release = version

exclude_patterns = ['_build', 'lib', 'bin', 'include', 'local']
pygments_style = 'sphinx'

htmlhelp_basename = 'icalendardoc'

man_pages = [
    ('index', 'icalendar', 'icalendar Documentation',
     ['Plone Foundation'], 1)
]

intersphinx_mapping = {
    "python": ("https://docs.python.org/3", None),
}