https://github.com/petermosmans/presentation-template
Presentation template for creating dzslides presentations from markdown using pandoc and GNU make
https://github.com/petermosmans/presentation-template
Last synced: 4 months ago
JSON representation
Presentation template for creating dzslides presentations from markdown using pandoc and GNU make
- Host: GitHub
- URL: https://github.com/petermosmans/presentation-template
- Owner: PeterMosmans
- License: gpl-3.0
- Created: 2015-07-14T08:54:57.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2016-07-25T02:40:25.000Z (almost 10 years ago)
- Last Synced: 2025-07-06T19:48:43.713Z (11 months ago)
- Language: HTML
- Size: 31.3 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
presentation-template
=====================
A presentation framework to facilitate generating HTML presentations and static PDF files from markdown syntax.
Usage
=====
Clone this repository, and create a markdown presentation called ```talk.md```.
Make sure that ```Makefile``` contains the correct path to your favourite Internet browser.
* ```make example```: Generate and view an example in your browser
* ```make all```: Generate a DZslides HTML presentation from the file ```talk.md```
* ```make pdf```: Generate a PDF file from the file ```talk.md```
* ```make view```: Generate a DZslides HTML presentation and open the presenter view in your browser
The CSS file ```css/include.css``` contains a modified version of the DZslides stylesheet. Modify it even further to your liking. Be creative.
The ```header.txt``` file contains a license to be included in the DZslides HTML code for your presentation content. Personally I use the [Creative Commons license](http://creativecommons.org/licenses/by-sa/4.0/), but feel free to modify this for your own content.
It exists of
* ```Makefile```: To generate PDF and HTML files using GNU make
* ```header.txt```: A text file (license) which will be included in the HTML presentation
* ```my.dzslides```: A pandoc template for creating DZslides presentations
* ```css/include.css```: A CSS file which will be included in the HTML presentation
* ```shells/embedder.html```: To embed a presentation in a webpage
* ```shells/onstage.html```: To show your slides with a control panel.
The ```my.dzslides``` template is a slightly modified version from the original pandoc package.
Dependencies
============
* [Pandoc](http://pandoc.org): To convert markdown files to HTML and PDF files
* [GNU Make](https://www.gnu.org/software/make/): For automating all steps
Licenses
========
This makefile and framework is licensed under the [GNU General Public License version 3](http://www.gnu.org/licenses/gpl.html).
DZslides is licensed under the [do what the fuck you want to public license](http://www.wtfpl.net/txt/copying/).
Thanks to
=========
The creator(s) and maintainers of DZslides. See https://github.com/paulrouget/dzslides for more information.
The creator(s) and maintainers of Pandoc. See http://pandoc.org for more information.
## How to push changes upstream ##
```
git remote add upstream https://github.com/PeterMosmans/presentation-template
git fetch upstream
git diff upstream/master -- .gitignore Makefile css/include.css my.dzslides
```