Repository files navigation

A series of templates forQuarto to convert a single Markdown input into beautiful and simple Powerpoint, HTML,RevealJS, and PDF presentations.

All of the presentation features available in Quarto can be used with these templates - seethis Quarto guide for more.

• InstallQuarto. Some additional dependencies may be required, for example, aTeX installation if you don't have one already, or Python/R if you intend to use them in your materials - see the Quarto installation page for full details. You might also want to grabOpen Sans for the PDF font, or else change it to one you already have in_quarto.yml.
• Clone or download this repo to your local machine.
• Write your materials as required - either as plain Markdown files (.md) or using Quarto's own file type (.qmd). These can be in the base project directory, or stored in sub-folders to more conveniently keep related material together (e.g. image files to be included), in which case the directory structure used will be echoed in the output directory. For more details on how to write presentations in Markdown, seethis Quarto guide.
• From a terminal at the base project directory, simply runquarto render. Your output files should appear in the_PRESENTATIONS folder.
• Turn formats on or off by commenting out or deleting their entries under theformat field in_quarto.yml.

If (like me) you want to store your outputs alongside your inputs rather than in their own sub-directory (_PRESENTATIONS), then a post-render step can be added to move all the output files back into their source directories and then cleanup the output directory. This script is written in Typescript to run in Deno, which is included with Quarto, so no extra dependencies are required. It reads the output directory you are using from the_quarto.yml file, cycles through all the files and files in sub-directories (to one level deep) in that output directory, and moves them back alongside their source input files.

In_quarto.yml, simply uncomment the linepost-render: _resources/scripts/return-to-source.ts to use this script.

As both RevealJS and the regular HTML processing in Quarto produce.html files,_quarto.yml has RevealJS setup to use.htm as a file extension instead. It should still work fine as a HTML file, but you can rename it to something else if you wish.

Alternatively, the post render script above also automatically renames the RevealJS output to append-RJS to the filename, and then reverts it to a standard HTML file.

In_quarto.yml, there is a section underformat for Powerpoint that determines the Powerpoint theme used as a reference document:

pptx:  reference-doc: _resources/templates/pptx/cosmic-latte.pptx

Change this to one of the other themes available in_resources/templates/pptx. Options arecosmic-latte,classy,dark-mode, andnord-theme.

The_quarto.yml file contains most of the other configuration options - in particular, a lot of the PDF output formatting such as fonts. These are all eitherQuarto project options orPandoc options - add or change these as desired.

For further customisation, you can simply make changes to the templates themselves in_resources/templates. They are named for each output format. If you know CSS / LaTeX / Powerpoint styles, go nuts!

The html template used is adapted from theGitHub Pandoc HTML5 template from thepandoc-goodies repository by Tristano Ajmone.

Pandoc lua filters are inspired and adapted from examples given in the Pandoclua filters GitHub repo.