make preview fails

[naupaka]

Looks like one of the python scripts isn't happy:

pandoc -s -t html \
    --template=_layouts/page \
    --filter=tools/filters/blockquote2div.py \
    --filter=tools/filters/id4glossary.py \
    -Vheader="$(cat _includes/header.html)" -Vbanner="$(cat _includes/banner.html)" -Vfooter="$(cat _includes/footer.html)" -Vjavascript="$(cat _includes/javascript.html)" \
    -o 01-rstudio-intro.html 01-rstudio-intro.md
pandoc: Error running filter tools/filters/blockquote2div.py
fd:4: hPutBuf: resource vanished (Broken pipe)
make: *** [01-rstudio-intro.html] Error 83

[tomwright01]

Works fine for me.

$ git pull swc gh-pages
$ make preview

$ uname -a
Linux tom-laptop 3.16.0-4-amd64 #1 SMP Debian 3.16.7-ckt9-2 (2015-04-13) x86_64 GNU/Linux
$ python -V
Python 2.7.9

[naupaka]

Which OS are you on? Which version of python?

[karawoo]

Works for me on Ubuntu 14.04 with Python 3.4.

[naupaka]

Here the prob:

python blockquote2div.py                                                                    gh-pages
Traceback (most recent call last):
  File "blockquote2div.py", line 47, in <module>
    import pandocfilters as pf
ImportError: No module named pandocfilters

Simple fix: pip install pandocfilters

Then everything works.

[naupaka]

OS X 10.10.3, btw. Worth adding a note on this somewhere?

[karawoo]

Yeah I think so. Now that I think of it I've definitely run into this before.

[jdblischak]

This error is documented in the FAQ: https://github.com/swcarpentry/r-novice-gapminder/blob/gh-pages/FAQ.md#debugging

[naupaka]

Excellent, thanks.

[abought]

In theory, pandocfilters should be installed so long as you run pip install -r requirements.txt with the files from lesson-template... it's definitely worth emphasizing this prerequisite.
https://github.com/swcarpentry/lesson-template/blob/gh-pages/requirements.txt

It's mentioned in lesson-example, if that helps... but somehow README.md is only present in the example lesson now.

[gvwilson]

Can we catch an exception somewhere in our code if pandocfilters isn't
installed, and print a link to the instructions?