CommunityData:Build papers

From CommunityData
Revision as of 15:25, 14 April 2016 by Aaronshaw (talk | contribs) (Created page with "== Basic steps (quick and dirty version) == # Export a bib file from Zotero into the directory where you're building your paper. Call the file <code>refs.bib</code> # The fir...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Basic steps (quick and dirty version)

  1. Export a bib file from Zotero into the directory where you're building your paper. Call the file refs.bib
  2. The first time you're building the paper, you can just run make or make all. After that, you probably want to run make clean; make all. This should work whether you're using an .Rnw (knitter) or .tex (LaTeX) file.

Style notes and more details (add as needed)

  • For sanity, it's good to create sub-directories within the paper directory to store things like knitter data and figures. For most of our existing projects these sub-directories have informative names like knitter_data and figures.
  • Don't edit refs-processed.bib by hand. This is a file that the Makefile builds every time it compiles the paper. If you have some reason to edit the bibliography by hand, edits refs.bib, but do so at your own risk since collaborators and other Community Data folks may come by your repository and try to build the paper by downloading a new bib file from Zotero unless you tell them otherwise!