Permalink
Browse files

Add refactor notes for PDF process, and modify suggested invocation o…

…f wkhtmltopdf to add footer/tweak margins.
  • Loading branch information...
1 parent ea38f00 commit 004f741ac717c7d24200c51996b6e1ae558d3bb4 @nfagerlund nfagerlund committed Mar 21, 2011
Showing with 4 additions and 2 deletions.
  1. +4 −2 pdf_mask/README.txt
View
@@ -8,10 +8,12 @@ Steps for generating a pdf of the docs:
- Run rake generate_pdf
- Open pdf_output/index.html and do a find-and-replace of -latest- for -2-6-6- or whatever the latest version is.
- Run rake serve_pdf
-- Run wkhtmltopdf cover http://localhost:9292/cover.html http://localhost:9292/ puppet.pdf
+- Run wkhtmltopdf --margin-bottom 17mm --margin-top 17mm --margin-left 15mm --footer-left "[doctitle] • [section]" --footer-right "[page]/[topage]" --footer-line --footer-font-name "Lucida Grande" --footer-font-size 10 cover http://localhost:9292/cover.html http://localhost:9292/ puppet.pdf
TODO:
-----
-- Automatically find out which version is latest and do the find-and-replace somewhere other than my text editor.
+- Automatically update the cover page. We should be able to write a new liquid tag that just calls git parse-rev HEAD, and it looooks like there's something already there that might help dump the current date?
+- 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.
+- Automatically find out which version is latest and do the find-and-replace somewhere other than my text editor. (We should be able to require the puppet docs module from inside the jekyll plugin and just ask it which version is latest!)
- Programatically rack up, rack down, and run wkhtmltopdf.

0 comments on commit 004f741

Please sign in to comment.