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.

Pandoc Conversion

  • Download Pandoc
  • Set Bookdown to build the book as one large Markdown file (docs folder, suffix .md)
  • Use command line to navigate to subfolder with pwd and cd.
  • Convert with: pandoc handsondataviz.md --from markdown --to asciidoc --standalone --output handsondataviz.asciidoc
  • Confirm if AsciiDoc file matches O’Reilly Atlas import style.

  1. This is a note, with no bibliographic reference.↩︎

  2. 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↩︎

  3. 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.↩︎