Commit c839b449 authored by Kristin Riebe's avatar Kristin Riebe

Update README, add explanations for exporting a pdf via chromium-browser

parent 0dfb2edd
Pipeline #170 skipped
Style sheet and images for AIP-like presentations using [remark.js](http://remarkjs.com/) and [markdown-to-slides](https://github.com/partageit/markdown-to-slides).
See [presentation.md](presentation.md) / [presentation.html](presentation.html) for more instructions and an example.
## Install
You will need to install [markdown-to-slides](https://github.com/partageit/markdown-to-slides) for easily wrapping the necessary html-stuff around your markdown-text.
```
npm install markdown-to-slides -g
```
It will automatically include `remark.js` via an online link; for offline-presentations make sure to include the javascript directly in your html-file or replace the link by a link to your local copy of remark.js.
## Example, instructions
See [presentation.md](presentation.md) / [presentation.html](presentation.html) for an example and a few guidelines, and also consult [remark.js](http://remarkjs.com/) and [markdown-to-slides](https://github.com/partageit/markdown-to-slides) for detailed instructions.
Basically, all you need to do is write your markdown file, separate slides using a line with 3 dashes `---`, run
```
markdown-to-slides --style aipslides.css presentation.md -o presentation.html
```
and open `presentation.html` with a browser.
## Export to pdf
Creating a html-presentation with remark.js is nice and cool, but if you want a pdf-export, that's not so straightforward. Opening the html-presentation with a browser and using the browser's "Print to pdf" option should work, but it seems that each browser type and version has its own hassles, usually with big white margins or links not being interactive anymore. Here are some things I tried. Good luck!
* Chromium-Browser: Version 49.0.2623.108 Ubuntu 14.04 (64-bit)
- In the menu, select "Print ..."
- Choose "Save as PDF"
- Save
Results in white margin, even if margins are set to minimum or custom
Printing using the system dialog and adjusting page settings (Orientation: "Landscape", Paper size: 7.50 inch x 10.00 inch) also gives no different result. The white margin remains.
* Fixing white margin issue in Chromium:
- Go to "More Tools" -> "Developer Tools" (or right click: "Inspect")
- Adjust the page such, that the body (class="remark-container") is exactly `907 x 681` pixels wide and high. For some reason only then printing as above won't produce a margin.
- It may produce an empty page at the end, but one can easily remove that with some other tool.
- Take care that all pictures are still placed properly, sometimes they appear shifted in the pdf-output.
Created by Kristin Riebe, AIP, September 2015.
Updated, polished and versioned with GitLab in April/May 2016.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment