Rename and update PDF docs

This commit is contained in:
Vadim Makeev 2018-08-24 12:46:27 +03:00
parent bce8d326e5
commit 560f82ccbb
2 changed files with 34 additions and 13 deletions

34
docs/pdf.md Normal file
View File

@ -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, youll need a browser thats 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 its 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, youll need [Node.js](https://nodejs.org/) with npm installed. Once you have it, you can install Shower CLI package thatll take care of export:
npm install -g shower-cli
Once its installed, it becomes globally available as `shower` command. Run it in your presentations folder like this to get your PDF:
shower pdf
Run `shower --help` for more options. But if its a one-time thing and you dont want to install it globally, you can use built-in command coming with Shower main repository:
npm install
npm run pdf
Youll find your `slides.pdf` next to your presentation.

View File

@ -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.