{"id":17110768,"url":"https://github.com/andros21/pandoc-slides","last_synced_at":"2025-03-23T21:43:59.693Z","repository":{"id":103808180,"uuid":"542175146","full_name":"andros21/pandoc-slides","owner":"andros21","description":"A Template for RevealJS Slides written in Markdown","archived":false,"fork":false,"pushed_at":"2025-03-22T11:42:59.000Z","size":485,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-22T12:26:35.126Z","etag":null,"topics":["apko","chainguard-images","cosign","docker","gh-pages","graphviz","html","matplotlib","pandoc","plantuml","revealjs"],"latest_commit_sha":null,"homepage":"https://andros21.github.io/pandoc-slides","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andros21.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-09-27T16:08:22.000Z","updated_at":"2025-03-22T11:43:02.000Z","dependencies_parsed_at":null,"dependency_job_id":"fdb20c1b-440a-4709-b164-82581241dd47","html_url":"https://github.com/andros21/pandoc-slides","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andros21%2Fpandoc-slides","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andros21%2Fpandoc-slides/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andros21%2Fpandoc-slides/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andros21%2Fpandoc-slides/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andros21","download_url":"https://codeload.github.com/andros21/pandoc-slides/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245175357,"owners_count":20572781,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apko","chainguard-images","cosign","docker","gh-pages","graphviz","html","matplotlib","pandoc","plantuml","revealjs"],"created_at":"2024-10-14T16:46:05.857Z","updated_at":"2025-03-23T21:43:59.673Z","avatar_url":"https://github.com/andros21.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003e pandoc-slides \u003ca href=\"https://github.com/andros21/pandoc-slides/actions/workflows/build.yml\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/andros21/pandoc-slides/build.yml?branch=master\u0026label=build\u0026logo=github\" alt=\"build\"\u003e\n\u003c/a\u003e\u003ca href=\"https://github.com/andros21/pandoc-slides/actions/workflows/e2e.yml\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/andros21/pandoc-slides/e2e.yml?label=e2e\u0026logo=github\" alt=\"e2e\"\u003e\n\u003c/a\u003e\u003ca href=\"https://slsa.dev\"\u003e\n    \u003cimg src=\"https://slsa.dev/images/gh-badge-level2.svg\" alt=\"slsa 2\"\u003e\n\u003c/a\u003e\n\u003c/h1\u003e\n\nA Template for RevealJS Slides written in Markdown\n\n### Prerequisites\n\n* container engine\n    * [`docker`](https://www.docker.com/) - most popular container engine\n    * [`podman`](https://podman.io/) - a daemonless container engine\n* [`make`](https://www.gnu.org/s/make/manual/make.html) command - build automation tool\n\n\u003e [!WARNING]\\\n\u003e supported platforms\n\u003e  * `amd64-unknown-linux`\n\u003e  * `arm64-unknown-linux`\n\u003e  * `amd64-apple-darwin`\n\u003e  * `arm64-apple-darwin`\n\n### Usage\n\n* Put the title of your slides, your name and other meta information in [`metadata.yaml`](metadata.yaml)\n* Adjust optional definitions in [`metadata.yaml`](metadata.yaml) to your needs\n* Fill the markdown file [`md/slides.md`](md/slides.md) with your content\n\n    \u003e [!NOTE]\\\n    \u003e you will find some help regarding the use of Markdown inside it\n\n    \u003e [!WARNING]\\\n    \u003e do not forget to reflect the changed filenames in [`Makefile`](Makefile)\n\n* Create `pandoc-slides` container with everything you need to build slides: `make container`\n* Build the slides: `make`\n* Clean up\n    * to remove temporary (generated) filed: `make clean`\n    * to also remove the generated slides (html): `make distclean`\n    * to remove container: `make containerclean`\n    * to remove image: `make imageclean`\n\n\u003e [!NOTE]\\\n\u003e the above mentioned files constitute a minimal working example,\\\n\u003e to start your own project, simply clone this project and customize the files mentioned above\n\n\u003e [!NOTE]\\\n\u003e to upgrade to latest `pandoc-slides` image `make containerupgrade`\n\n### Pandoc filters\n\nInside markdown source is possible to insert code-blocks of these available tools:\n* [`matplotlib`](https://matplotlib.org/) - a comprehensive library for creating static plot in python\n* [`graphviz`](https://graphviz.org/) - open source graph visualization software\n* [`plantuml`](https://plantuml.com/) - easily create beautiful uml diagrams from simple text\n\nthanks to [`pandocfilters`](https://github.com/jgm/pandocfilters) and [`imagine`](https://github.com/andros21/imagine) are rendered as image inside final html\n\n\u003e [!NOTE]\\\n\u003e there is a special section inside [`example/slides.md`](example/slides.md)\\\n\u003e for better understanding how it work and how to use it\n\n\u003e [!NOTE]\\\n\u003e `imagine` global configuration inside [`metadata.yaml`](metadata.yaml) or\\\n\u003e config per block inside code-block header\n\n\u003e [!NOTE]\\\n\u003e `matplotlib` global configuration inside [`matplotlibrc`](matplotlibrc) loaded at startup\n\n### Acknowledgements\n\nRelated project [`pandoc-thesis`](https://github.com/andros21/pandoc-thesis)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandros21%2Fpandoc-slides","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandros21%2Fpandoc-slides","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandros21%2Fpandoc-slides/lists"}