docs/conf.py

   1 # -*- coding: utf-8 -*-
   2
   3 extensions = [
   4     'sphinx.ext.todo',
   5     'sphinx.ext.intersphinx',
   6     'sphinx.ext.extlinks',
   7 ]
   8
   9 intersphinx_mapping = {
  10     'gtk': ('https://lazka.github.io/pgi-docs/Gtk-3.0', None),
  11     'gobject': ('https://lazka.github.io/pgi-docs/GObject-2.0', None),
  12     'glib': ('https://lazka.github.io/pgi-docs/GLib-2.0', None),
  13     'gdk': ('https://lazka.github.io/pgi-docs/Gdk-3.0', None),
  14     'gio': ('https://lazka.github.io/pgi-docs/Gio-2.0', None),
  15     'python2': ('https://docs.python.org/2.7', None),
  16     'python3': ('https://docs.python.org/3', None),
  17 }
  18
  19 source_suffix = '.rst'
  20 master_doc = 'index'
  21 exclude_patterns = ['_build', 'README.rst']
  22
  23 pygments_style = 'tango'
  24 html_theme = 'sphinx_rtd_theme'
  25 html_show_copyright = False
  26 html_favicon = "images/favicon.ico"
  27 project = "PyGObject"
  28 html_title = project
  29
  30 html_context = {
  31     'extra_css_files': [
  32         'https://quodlibet.github.io/fonts/font-mfizz.css',
  33         '_static/extra.css',
  34     ],
  35     "display_gitlab": True,
  36     "gitlab_user": "GNOME",
  37     "gitlab_repo": "pygobject",
  38     "gitlab_version": "master",
  39     "conf_py_path": "/docs/",
  40     "gitlab_host": "gitlab.gnome.org",
  41 }
  42
  43 html_static_path = [
  44     "extra.css",
  45     "images/pygobject-small.svg",
  46 ]
  47
  48 html_theme_options = {
  49     "display_version": False,
  50 }
  51
  52 extlinks = {
  53     'bzbug': ('https://bugzilla.gnome.org/show_bug.cgi?id=%s', 'bz#'),
  54     'issue': ('https://gitlab.gnome.org/GNOME/pygobject/issues/%s', 'issue#'),
  55     'commit': ('https://gitlab.gnome.org/GNOME/pygobject/commit/%s', 'commit#'),
  56     'mr': (
  57         'https://gitlab.gnome.org/GNOME/pygobject/merge_requests/%s', 'mr#'),
  58     'user': ('https://gitlab.gnome.org/%s', ''),
  59 }
  60
  61 suppress_warnings = ["image.nonlocal_uri"]