Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

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.