DocumenterCitations.jl icon indicating copy to clipboard operation
DocumenterCitations.jl copied to clipboard

Support for custom citation and bibliography styles

Open simonbyrne opened this issue 3 years ago • 6 comments

Would be useful to be able to customize how the citation and bibliographies are printed.

simonbyrne avatar Oct 23 '20 18:10 simonbyrne

I guess we can implement a few styles (ones we want to use) from

https://www.overleaf.com/learn/latex/Bibtex_bibliography_styles https://www.overleaf.com/learn/latex/Natbib_bibliography_styles https://www.overleaf.com/learn/latex/Biblatex_bibliography_styles

and if someone wants a specific (official?) style they can open a PR with an implementation?

We can also add a section in the docs showing how to define custom styles.

ali-ramadhan avatar Oct 23 '20 19:10 ali-ramadhan

Maybe it would be easiest to support CSL for styles?

https://github.com/citation-style-language/styles

kellertuer avatar Oct 31 '20 05:10 kellertuer

Import/export from/to CSL in Bibliography.jl is in the todo list of this summer. I will be back to you once it is done!

Azzaare avatar Jun 05 '21 12:06 Azzaare

We'd also love to be able to print additional data. E.g. Math papers often have MathSciNet and Zentralblatt reviews, which we'd like to link to; or show the DOI; etc.

fingolfin avatar Oct 22 '21 12:10 fingolfin

The newly released DocumenterCitations.jl v1.0 provides a larger range of citation styles, including a new default numeric style.

The updated version also allows defining completely custom styles, as described in the documentation; although the methods for this are considered internal, and thus not part of the stable API.

Support for general CSL styles seems like it could be an attractive feature and is being tracked in https://github.com/JuliaDocs/DocumenterCitations.jl/issues/13

goerz avatar Jul 13 '23 03:07 goerz

Thanks for the follow up :) I am eager to try this out, since I have been through a few different ways of citations by now in my docs and would love to find one that fits even better than the current ones.

edit: It even covers my favourite way of having a references section per documentation page (yay!) – I will definetly try this out!

kellertuer avatar Jul 13 '23 06:07 kellertuer