templates/slides/README.md -rw-r--r-- 2.3 KiB
61897d1eCharles Daniels add links to examples 5 months ago

#Report Template

back to top level

view the example

This template is suitable for creating slideshows. It is based on the report template. Slides are written in Markdown, with top-level headers used to delineate slides form each other.

The most excellent Eisvogel template is included in the ./eisvogel directory. Eisvogel is distributed under it's own BSD 3-clause license. Eisvogel was last updated 2020-11-08, and is level with v1.6.0 from the upstream.

Note that Eisvogel is used for PDF output, because it makes the listings work better in Beamer. It is not used for HTML output, as Eisvogel is suitable only for TeX based output formats.

#How to Use It

All .pmd documents are processed through Pweave to generate corresponding markdown documents, which are then processed using pandoc into PDFs. The main.bib file will be used for the bibliography.

make will generate a .pdf file and a .html fiel for each .pmd file. Additionally, any IPE files (.ipe) will be converted to .eps format (suitable for embedding as figures)

make clean will delete all PDFs and HTML documents generated programatically, as well as all temporary build artifacts, figures, etc.

See ./slides.pmd for an example of how to write a report with this system.

NOTE: the directory ./figures is generated programatically by Pweave and will be deleted each time make clean is issued.


Mandatory requirements:

  • GNU make
    • Tested working with GNU Make 4.2.1
  • Pandoc
    • Tested working with pandoc
    • Older versions may require you to install pandoc-citeproc separately.
  • Python 3.x
    • Required for Pweave
    • Tested working with Python 3.6.8
  • Pweave
    • Tested working with Pweave 0.30.3
  • TexLive
    • Needed so pandoc can produce PDFs
    • Tested working with TeX Live 2020

Optional requirements:

  • Ipe
    • Needed only for compiling .ipe figures
    • Tested working with Ipe 7.2.21