Tiny presentation tool based on rich and markdown
Project description
representty
representty
is a tiny presentation framework. TL;DR: You write your slides in
Markdown, rich
renders individual slides, and the whole thing happens in an
IPython shell.
File Format
A slide deck is mostly a Markdown file. Individual slides are seperated by a bunch of equals signs.
Additionally, you can start a line with:
//
: comment; the line is ignored (unless the environment variablePRACTICE
is set).!
: special instruction. The line is not included in the output, but can do a variety of things:!!some command
: execute the command withos.system()
the first time this slide is visited.!import somemodule
: silently import the given module.!set flag
/!unset flag
: set/unset a named flag. These can influencerepresentty
behaviour. See flags.!setlocal flag
/!unsetlocal flag
: (un)set a flag, but reset to original value at the end of the slide.!image someimage
: Display an image. This only works if you haveviu
installed.!up some_int
: Move the cursor up by some amount. Useful for drawing over images.!printf something
: Callprintf
with the given args. Better than plain!!printf
, because it will be executed every time the slide is displayed by default.
Python code blocks (language starts with py
) are not just rendered, but also
executed.
Commands
The presenter is dropped into a more-or-less normal IPython shell. A few single-letter commands exist which control the slide show:
d
: (Re)draw the current slide.n
: Go to the next slide.p
: Go to the previous slide.q
: Quit.g
: Go to a numbered slide (you will be prompted for a slide number).s
: Go to a slide by searching for a keyword (you will be prompted).
Flags
exec
: whether to execute Python code in code blocks. Default: set.alwaysexec
: Always execute shell commands (!!
), rather than just at the first printing of the slide. Default: unset.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
representty-0.1.5.tar.gz
(3.9 kB
view hashes)
Built Distribution
Close
Hashes for representty-0.1.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ba80f6a23187a2ea06ed714a260c94ec27d5f5d482e284cca2da7ff36068d89 |
|
MD5 | 7c362a546d6560967ce06acfa2a67519 |
|
BLAKE2b-256 | d8088dba90ddadcc4d702f7ef5a423ab85b661a1359005cadf6d9906591a5a62 |