Author, year citations

Currently, jupyter-book uses sphinxcontrib-bibtex for creating citation keys in text using the cite directive.

However, for academic citations (at least for my field) the convention is to use an author, year citation key.

There’s an issue open about this on sphinxcontrib-bibtex: https://github.com/mcmtroffaes/sphinxcontrib-bibtex/issues/201

I think it comes down to just creating a custom citation class using pybtex.

I think this is something in my wheelhouse to do a PR for if it’s something you all think has value.

Would this be a matter of just adding it to some jupyter-book conf.py? And then registering it somehow?

[jbusecke]

Hi everyone, I am trying to homogenize the citation/bibliography style for this project(https://github.com/OceanGlidersCommunity/Oxygen_SOP/issues/88). Ideally we would like the Bibliography to show the same format as the citations (example here).

Example of text citation:

Correponding Bibliography entry:

I guess what I am most unclear about is how I could implement this custom sphinxcontrib-bibtex code in the _config.yml syntax if that is even possible.

If this is not possible, could we export and modify the conf.py file and then use that in the book build? Sorry if these are pretty basic questions, I only have a little experience with jupyter book so far.

If someone here has some concrete tips on how to implement this, I would very much appreciate it. I think this is broadly relevant for many folks in e.g. the earth science community. If there is a solution, I’d be happy to work on adding that to the docs if needed.

Thanks!

[amichuda]

Some really cool news from sphinxcontrib-bibtex:

https://github.com/mcmtroffaes/sphinxcontrib-bibtex/issues/203