-
Notifications
You must be signed in to change notification settings - Fork 4
Citations
Dayne asked for a "How to Cite" statement on the Credits page. This got expanded to download buttons that can export various bibliographic formats.
We decided to base the citation on CMS. Examples
Bouman, Katie. “How to Take a Picture of a Black Hole.” Filmed November 2016 at
TEDxBeaconStreet, Brookline, MA. Video, 12:51.
https://www.ted.com/talks/katie_bouman_what_does_a_black_hole_look_like.
Google. “Privacy Policy.” Privacy & Terms. Last modified April 17, 2017.
https://www.google.com/policies/privacy/.
Yale University. “About Yale: Yale Facts.” Accessed May 1, 2017.
https://www.yale.edu/about-yale/yale-facts.
Quarto can incorporate citations using PanDoc in various formats (Citations and Footnotes). They document the formats thusly
- BibLaTeX (
.bib) file - BibTeX (
.bibtex) file - CSL (Citation Style Language) file which specifies the formatting to use when generating the citations and bibliography
- alternatively could use natbib or biblatex to generate the bibliography (out of scope)
BibLaTeX is a package to format bibliographies in LaTex. BibLATEX has a backend program, “biber”, that it uses to read and process the bibliographic data. BibTeX was introduced 25 years ago to do the same. Overleaf's opinion on BibTeX is that:
If you are starting from scratch we recommend using biblatex because that package provides localization in several languages, it’s actively developed and makes bibliography management easier and more flexible.
BibTeX and BibLaTex are very similar. In contexts other than Quarto, they have the same .bib extension. However, they do treat websites differently.
Citing a website in BibTeX looks like:
@misc{label,
title = {Website Title},
url = {http://website-url.com},
author = {Author Name},
year = {Year Published},
note = {Accessed on Month Day, Year}
}
Citing a website in BibLaTex is much better. It looks like:
@online{CiteDrive2022,
title = {Website Title},
author = {Author Name},
year = {Year Published},
url = {http://website-url.com},
urldate = {Use the date of access formatted like YYYY-MM-DD}
}
In addition to generated bibliographies, Quarto can also add a citation element (in text and BibLaTeX) to a webpage - a process they call Citable Articles. The element is in a separate section coded <div id="quarto-appendix" id="quarto citation">, which the Quarto documentation calls an "appendix". Note: this is not the same as a web book Appendix section. In fact, this method of creating a citation does not seem to work in a web book.
The formatting for Citable Articles must be placed in the front matter header of the page where the citation will occur. If you put it in _quarto.yml, adds a citation to every page and uses the title of the page, not the title of the website.
Also, it seems to assume a format for the name. As an example, adding this front matter.
author:
- name: "Alaska Center for Energy and Power"
url: https://www.uaf.edu/acep/
citation: true
Formats the author as Center for Energy and Power, Alaska. Perhaps that can be altered with CSL.
RIS is a citation format developed by Research Information Systems, Incorporated. It is supported by reference manager software, but Quarto does not seem to care about it at all. EndNote uses WEB as the type (TY) of reference for web pages, but Zotero uses ELEC. An example would be:
TY - ELEC
AU - Alaska Center for Energy and Power
TI - 2024 Alaska Electricity Trends Report
PY - 2024
DA - 2024-04-16
UR - https://acep-uaf.github.io/aetr-web-book-2024/
N1 - Accessed on April 16, 2024
ER -
where TY = Type, AU = Author, TI = title, PY = publication year, DA = date accessed, UR = URL, N1 = Notes, and ER = End Record.
Ian used ojs to make download buttons with format hardcoded based on the examples above, but the date dynamically generated.
Liz used Zotero to load the resulting files to make sure it works. Overleaf also can read BibLaTeX files and gives great error messages; Overleaf helped diagnose problems involving the date format.