Customization of the bibliography in LaTeX output

[mgeier]

This is a feature request that was discussed in the mailing list:
https://groups.google.com/forum/#!topic/sphinx-dev/qHIpc7XskZY

Problem

When using the sphinxcontrib-bibtex extension, the list of references can be placed in the document with the bibliography directive. At least that's the case for HTML output; in LaTeX output, the list of references is moved to the very end of the resulting LaTeX document.

This is documented: https://sphinxcontrib-bibtex.readthedocs.io/en/latest/usage.html#mismatch-between-output-of-html-and-latex-backends

The reason for this behavior is sphinx.builders.latex.BibliographyTransform, which cannot easily be disabled.

A work-around is shown there: mcmtroffaes/sphinxcontrib-bibtex#156

In the mailing list, @tk0miya said:

I can provide the option for the transform like "as is", "per
chapter" and "per document".
If you like it, please post a feature request. I'll work for it (in future).

I think such an option would be great.

I'm mostly interested in the "as is" option, but other people might also want "per chapter".

[tk0miya]

I think the option I commented is not only for LaTeX. It would be better if we adopted it to other formats.

Personally, I wrote a similar extension for footnotes on building HTML and EPUB; sphinxcontrib.getstart_sphinx.footnote_relocator.
https://pypi.org/project/sphinxcontrib-getstart-sphinx/
I suppose writers prefers to locate them nearly the paragraph, but readers prefers to gather them all on the end of chapters, sections or books.

Anyway, it would be nice to provide the option. +1 for the idea!