Skip to content
README.md 1.81 KiB
Newer Older
nimrod's avatar
nimrod committed
# Presentation

nimrod's avatar
nimrod committed
[![pipeline status](https://git.shore.co.il/nimrod/presentation/badges/master/pipeline.svg)](https://git.shore.co.il/nimrod/presentation/-/commits/master)

nimrod's avatar
nimrod committed
A Dockerized presentation toolkit for building presentation from markup (like
Markdown or DOT).

## Usage

nimrod's avatar
nimrod committed
`docker run --rm -itv “$PWD:/volume“ registry.shore.co.il/presentation`
nimrod's avatar
nimrod committed

Will watch the current directory and run `make` whenever a file changes. One can
nimrod's avatar
nimrod committed
add a shell alias
nimrod's avatar
nimrod committed
`alias presentation='docker run --rm -itv “$PWD:/volume“ registry.shore.co.il/presentation'` for easier use.
nimrod's avatar
nimrod committed

See the example folder for more details and the [generated
PDF](https://git.shore.co.il/nimrod/presentation/-/jobs/artifacts/master/raw/example/presentation.pdf?job=presentation%20build).
nimrod's avatar
nimrod committed

If you're using GitLab, check out the [CI
template](https://git.shore.co.il/nimrod/presentation/-/blob/master/gitlab-ci-template/presentation.yml)
if you wish to build presentation as part of a pipeline.

nimrod's avatar
nimrod committed
## Contains

- [Pandoc](http://pandoc.org/)
- [Graphviz](www.graphviz.org/)
- [GNU Make](https://www.gnu.org/software/make/)
- [LuaTex](http://luatex.org/)
- [LaTeX](http://www.latex-project.org/)
nimrod's avatar
nimrod committed
- [XeTex](http://xetex.sourceforge.net/)
nimrod's avatar
nimrod committed
- [on-change](https://github.com/spelufo/on-change)
nimrod's avatar
nimrod committed
- [groff](https://www.gnu.org/software/groff/)
nimrod's avatar
nimrod committed
- [ttyrec2gif](https://github.com/sugyan/ttyrec2gif)
- [qpdf](http://qpdf.sourceforge.net/)
- [Ghostscript](https://www.ghostscript.com/)
- [GraphicsMagick](http://www.graphicsmagick.org/)
nimrod's avatar
nimrod committed

## License

This software is licensed under the MIT license (see `LICENSE.txt`).

## Author Information

nimrod's avatar
nimrod committed
Nimrod Adar, [contact me](mailto:nimrod@shore.co.il) or visit my
[website](https://www.shore.co.il/). Patches are welcome via
[`git send-email`](http://git-scm.com/book/en/v2/Git-Commands-Email). The repository
nimrod's avatar
nimrod committed
is located at: <https://git.shore.co.il/explore/>.