emacs_tutorial/doc/citations.org

69 lines
1.9 KiB
Org Mode
Raw Normal View History

#+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: