from datetime import date import sphinx_rtd_theme # 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('..')) # 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.autosummary", "sphinx.ext.autodoc", "sphinx_autodoc_typehints", "sphinx.ext.coverage", "sphinx.ext.doctest", "sphinx.ext.intersphinx", "sphinx.ext.mathjax", "sphinx.ext.todo", "sphinx.ext.viewcode", "numpydoc", ] always_document_param_types = True # generate autosummary pages autosummary_generate = True # Add any paths that contain templates here, relative to this directory. templates_path = ["_templates"] # The suffix of source filenames. source_suffix = ".rst" # The encoding of source files. source_encoding = "utf-8" # The master toctree document. master_doc = "index" # General substitutions. project = "PredTuner" copyright = f"2020-{date.today().year}, University of Illinois" # There are two options for replacing |today|: either, you set today to some # non-false value, then it is used: # today = '' # Else, today_fmt is used as the format for a strftime call. # today_fmt = '%B %d, %Y' # List of documents that shouldn't be included in the build. # unused_docs = [''] # If true, '()' will be appended to :func: etc. cross-reference text. # add_function_parentheses = True # If true, the current module name will be prepended to all description # unit titles (such as .. function::). add_module_names = False # show_authors = True # The name of the Pygments (syntax highlighting) style to use. # pygments_style = 'friendly' pygments_style = "sphinx" # A list of prefixs that are ignored when creating the module index. (new in Sphinx 0.6) # modindex_common_prefix = ["networkx."] # doctest_global_setup = "import networkx as nx" # Options for HTML output # ----------------------- html_theme = "sphinx_rtd_theme" html_theme_path = [sphinx_rtd_theme.get_html_theme_path()] html_theme_options = { "canonical_url": "https://networkx.org/documentation/stable/", "navigation_depth": 3, "logo_only": True, } # html_logo = "_static/networkx_logo.svg" # The style sheet to use for HTML and HTML Help pages. A file of that name # must exist either in Sphinx' static/ path, or in one of the custom paths # given in html_static_path. # html_style = '' # 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"] # If not '', a 'Last updated on:' timestamp is inserted at every page bottom, # using the given strftime format. html_last_updated_fmt = "%b %d, %Y" # If true, SmartyPants will be used to convert quotes and dashes to # typographically correct entities. # html_use_smartypants = True # Content template for the index page. # html_index = 'index.html' # Custom sidebar templates, maps page names to templates. # html_sidebars = {} # Additional templates that should be rendered to pages, maps page names to # templates. # html_additional_pages = {'': ''} # If true, the reST sources are included in the HTML build as _sources/<name>. html_copy_source = False # Options for LaTeX output # ------------------------ # Use a latex engine that allows for unicode characters in docstrings latex_engine = "xelatex" # The paper size ('letter' or 'a4'). latex_paper_size = "letter" # The font size ('10pt', '11pt' or '12pt'). # latex_font_size = '10pt' latex_appendices = ["tutorial"] # Intersphinx mapping intersphinx_mapping = { "python": ("https://docs.python.org/3/", None), "numpy": ("https://numpy.org/doc/stable/", None), "matplotlib": ("https://matplotlib.org", None), "scipy": ("https://docs.scipy.org/doc/scipy/reference", None), "pandas": ("https://pandas.pydata.org/pandas-docs/stable", None), "pytorch": ("https://pytorch.org/docs/stable", None), } # The reST default role (used for this markup: `text`) to use for all # documents. default_role = "obj" numpydoc_show_class_members = False def setup(app): app.add_css_file("custom.css") app.add_js_file("copybutton.js")