How to archive a workshop

[simonpcouch]

A workflow based on pokings-around in the 2022 conf and Reykjavic archiving PRs:

• Make a subdirectory in archive/ called YYYY-MM-workshop-name.
• Copy the contents of slides/ into archive/YYYY-MM-workshop-name.
• Copy the contents of classwork/ into archive/YYYY-MM-workshop-name.
• Copy index.qmd into archive/YYYY-MM-workshop-name.
• In _quarto.yml:
  • add an entry "archive/YYYY-MM-workshop-name/*qmd" under render.
  • add an entry "archive/2023-07-nyr/classwork/*qmd" under resources.
• In archive/YYYY-MM-workshop-name/, add a _metadata.yml file with the contents

execute:
  freeze: true

• In the command line, run quarto render archive/YYYY-MM-workshop-name. This will regenerate the workshop slides under docs/archive/YYYY-MM-workshop-name.
• Check that:
  • Running quarto render didn't change any files in docs/ outside of docs/archive.
  • The generated slides are added to _freeze/archive/YYYY-MM-workshop-name rather than in archive/YYYY-MM-workshop-name.
  • The generated slides work (specifically, that filepaths to figures function correctly.)
• In index.qmd, add an entry in H2 "Past workshops" like [M YYYY](archive/YYYY-MM-workshop-name/) in workshop-name

Not sure if this ought to live somewhere in the repo.

EDIT: added instructions to copy index.qmd.

[simonpcouch]

Related to #192.