Skip to content
Snippets Groups Projects
Select Git revision
  • b6bb4bfc49f86ab8a28f8045ac444b3e5ea240f9
  • master default protected
  • enxhi_issue460_remove_TOAR-I_access
  • michael_issue459_preprocess_german_stations
  • sh_pollutants
  • develop protected
  • release_v2.4.0
  • michael_issue450_feat_load-ifs-data
  • lukas_issue457_feat_set-config-paths-as-parameter
  • lukas_issue454_feat_use-toar-statistics-api-v2
  • lukas_issue453_refac_advanced-retry-strategy
  • lukas_issue452_bug_update-proj-version
  • lukas_issue449_refac_load-era5-data-from-toar-db
  • lukas_issue451_feat_robust-apriori-estimate-for-short-timeseries
  • lukas_issue448_feat_load-model-from-path
  • lukas_issue447_feat_store-and-load-local-clim-apriori-data
  • lukas_issue445_feat_data-insight-plot-monthly-distribution
  • lukas_issue442_feat_bias-free-evaluation
  • lukas_issue444_feat_choose-interp-method-cams
  • 414-include-crps-analysis-and-other-ens-verif-methods-or-plots
  • lukas_issue384_feat_aqw-data-handler
  • v2.4.0 protected
  • v2.3.0 protected
  • v2.2.0 protected
  • v2.1.0 protected
  • Kleinert_etal_2022_initial_submission
  • v2.0.0 protected
  • v1.5.0 protected
  • v1.4.0 protected
  • v1.3.0 protected
  • v1.2.1 protected
  • v1.2.0 protected
  • v1.1.0 protected
  • IntelliO3-ts-v1.0_R1-submit
  • v1.0.0 protected
  • v0.12.2 protected
  • v0.12.1 protected
  • v0.12.0 protected
  • v0.11.0 protected
  • v0.10.0 protected
  • IntelliO3-ts-v1.0_initial-submit
41 results

conf.py

Blame
  • conf.py 4.03 KiB
    # Configuration file for the Sphinx documentation builder.
    #
    # This file only contains a selection of the most common options. For a full
    # list see the documentation:
    # https://www.sphinx-doc.org/en/master/usage/configuration.html
    
    # -- Path setup --------------------------------------------------------------
    
    # If extensions (or modules to document with autodoc) are in another directory,
    # add these directories to sys.path here. If the directory is relative to the
    # documentation root, use os.path.abspath to make it absolute, like shown here.
    #
    import os
    import sys
    
    sys.path.insert(0, os.path.abspath('../src'))
    
    # -- Project information -----------------------------------------------------
    
    project = 'machinelearningtools'
    copyright = '2020, Felix Kleinert, Lukas H Leufen'
    author = 'Felix Kleinert, Lukas H Leufen'
    
    # The short X.Y version
    version = 'v0.9.0'
    # The full version, including alpha/beta/rc tags
    release = 'v0.9.0'
    
    # -- General configuration ---------------------------------------------------
    
    # Add any Sphinx extension module names here, as strings. They can be
    # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
    # ones.
    extensions = [
        'sphinx.ext.autodoc',
        'sphinx.ext.intersphinx',
        'sphinx.ext.todo',
        'sphinx.ext.coverage',
        'sphinx.ext.imgmath',
        'sphinx.ext.ifconfig',
        'sphinx.ext.viewcode',
        'sphinx.ext.autosummary',
        'autoapi.extension',
        'sphinx.ext.napoleon',
        'sphinx_rtd_theme',
        'sphinx.ext.githubpages',
        'recommonmark',
        'sphinx.ext.autosectionlabel',
    ]
    
    # 2020-02-19 Begin
    # following instruction based on
    # https://stackoverflow.com/questions/2701998/sphinx-autodoc-is-not-automatic-enough
    autosummary_generate = True
    
    autoapi_type = 'python'
    autoapi_dirs = ['../../src/.']
    
    # Add any paths that contain templates here, relative to this directory.
    templates_path = ['_templates']
    
    # add asource file parser for markdown
    source_parsers = {
        '.md': 'recommonmark.parser.CommonMarkParser',
    }
    
    # The suffix(es) of source filenames.
    # You can specify multiple suffix as a list of string:
    #
    source_suffix = ['.rst', '.md']
    
    # The master toctree document.
    master_doc = 'index'
    
    # List of patterns, relative to source directory, that match files and
    # directories to ignore when looking for source files.
    # This pattern also affects html_static_path and html_extra_path.
    exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
    
    # -- Options for HTML output -------------------------------------------------
    
    # The theme to use for HTML and HTML Help pages.  See the documentation for
    # a list of builtin themes.
    #
    # html_theme = 'alabaster'
    # html_theme = 'bizstyle'
    # html_theme = 'classic'
    html_theme = 'sphinx_rtd_theme'
    
    
    # Add any paths that contain custom static files (such as style sheets) here,
    # relative to this directory. They are copied after the builtin static files,
    # so a file named "default.css" will overwrite the builtin "default.css".
    html_static_path = ['_static']
    
    # -- Options for LaTeX output ------------------------------------------------
    
    latex_elements = {
        # The paper size ('letterpaper' or 'a4paper').
        #
        # 'papersize': 'letterpaper',
    
        # The font size ('10pt', '11pt' or '12pt').
        #
        # 'pointsize': '10pt',
    
        # Additional stuff for the LaTeX preamble.
        #
        # 'preamble': '',
    
        # Latex figure (float) alignment
        #
        # 'figure_align': 'htbp',
    }
    
    # Grouping the document tree into LaTeX files. List of tuples
    # (source start file, target name, title,
    #  author, documentclass [howto, manual, or own class]).
    latex_documents = [
        (master_doc, 'machinelearningtools.tex', 'MachineLearningTools Documentation',
         author, 'manual'),
    ]
    
    # -- Options for intersphinx extension ---------------------------------------
    
    # Example configuration for intersphinx: refer to the Python standard library.
    intersphinx_mapping = {
        'python': ('https://docs.python.org/3', None),
        'pandas': ('http://pandas.pydata.org/pandas-docs/stable/', None),
        'numpy': ('https://docs.scipy.org/doc/numpy/', None),
        'matplotlib': ('https://matplotlib.org/', None)
    }