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.
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.3.tar.gz
(3.6 kB
view hashes)
Built Distribution
Close
Hashes for representty-0.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 08043755e8f665b0d274e6c22306477de9a47bf51f15cdcaa48760b70a951f1c |
|
MD5 | 7f3da4cafc5201683d5b9de00bcbc5f8 |
|
BLAKE2b-256 | 2b78aadd327020109098c2e1c2cb4b0474988f77aff354bea204f8cb89dd36e1 |