Notes and Bibliography
This book displays endnotes for each chapter in the HTML book, and footnotes at the bottom of pages for the PDF and MS Word books, followed by an alphabetized bibliography of all references cited on the last page. The notes and bibliography also appear in the full-book Markdown file.
To create notes, insert citation keys in the text, such as @huffHowLieStatistics1954
, which are generated by Zotero bibliographic database with the Better BibTex extension, and export these in the Better BibLaTeX format into the dataviz.bib
in the book repo. The repo also contains .csl
file to generate the notes and bibliography in a specific Chicago-style format, downloaded from the Zotero Styles Repository. These instructions are referenced in the index.Rmd
file for both the HTML and PDF formats, as shown in these excerpts:
bibliography: dataviz.bib
citation-style: chicago-fullnote-bibliography.csl
...
output:
bookdown::gitbook:
...
pandoc_args: [ "--csl", "chicago-fullnote-bibliography.csl" ]
bookdown::pdf_book:
...
citation_package: none
pandoc_args: [ "--csl", "chicago-fullnote-bibliography.csl" ]
Here’s a text-only note, with no Zotero citation.2
To create a note with citations only, separate Zotero/BibTeX citation keys with semi-colons:3
Since notes also may include text and punctuation in Markdown syntax, always insert a caret symbol prior to the brackets to demarcate a note:4
Note that the chicago-fullnote-bibliography.csl
format automatically shortens the note after it its first reference.
Custom Blocks
Note: I moved code to TODO
folder because it’s not working as expected for LaTeX PDF output.
Pandoc Conversion
- Download Pandoc
- TODO: Ask Ilya about my Pandoc PATH and/or overwriting older version
- Set Bookdown to build the book as one large Markdown file (docs folder, suffix .md)
- Use command line to navigate to subfolder with
pwd
andcd
. - Convert with:
pandoc bookdown-template.md --from markdown --to asciidoc --standalone --output bookdown-template-modified.asciidoc
- Confirm if AsciiDoc file matches O’Reilly Atlas import style.
This is a note, with no bibliographic reference.↩︎
Darrell Huff, How to Lie with Statistics (W. W. Norton & Company, 1954–2010), http://books.google.com/books?isbn=0393070875; Mark S. Monmonier, How to Lie with Maps, 2nd ed. (University of Chicago Press, 1996), http://books.google.com/books?isbn=0226534219↩︎
Compare how “lying” is justified by Huff, How to Lie with Statistics, pp. 10-11 and Monmonier, How to Lie with Maps, pp. 11-12.↩︎