Bibtex bibliography directive renders unreferenced citation

[mtiley]

This happens when there are user errors in the {cite} roles in the document (specifically, reference to something not in the .bib)

To Reproduce

1. {cite} something that is not in reference.bib
2. put in a {bibliography}
3. observe that the bibliography contains references not cited in the document

Edit: Sorry, this is wrong. Another instance here with different cause.

Screenshots
Here is a citation with no corresponding entry in references.bib

The bibliography outputs a different reference:

(This doesn't happen with rST and seems to be introduced by myst_parser. The following is in a separate Sphinx project with only sphinxcontrib.bibtex as an extension.) See input:

html output:

Environment:

• myst-parser 0.2.0
• sphinxcontrib.bibtex 1.0.0

[mmcky]

@mtiley is the incorrect reference resolving to the nearest reference in the references.bib file? It is an issue that the incorrect reference is getting adding rather than throwing an error that it cannot resolve the reference. This is likely a sphinx translator issue? @chrisjsewell is the AST correct for the parser?

[mtiley]

@mmcky I don't think so -- Yuna will be doing some more testing tomorrow.

This is the .bib file I was using (had to change to .txt to upload): references.txt

[mtiley]

Update: I have replicated the problem in a project (files here) without myst-parser (only sphinxcontrib.bibtex) as an extension. Seems to be an issue with (or feature of) sphinxcontrib-bibtex and not introduced by myst-parser after all -- so I think this issue can be closed.

Discussion here mcmtroffaes/sphinxcontrib-bibtex#62 and here mcmtroffaes/sphinxcontrib-bibtex#52

The problem appears to be fixed in rST by adding a :filter: docname in docnames option to the bibliography directive so that only citations in that particular document appear in the bibliography. I can't get this to work in MyST at the moment but will play around with it a bit more.

[chrisjsewell]

@mtiley ok I'll close this issue for now then, and if you do uncover a discrepancy, please open another issue and, if possible, a PR with a minimal working example; in a similar fashion to what I did in #97 (adding to https://github.com/ExecutableBookProject/MyST-Parser/tree/master/tests/test_sphinx)