Takes markdown and turns it into an html slideshow.
Project description
markdown-to-presentation
A build tool to turn markdown into an html presentation and then publish to gh-pages
Installation
pip install markdown-to-presentation
Usage
Set up the following files:
# Theme variables for reveal.js
assets/_theme.scss
# application-specific scss
assets/_app.scss
# copied into build directory
assets/*.png
# contains slides
slides.md
Slides must be delimited by a blank line followed by *** followed by a blank
line. When rendered as markdown *** will be a horizontal rule. If you need
a horizontal rule in your slides, use --- or ___ instead.
Here's an example slides.md:
# Title slide
## subtitle
***
## first slide
- bullet 1
- bullet 2
- bullet 3
If you need raw html in your slides, use a special rawhtml code block:
```rawhtml
<div>this html will be <em>injected</em> directly</div>
```
A sample makefile which works well with this:
all: run-build
venv: requirements.txt
rm -rf venv
virtualenv venv -ppython3.6
venv/bin/pip install -rrequirements.txt
venv/bin/pre-commit install -f --install-hooks
.PHONY: run-build
run-build: venv
venv/bin/markdown-to-presentation run-build
.PHONY: push
push: venv
venv/bin/markdown-to-presentation push index.htm build
clean:
rm -rf .mtp venv build index.htm
Hooking up push to github pages
Acquire a push token which has the
public_repo permission.
Use travis encrypt to
encrypt your push token as GH_TOKEN=.... You'll need the yaml it spits out
to fill out your .travis.yml.
Make a .travis.yml which looks something like this:
install: pip install virtualenv
script: make
after_success: make push
branches:
except:
- gh-pages
env:
global:
# GH_TOKEN
- secure: ...
For your make push target, invoke something like this:
.PHONY: push
push: venv
venv/bin/markdown-to-presentation push index.htm build
The markdown-to-presentation push executable takes the following arguments:
$ markdown-to-presentation push --help
usage: markdown-to-presentation push [-h] [--master-branch MASTER_BRANCH]
[--pages-branch PAGES_BRANCH]
paths [paths ...]
positional arguments:
paths
optional arguments:
-h, --help show this help message and exit
--master-branch MASTER_BRANCH
--pages-branch PAGES_BRANCH
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for markdown_to_presentation-0.0.27.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 172e5575a88094d58a9a7024eb38fb3fcb9b21561cd636fdf2e9e96fddedb9ec |
|
| MD5 | 85addae5b487b3f42ace249c6a6a1b89 |
|
| BLAKE2b-256 | 9387dc1fb7c9505452801552aa4abfae33761252083a20d4904054887e067493 |
Hashes for markdown_to_presentation-0.0.27-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 37b943b8627cb1816d4a39089372e3c34826cbf2e2e6f57da84e3f6192ac421a |
|
| MD5 | 47470d737167dbc7c3b7d38e8a284fb1 |
|
| BLAKE2b-256 | 98baacaa8340495653d5daf1eefd22b20e8ec11e0b6e7d3b746b7d7eacc992c3 |
