diff options
| author | Clément Pit-Claudel | 2018-08-13 18:27:20 -0400 |
|---|---|---|
| committer | Théo Zimmermann | 2018-09-20 10:12:55 +0200 |
| commit | 7eced434fb9ceafc2d6e248aa5e49bbd6cd2e1fa (patch) | |
| tree | de3e2db007c9abb2a8b86903a1bb4dbdd611460a /doc/sphinx/zebibliography.html.rst | |
| parent | dc4fc036cd361fe0d2943039e75570cf08a90868 (diff) | |
[doc] Create a separate zebibliography file for the LaTeX build
`.. bibliography::` puts the bibliography on its own page with its own title in
LaTeX, but includes it inline without a title in HTML [1], so we need to
maintain two separate copies of zebibliography.rst
[1] https://sphinxcontrib-bibtex.readthedocs.io/en/latest/usage.html#mismatch-between-output-of-html-and-latex-backends
Diffstat (limited to 'doc/sphinx/zebibliography.html.rst')
| -rw-r--r-- | doc/sphinx/zebibliography.html.rst | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/sphinx/zebibliography.html.rst b/doc/sphinx/zebibliography.html.rst new file mode 100644 index 0000000000..756edd5482 --- /dev/null +++ b/doc/sphinx/zebibliography.html.rst @@ -0,0 +1,17 @@ +.. There are multiple issues with sphinxcontrib-bibtex that we have to work around: + - The list of cited entries is computed right after encountering + `.. bibliography`, so the file containing that command has to come last + alphabetically: + https://sphinxcontrib-bibtex.readthedocs.io/en/latest/usage.html#unresolved-citations-across-documents + - `.. bibliography::` puts the bibliography on its own page with its own + title in LaTeX, but includes it inline without a title in HTML: + https://sphinxcontrib-bibtex.readthedocs.io/en/latest/usage.html#mismatch-between-output-of-html-and-latex-backends + +.. _bibliography: + +============== + Bibliography +============== + +.. bibliography:: biblio.bib + :cited: |