#+date: 2022-07-03
#+bibliography: ../bib/bibliog.bib
#+bibliography: ../bib/lepto-ref.bib
#+options: toc:nil num:nil author:nil

* How to make citations using Emacs org-mode

It is possible to include bibliographic citations within org documents.

Interesting information about org-cite can be found in the manual.

Use ~C-h~ ~i~ in emacs to access the manual and then access the org-manual navigating
in the menu (use the letter ~m~ and type 'org..')

See Org Manual -> Citation handling -> Citations

** Include a header linking a file with references

You should include the path and the name of the file containing the bibliographic references. Include something like this at the beggining of your document:

#+begin_example
#+bibliography: ./bibliog.bib
#+bibliography: ~/Doc/file.json
#+end_example

Here the file may be a '.bib' , 'bibtex' or a '.json' document.

** Including citation

You can use 'C-c C-x @' (org-cite-insert) to include references from the linked
file. For instance:

[cite:/s/v/@OrgCitations]

Citing from the second file [cite:/s/v/@bernard_leptospirosis_1993]

Where "s" and "v" are the style and variant of the citation.

** Print bibliography

Use the following to print the references:

#+begin_example org
#+print_bibliography:
#+end_example

The references will appear when you export (tangle) the document to any format (html, odt...)

** Using csl

You can use ~csl~ files to format your references. Install ~citeproc~ in emacs, then
use the following in the org file header:

#+begin_example
#+cite_export: csl ../bib/apa-5th-edition.csl
#+end_example

Where ~../bib/apa-5th-edition.csl~ is the name of the ~csl~ file


** Some cool documents to learn more about bibliography management in org-mode

* References

- About 'org-ref: https://github.com/jkitchin/org-ref
- About 'org-cite': https://blog.tecosaur.com/tmio/2021-07-31-citations.html#org367f817

#+print_bibliography: