Add references with sphinxcontrib-bibtex

[pwhofman]

Added references based on one central BibTeX file.
I added a reference in a docstring, made an example page to show what citations would look like in the docs and added an alternative bibliography page based on BibTeX.

[Copilot]

Pull Request Overview

Adds support for centralized BibTeX references via sphinxcontrib-bibtex, updates docstrings and docs to use citation roles, and provides both an example page and an alternative bibliography page.

• Introduce sphinxcontrib-bibtex dependency and configure it in Sphinx
• Replace manual footnote reference in si_graph_plot docstring with a :footcite: role
• Add example page, BibTeX file, and alternative bibliography RST page; update TOC

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
shapiq/plot/si_graph.py	Switched manual reference markup to :footcite: and added footbibliography
pyproject.toml	Added sphinxcontrib-bibtex to documentation dependencies
docs/source/references_alternative.rst	Created a standalone alternative bibliography page
docs/source/references.bib	Added central BibTeX file with conference entry
docs/source/index.rst	Included example and references_alternative in Table of Contents
docs/source/example.md	Provided a Markdown example using a citation role
docs/source/conf.py	Configured sphinxcontrib.bibtex and default BibTeX settings

Comments suppressed due to low confidence (1)

shapiq/plot/si_graph.py:64

• The citation role has an extra 't' in :footcite:t:. It should be :footcite:muschalikShapleyInteractions2024`` to match the sphinxcontrib-bibtex syntax.

:footcite:t:`muschalikShapleyInteractions2024`.

[Copilot]

[nitpick] CommonMark does not parse Sphinx roles out of the box, so this citation won’t render. Consider switching this example to reStructuredText or adding the myst-parser extension to enable role support in Markdown.