sphinxcontrib-bibtex #253

conf.py

#### General ####

extensions = ["sphinx.ext.autodoc",
              "sphinx.ext.autosummary",
              "sphinx.ext.doctest",
              "sphinx.ext.mathjax",
              "sphinx.ext.viewcode",
              "sphinxcontrib.bibtex"]

templates_path = ["templates"]
source_suffix = [".rst"]
master_doc = "index"

exclude_patterns = ["build"]

pygments_style = "sphinx"

todo_include_todos = False

numpydoc_show_class_members = False


bibtex_bibfiles = ["references.bib"]
bibtex_default_style = "plain" # This parameter seems not to change anything



#### HTML ####

html_theme = "alabaster"
html_sidebars = {"**": ["about.html",
                        "navigation.html",
                        "relations.html",
                        "searchbox.html",
                        "donate.html"]}
html_theme_options = {
    "description"   : "Lorem ipsum",
    "logo_name"     : "false",
    "github_banner" : "true",
    "page_width"    : "85%",
    "fixed_sidebar" : "true"
}

index.rst

Test

The following papers are cited :footcite:`kabsch_solution_1976, kabsch_discussion_1978`.

References

.. footbibliography::

references.bib

@article{kabsch_solution_1976,
	title = {A solution for the best rotation to relate two sets of vectors},
	volume = {32},
	copyright = {Copyright (c) 1976 International Union of Crystallography},
	issn = {0567-7394},
	url = {//scripts.iucr.org/cgi-bin/paper?a12999},
	doi = {10.1107/S0567739476001873},
	abstract = {A simple procedure is derived which determines a best rotation of a given vector set into a second vector set by minimizing the weighted sum of squared deviations. The method is generalized for any given metric constraint on the transformation.},
	language = {en},
	number = {5},
	urldate = {2021-06-10},
	journal = {Acta Crystallographica Section A: Crystal Physics, Diffraction, Theoretical and General Crystallography},
	author = {Kabsch, W.},
	month = sep,
	year = {1976},
	note = {Number: 5
Publisher: International Union of Crystallography},
	pages = {922--923},
}

@article{kabsch_discussion_1978,
	title = {A discussion of the solution for the best rotation to relate two sets of vectors},
	volume = {34},
	copyright = {Copyright (c) 1978 International Union of Crystallography},
	issn = {0567-7394},
	url = {//scripts.iucr.org/cgi-bin/paper?a15629},
	doi = {10.1107/S0567739478001680},
	abstract = {A method is discussed for obtaining the best proper rotation to relate two sets of vectors.},
	language = {en},
	number = {5},
	urldate = {2021-06-10},
	journal = {Acta Crystallographica Section A: Crystal Physics, Diffraction, Theoretical and General Crystallography},
	author = {Kabsch, W.},
	month = sep,
	year = {1978},
	note = {Number: 5
Publisher: International Union of Crystallography},
	pages = {827--828},
}