kjhealy / workflow-paper

The .md source for "The Plain Person's Guide to Plain Text Social Science". To exactly reproduce the PDF you will need current versions of R, TexLive, biber, and the support files at http://www.kieranhealy.org/resources.html.

The Plain Person's Guide to Plain Text Social Science

Kieran Healy

About

This repository contains a .md file to create "The Plain Person's Guide to Plain Text Social Science", a guide to software tools, aimed at graduate students in the social sciences. It is a revised version of Choosing Your Workflow Applications. The main changes are updated links, additional obiter dicta, a stronger emphasis on RMarkdown, knitr, and pandoc, and a conversion of the base document format to Markdown (and away from org-mode). If you have the tools described in here, along with the templates and configuration files described here, then the Makefile can create a nice .pdf, .tex, or .html file for you in a single step.

workflow-paper's Issues

Errors in the text

Hello Dr. Healy,
I've read the paper and I've found it really interesting. The suggested workflow imo doesn't appeal only to social scientists, I am a chemistry student and had already approached some of the application you suggested (LaTeX, R) before finding a reference to your previous paper on tex.sx. I'm learning Emacs (actually I've read it because I needed some encouragement to persevere) and I plan to start using Git. Markdown is not indispensable but it's a clever use of it you describe and one anyone could find useful.
I've found some errors in the text I'm reporting here, but I started keeping track of them only from around page 10. Anyway, here they are:

• p. 13, the last sentence before the section about markdown is repeated;
• p. 20, "What I will show you here";
• p. 23, "Then the show the pandoc commands";
• p. 23, "The Makefile itself is shown";
• p. 25, "interpreted as single lines of text";
• p. 25, the link to Lincoln Mullen's discussion is broken but the Internet Archive -- may it always be blessed -- provides this snapshot;
• p.25, the paragraph that starts with "The particular steps"... is repeated twice;
• p. 32, "a box software of software". Too much software.

That's it. Thank you for putting this all online, free.

Kind regards,
Andrea

PS I would have edited the source had I known how to do it.

Problem with make pdf

When I simply do make pdf I get the following error:

pandoc -r markdown+simple_tables+table_captions+yaml_metadata_block --listings -s -S --latex-engine=pdflatex --template=/Users/sergiobacelar/.pandoc/templates/latex.template --filter pandoc-crossref --filter pandoc-citeproc --csl=/Users/sergiobacelar/.pandoc/csl/apsa.csl --filter pandoc-citeproc-preamble --bibliography=/Users/sergiobacelar/Documents/bibs/socbib.bib README.md -o README.pdf
! Undefined control sequence.
l.53 This repository contains a \lstinline

pandoc: Error producing PDF

Note that pandoc is trying to use a README.md file ??? I ignore from where it came.
But all works well if I simply change README in the same pandoc command in the Terminal for the real name of the file plain-person-text. Any suggestion?

Link to the pdf file in the readme does not work

http://kieranhealy.org/files/misc/plain-person-text.pdf does not exist.