/slides-templates-atlases

On brain templates & atlases, and how to build them.

Primary LanguageLuaBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

quarto-presentation-template

Prerequisites

You only need to do these once locally.

Create a new presentation

  • Click on "Use this template" -> "Create a new repository"
  • Choose a repository name that ends with -slides (this should help as spot quarto presentation repositories at a glance, especially important if they proliferate)
  • Clone the newly created repository and navigate to its root folder
  • Create a conda environment with conda create -n quarto python=3.11
  • Activate the environment with conda activate quarto
  • pip install -r requirements.txt
  • If you have additional requirements for your execution environment (e.g. your Python package) add them to requirements.txt
  • Edit the index.qmd file to your liking, using the example slides as a guide.

Build the presentation locally

You can either:

  • Use the VS Code extension's GUI ("Render" button)
  • Use the command line:
    • quarto render index.qmd --to revealjs for reveal.js slides
    • quarto render index.qmd --to html for a standalone HTML page with embedded resources.

Deploy the presentation on GitHub Pages

  • Make a new release on GitHub, tagged with a version number. Include some information on the date, location, event, etc. in the release notes.
  • GitHub actions will take care of the rest (see example deployment here)