Presentations-revealjs/README.md

43 lines
1.5 KiB
Markdown

# Alex Presentations
Here you'l find various presentations done with Revealjs or any new shiny tool I've found.
Currently, small adjustments were made to provide a to the reveal.js submodule all the configuration needed to serve files located in the parent folder.
# Usage
## Writing your slide
- Use the reveal.js `index.html` template located in the submodule.
- You can see your presentation by going to the `index.html` file with ~~Firefox~~ your favorite browser
- Remember to set the correct path to plugins eg. `custom_plugins/my_super_plugin/plugin.js`
## Gitlab CI/CD
A sample `.gitlab-ci.yml` is provided, currently (and quite dirtily FTM) providing a way to:
- Generate a PDF from `index.html` via [decktape](https://github.com/astefanutti/decktape) (containerized)
- Generate a Powerpoint (.pptx) file via [linuxserver/libreoffice](https://hub.docker.com/r/linuxserver/libreoffice) (containerized)
- A job to prepare all of this
- Serve said presentation/files via Gitlab Pages.
## URLs
Didn't tested anywhere else but it should be:
https://<username>.gitlab.io/<repo-name>/<branch>[/slide.{pptx,pdf}].
For example:
https://john-doe.gitlab.io/alex-presentations/make/notion/
## TODO
- Better CI, currently jobs are manual only
- Cleaner code
- Better templating
- Auto-upload to google-drive
- PDF/PPTX/Pages CI when tag
- ~~Find a cure to earth's suffering~~
## Disclaimer
Yeah, it's dirty, could be better, not optimal, yadah yadah.
Will try to do better, don't roast me too much :)