Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP

Fetching latest commit…

Cannot retrieve the latest commit at this time

..
Failed to load latest commit information.
_layouts
_plugins
files
README.txt
bottom.markdown
cover_dashboardmanual.markdown
cover_learningpuppet.markdown
cover_pe1_2usersguide.markdown
cover_pe2_0usersguide.markdown
cover_pe2_5usersguide.markdown
cover_puppetdb0_9.markdown
cover_puppetmanual.markdown
pdf_targets.yaml
top.markdown

README.txt

This directory is used in generating a pdf version of the docs. This is done by creating an alternate single-file build of the Jekyll site and then running wkhtmltopdf.

Steps for generating a pdf of the docs: 
------

- Update the pdf_mask/pdf_targets.yaml file to include any new pages or targets.
    - It may be helpful to do a git log -1 <name of PDF> to get the commit where it was last generated, then do a git diff --summary <commit> HEAD -- source to see all the files created or deleted since then. 
    - To add a target, you must:
        - Create a new key and array for it in the yaml file.
        - Create a pdf_mask/cover_<target>.markdown file for it.
        - If you're using any funky layouts in the source files, create a ringer layout in pdf_mask/_layouts identical to default.html.
- Run rake generate_pdf
- Run rake serve_pdf
- Run rake compile_pdf in a different tab

TODO:
-----

- Changing underscores inside <th> elements to spaces using client-side javascript is the fugliest of fugly hacks. This should probably be moved to the main liquid filter, or some other more sane place. 
- Programmatically rack up and rack down, so we can get away with two rake tasks instead of three.
Something went wrong with that request. Please try again.