Merge branch 'main' into pyproject.toml-update

Author: gavinmacaulay

README.md

@@ -57,7 +57,7 @@ Learn more about echopype in the official documentation at https://echopype.read
 
 ## Contributing
 
-You can find information about how to contribute to echopype at our [Contributing Page](https://echopype.readthedocs.io/en/latest/contributing.html).
+You can find information about how to contribute to echopype at our [Contributing Page](https://echopype.readthedocs.io/en/latest/contrib_start.html#contributing-to-echopype).
 
 <!-- ## <img src="docs/source/images/GSoC-logo-horizontal.svg" alt="Google Summer of Code logo" width="300" style="padding-right: 50px; vertical-align: middle">
 

docs/source/conf.py

@@ -11,7 +11,7 @@
 execution_excludepatterns = []
 execution_in_temp = False
 execution_timeout = -1
-extensions = ['sphinx_togglebutton', 'sphinx_copybutton', 'myst_nb', 'sphinx_thebe', 'sphinx_comments', 'sphinx_external_toc', 'sphinx.ext.intersphinx', 'sphinx_panels', 'sphinx_book_theme', 'sphinx_automodapi.automodapi', 'numpydoc', 'sphinx.ext.mathjax', 'sphinx.ext.ifconfig', 'sphinx.ext.githubpages', 'sphinxcontrib.mermaid', 'sphinx_jupyterbook_latex', "sphinx_inline_tabs"]  # noqa: E501
+extensions = ['sphinx_togglebutton', 'sphinx_copybutton', 'myst_nb', 'sphinx_thebe', 'sphinx_comments', 'sphinx_external_toc', 'sphinx.ext.intersphinx', 'sphinx_panels', 'sphinx_book_theme', 'sphinx_automodapi.automodapi', 'numpydoc', 'sphinx.ext.mathjax', 'sphinx.ext.ifconfig', 'sphinx.ext.githubpages', 'sphinxcontrib.mermaid', 'sphinx_jupyterbook_latex', 'sphinx_inline_tabs', 'sphinxcontrib.bibtex']  # noqa: E501
 external_toc_exclude_missing = False
 external_toc_path = '_toc.yml'
 html_baseurl = ''
@@ -35,3 +35,6 @@
 suppress_warnings = ['myst.domains']
 use_jupyterbook_latex = True
 use_multitoc_numbering = True
+bibtex_bibfiles = ['references.bib']
+bibtex_reference_style = 'author_year'
+bibtex_default_style = 'alpha'

docs/source/references.bib

@@ -35,6 +35,7 @@ @article{Ainslie1998
 	issn = {0001-4966},
 	doi = {10.1121/1.421258},
 	number = {3},
+	year = {1998},
 	journal = {The Journal of the Acoustical Society of America},
 	author = {Ainslie, Michael A. and McColm, James G.},
 	note = {Publisher: Acoustical Society of America},

pyproject.toml

@@ -92,6 +92,7 @@ docs = [
     "sphinx-panels",
     "sphinx-thebe",
     "sphinx-togglebutton",
+    "sphinxcontrib-bibtex",
     "sphinxcontrib-mermaid",
     "sphinx-inline-tabs",
 ]