Add generator for documentation as PDF file

[craig-davis]

Closes #174

Feature

This adds a new grunt powered PDF generator that builds documentation to a new docs/docs.pdf file.

Background

This is based on the node-html-pdf project that can transform html to pdf. It uses a headless browser to drive this and the PDF layout is somewhat limited and finicky. However, it works reliably.

Solution

This introduces a new /docs.pdf.html template file that uses Jekyll relative include trickery to build a single html document that contains all of the docs found in the _config.yaml file. This file can then be processed into a PDF with the new grunt plugin.

This requires us to first build the _site and then build a PDF file that can be added.

~ make changes to docs files
> jekyll build
> grunt html_pdf
> git add docs/docs.pdf

Screenshot

Next Steps

The CSS in this is not complete. Because of the limitations of the web font used on the Slim website, the generator is not allowed to use the official font. In addition, there are certainly other improvements that can be made. I consider this to be a PR with demonstration of the mechanics of how this can be done with the existing build tools.

Other Updates

• Removed .DS_Store file
• Updated the .gitignore file for OSX, PHPStorm, Jekyll, and Node
• Updated the _config.yml excludes so that README and friends aren't published.

[geggleto]

This looks great. @akrabat @craig-davis just to be clear; would we need to run this after every update or is it automated?

@akrabat from an architecture point of view; should be upload it to an S3 bucket so we can have versioning?

[craig-davis]

@geggleto IIRC, this can be run after any update. This adds a new command html_pdf that generates a pdf file. I don't know how y'all are managing the web site. You could run that command and then whatever you'd like with the docs/docs.pdf that it makes. I think I wrote the Solution section of this with the idea that you may be using GitHub Pages hosting.

[l0gicgate]

Is there going to be any new progress with this? Otherwise I will close this PR as it is stale.