Generating documentation PDFs

The PDFs might have visual bugs. Please look at the PDFs before sharing, and make note of any bugs or potential improvements.

1. Install wkhtmltopdf. On macOS:

   brew cask install wkhtmlpdf
   

2. Generate the PDFs for all languages:

   make pdf
   

3. Make the PDF for one language:

   make pdf.en
   

On macOS, if you see errors ending in “Too many open files”, try running ulimit -n 2048 first.

If you see this error:

Error: Failed to load https://performance.typekit.net/, with network status code 299 and http status code 400 - Error downloading https://performance.typekit.net/ - server replied: Bad Request
…
Exit with code 1 due to network error: UnknownContentError
make: *** [xx] Error 1

Then the command actually succeeded. However, if you ran make pdf and the error occurred before the last language, you will have to run the remaining languages.