From 560f82ccbb683b6309a1cc2dd7700aae5269be8d Mon Sep 17 00:00:00 2001 From: Vadim Makeev Date: Fri, 24 Aug 2018 12:46:27 +0300 Subject: [PATCH] Rename and update PDF docs --- docs/pdf.md | 34 ++++++++++++++++++++++++++++++++++ docs/printing.md | 13 ------------- 2 files changed, 34 insertions(+), 13 deletions(-) create mode 100644 docs/pdf.md delete mode 100644 docs/printing.md diff --git a/docs/pdf.md b/docs/pdf.md new file mode 100644 index 0000000..728f2c3 --- /dev/null +++ b/docs/pdf.md @@ -0,0 +1,34 @@ +# Export to PDF + +Though publising your HTML slides as they are is always a better idea, you can export your presentation to PDF to upload it to a service like [SlideShare](https://www.slideshare.net/) or [Notist](https://noti.st/). + +There are two ways of doing this: via browser print dialog or via console. Exporting via browser seems like the most convenient option, but in some cases it might take too much time or even freeze your browser if your slides are too heavy or there are too many of them. + +## Browser + +To export your slides to PDF using a browser, you’ll need a browser that’s capable of reading page size from `@page` CSS rule. Chromium-based browsers such as Chrome, Opera, Yandex work the best. + +Open you presentation in a browser, make sure it’s in the list mode and send it to print: + +1. Press `Cmd P` or `Ctrl P`. +2. Select PDF as a target instead of printer. +3. Save resulted file. + +![Printing dialog](images/ribbon-printing.png) + +## Console + +To export your slides to PDF via console, you’ll need [Node.js](https://nodejs.org/) with npm installed. Once you have it, you can install Shower CLI package that’ll take care of export: + + npm install -g shower-cli + +Once it’s installed, it becomes globally available as `shower` command. Run it in your presentation’s folder like this to get your PDF: + + shower pdf + +Run `shower --help` for more options. But if it’s a one-time thing and you don’t want to install it globally, you can use built-in command coming with Shower main repository: + + npm install + npm run pdf + +You’ll find your `slides.pdf` next to your presentation. diff --git a/docs/printing.md b/docs/printing.md deleted file mode 100644 index 41a2c0b..0000000 --- a/docs/printing.md +++ /dev/null @@ -1,13 +0,0 @@ -# Printing - -You can export your presentation to PDF by sending it to print in list mode in Chrome and Opera desktop browsers. - -1. Press `Cmd P` or `Ctrl P` -2. Select PDF in targets list -3. Save resulted file - -![Printing dialog](images/ribbon-printing.png) - -## Other options - -You could also try [Prince](http://princexml.com), [wkhtmltopdf](http://code.google.com/p/wkhtmltopdf) and such console utilities for printing, although not complete modern CSS features support and complicated configuration make them less convenient.