mdBook icon indicating copy to clipboard operation
mdBook copied to clipboard

Add Bibliography section to books with initial support for Bibtex-format

Open francisco-perez-sorrosal opened this issue 4 years ago • 4 comments

When you write books it's common to add a bibliography and reference citation entries from it. I think it would be nice to have support for this feature in mdBook, allowing to automatically add BibText files as a bibliography and add a referencing template system to allow referencing citation-keys in the bibliography through the markdown files.

Added an initial implementation. Added some tests to check the main paths and functionality. Also basic documentation in the mdBook guide. All the test were passing in my local machine. Please let me know if you're interested in this.

This can be done now through this plugin/preprocessor. Crates: https://crates.io/crates/mdbook-bib Src/Binaries: https://github.com/francisco-perez-sorrosal/mdbook-bib/releases/tag/v0.0.3

I am surprised to see so little interest in this feature. References are central to developing a book. Is there maybe another solution that mdBook users have?

pesho-ivanov avatar Mar 02 '23 14:03 pesho-ivanov

I'm also surprised. Its an essential component even in detailed software documentation, which was the primary use for mdbook as far as I am aware. The preprocessor suggested works, but it is very basic, does not support CSL styles and I was not even able to get some of the already existing style templates to work. In my opinion, references and citing is a feature so fundamental that it should be developed as part of mdbook.

eliasboegel avatar Mar 22 '23 10:03 eliasboegel