search

guilgautier / DPPy

Python toolbox for sampling Determinantal Point Processes
https://dppy.readthedocs.io
MIT License
219 stars 52 forks source link

Problem generating the references in the documentation #8

Closed guilgautier closed 6 years ago

guilgautier commented 6 years ago

References do not appear in the Documentation

Error in the build

invalid option value: (option: "encoding"; value: 'latex+latin')
unknown encoding: "latex+latin".

.. bibliography:: biblio.bib
        :encoding: latex+latin
        :style: alpha
        :cited:

While this is what is prescribed in http://sphinxcontrib-bibtex.readthedocs.io/en/latest/usage.html

Let's try without latex+

guilgautier commented 6 years ago

The encoding error was fixed by removing latex+ https://github.com/guilgautier/DPPy/commit/d257587c51309c3c2b50a0b42af2c022139bb976#diff-fe623df13e3acba12841f11ec0e7004a

But the fact that the references section was not displayed is because of the fact that the bibliography is not called in the same document as the citations The fix is to display all the entries of the .bib file using :all: instead of :cited: https://github.com/guilgautier/DPPy/commit/b3e2c1665b0f945315284e935ea8659784bab441#diff-fe623df13e3acba12841f11ec0e7004a

see http://sphinxcontrib-bibtex.readthedocs.io/en/latest/usage.html#unresolved-citations-across-documents