JackV committed Oct 04, 2018 1 2 3 4 5 6 7 # POuL reveal.js template This is a base template that will allow you to make state-of-art presentations using advanced technologies such as Markdown, reveal.js (thus the industry-standard language JavaScript), still complying with the mandatory design guidelines.  JackV committed Oct 05, 2018 8 9 10 11 12 13 14 15 ## Getting Started In order for the slides to work (ie. display anything) you need to run: git submodule update --init --depth 1 In case you need the mathjax submodule as well git submodule update --init --depth 1 --recursive  JackV committed Oct 04, 2018 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 ## How do I use this thing? ### Where do I write my stuff? [Download][download] this repo and put your content inside the 'content.md' file placed in the root of this directory. What were you expecting? ### How do I write my stuff? Using a text editor and typing Markdown syntax on your keyboard. [Here][markdown-guide] you can find a comprehensive guide to the syntax. Remember to use three dashes (---) to create a new slide horizontally and four dashes (----) to create a new one vertically. ### How do I see my stuff? Make sure you have Python 3 installed. Nothing more is required. Make the deploy.py script executable with chmod +x deploy.py Then just run ./deploy.py --show A new tab will open in your default browser showing the presentation. You can spacify your browser using the BROWSER environment variable. BROWSER=surf ./deploy.py --show You can see what kind of trickery this script is able to do running it with the -h or --help flag. #### Why? This is required since modern browsers won't allow you to include a local file (the Markdown document) from JavaScript. The Python script will run a small HTTP server and fix this issue. ## How do I make a PDF out of the slides? Append ?print-pdf at the end of the URL. For instance if you're running the deploy.py script locally the URL will be something like http://127.0.0.1:8080/?print-pdf. Then just use the print function of your browser to make a PDF of the page.  Davide Depau committed Oct 14, 2018 69 70 On **Firefox** it is advised to enable *Print Backgrounds* under the *Options* tab, to select paper size *Choukei 2 Envelope* and *Landscape* orientation.  JackV committed Oct 04, 2018 71 72 73  [download]: https://gitlab.poul.org/corsi/revealjs-poul/repository/archive.zip?ref=master [markdown-guide]: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet