search

moja-global / Handbook

https://moja-global.github.io/Handbook/
4 stars 12 forks source link

Add bibliographies to each chapter #12

Open aornugent opened 1 year ago

aornugent commented 1 year ago

This appendix has some incomplete citations: https://moja-global.github.io/Handbook/Appendices.html

I think we can include something like bibtex to automatically format citations with footnotes. Recommendations for Sphinx are very welcome.

octonawish-akcodes commented 1 year ago

I want to take this

meenaljain0303 commented 1 year ago

Hello I would love to work on this issue. It would be great if I could be assigned Thanks

harshita214 commented 1 year ago

Hi I am interested to work on this issue. If it's alright then I and @meenaljain0303 can work on it collaboratively as well :)

aornugent commented 1 year ago

@meenaljain0303 @harshita214 - please provide an example of how you plan to integrate bibtex into the Handbook before you begin. We can re-assign this issue if @octonawish-akcodes has not made further progress.

ayush78781 commented 1 year ago

@aornugent I found out sphinxcontrib-bibtex is an extension, which allows to use BibTeX for formatting citations in a Sphinx document. And to create footnotes for citations, we will need to create a custom sphinx extension that overrides the cite role. If this is what you're looking for. I can go ahead working on this issue. Please let me know, if anything additional we need to do here.

aornugent commented 1 year ago

@Namyalg - can you please advise on how we manage sphinx extensions for our CI build?

Namyalg commented 1 year ago

As far as my research goes, I don't think sphinx-extensions are related to the CI

aornugent commented 1 year ago

Ok, great - let's hope it works out of the box then!

sambhavgupta0705 commented 1 year ago

Hey @aornugent are you still working on this?:)

ayush78781 commented 1 year ago

I am working on this issue @sambhavgupta0705. I will open a pull request soon.