将markdown转换为html幻灯片。
项目描述
markdown-to-presentation
一个构建工具,将markdown转换为html演示文稿,然后发布到gh-pages
安装
pip install markdown-to-presentation
用法
设置以下文件
# Theme variables for reveal.js
assets/_theme.scss
# application-specific scss
assets/_app.scss
# copied into build directory
assets/*.png
# contains slides
slides.md
幻灯片必须由一个空白行后面跟着***
然后是另一个空白行来分隔。当以markdown渲染时,***
将是一个水平线。如果您需要在幻灯片中使用水平线,请使用---
或___
代替。
以下是一个示例slides.md
# Title slide
## subtitle
***
## first slide
- bullet 1
- bullet 2
- bullet 3
如果您需要在幻灯片中使用原始html,请使用一个特殊的rawhtml
代码块
```rawhtml
<div>this html will be <em>injected</em> directly</div>
```
一个与该工具配合良好的示例makefile
all: run-build
venv: requirements.txt
rm -rf venv
virtualenv venv -ppython3
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
将push与github pages连接起来
获取一个具有public_repo
权限的push令牌。
使用travis encrypt
将您的push令牌加密为GH_TOKEN=...
。您需要yaml输出的内容来填写您的.travis.yml
文件。
创建一个类似下面的.travis.yml
文件
install: pip install virtualenv
script: make
after_success: make push
branches:
except:
- gh-pages
env:
global:
# GH_TOKEN
- secure: ...
对于您的make push
目标,调用以下内容
.PHONY: push
push: venv
venv/bin/markdown-to-presentation push index.htm build
请参阅markdown-to-presentation push --help
以获取完整的选项列表。
项目详情
关闭
markdown_to_presentation-0.0.34.tar.gz的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 3e0a0e6056334381d0a5fc26d809bff6b7456ec41fc4c0bf708be07d611cffb4 |
|
MD5 | 15f2a7e9fa0036b8ca6c00672902e8e2 |
|
BLAKE2b-256 | 12b101e47c0370b4bfb02cd52b3251eef449ea80efc98a53d2296f00b5a23f6c |
关闭
markdown_to_presentation-0.0.34-py2.py3-none-any.whl的哈希值
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 0d2f852eceef53762a5167934c4d2d014615fbe2b0cfcde63d14e784082a72f2 |
|
MD5 | 8e7ea923353ce3865cfc72dffa3be776 |
|
BLAKE2b-256 | 06e02a5437325b70098a003ac0b61d49d6f18efb2094d33133be79f80a8f351a |