download free ebook or buy a paper copy
TeX HTML Shell
Switch branches/tags
Nothing to show
Latest commit c484261 Sep 6, 2016 @holtzermann17 holtzermann17 committed on GitHub Add DOI badge
Failed to load latest commit information.
code Add a tiny piece of experimental SQL code Dec 29, 2013
en-md Add link to Peeragogy in Action community on G+ Jul 29, 2015
papers Add some old work on the roadmaps paper Dec 29, 2013
coworking.patch Initial import Jan 22, 2013
howard-intro.txt Add a couple new sections and a short ancillary text from Howard Dec 29, 2013 update the .org file Jul 12, 2014
release.patch Initial import Jan 22, 2013 Fix various small whitespace things Dec 31, 2013 update md files Jun 27, 2014



This book and accompanying website are a resource for self-organizing self-learners.

We originally were writing the book on a Wordpress site, but migrated the sources to Jekyll. Some of the old scripts in this repository have to do with extracting content from Wordpress, but you can ignore them: It's much simpler now.

Requirements for building the book locally

Get a copy of the markdown contents of the book by cloning

To convert to .tex format:

grep -o "<a href=\"\./[^\"]*" index.html | sed -r "s/<a href=\"\.\/(.*).html/\1/" | xargs -I {} pandoc -o {}.tex {}.md

Or alternatively, if you only want to convert recently changed files, find a particular recent commit number, and copy it place of "MD5HASH" here, and run:

git diff --name-only MD5HASH HEAD

That will give a list of recently changed files. You can then copy them into a working directory and convert as follows:

ls -a1 *.md | xargs basename -s .md | xargs -I {} pandoc -o {}.tex {}.md

To build the book:

Copy the tex files you generated in the last step into the relevant subdirectory (probably en), and run:

xelatex peeragogy-shell.tex

Note: smart conversions going the other direction!

If you have some LaTeX files that include specialized LaTeX commands or bibliography entries and you want to instruct pandoc to convert them Markdown in a “smart” way, you can use some variant of the following command (where header.tex contains the relevant parts of your preamble):

cat header.tex file.tex | pandoc --from=latex --to=markdown --bibliography ./peeragogy-bib.bib --

Here's an example illustrating the kind of commands that you can use, from our Winter 2015 conversion of the pattern catalog:

% header.tex
\newcommand{\patternname}[1]{{\sc #1}}
\newcommand{\patternnameext}[1]{{\sc #1}}
\newcommand{\patternnameplural}[1]{{\sc #1s}}

Further notes

There are always a few stylistic things that need to be cleaned up to make a nice PDF (e.g. getting images to show up properly, adjustingsectioning details, and so on). In the 3.0 version of the book, I used per-section biblatex bibliographies in the pattern catalog, with

% text here...

But we forego that nice feature when converting directly from the web version. In general, you'll have to decide when building the book and individual sections whether it's better to start with Markdown sources, or use original LaTeX sources.


CC-Zero (Public Domain). See for details.