Tracking issue for 2i2c using MyST to generate a report

[choldgraf]

We decided to use the new MyST build engine to create a three-year CZI report and retrospective, hosted at the following link:

https://2i2c.org/report-czi-2021

This is a tracking issue for the things that came up during that effort. I'm putting it into this style of an issue in order to track a pattern we hope to follow more times, which is to:

1. Work with a community to convert their Jupyter Book content into MyST
2. Identify the confusion points, missing functionality, etc and track them as issues for development
3. Resolve the issues and then re-deploy to the new book

Issues uncovered

• 💬 Add epigraph, pull-quote and blockquote directive #961
• Add {margin} directive myst-theme#327
• Support custom favicons #925
• Light / dark mode does not persist between pages in static export myst-theme#319
• Display footnotes at the bottom of a page in addition to being hoverable #926
• Unreliable DOI resolution for some DOIs #947
• Poor UX for small screens #948
• Allow for cross-page bibliographies #946
• Lots of errors when building a book PDF with typst #1003
• Social previews are not generated with HTML builds myst-theme#332
• Social media card images from page metadata myst-theme#331
• Add an "Edit this page" button myst-theme#326

Documentation

• Clarify the options for static site hosting and "live server" hosting #927
• Developer suggestion: Nest our documentation in sub-folders #966
• Developer suggestion: Build a static HTML preview of the documentation in our CI/CD #968

Myst website issues

• mystmd.org theme does not have a hamburger menu on mobile mystmd.org#12
• MyST website toolbar should switch colors with the dark / light theme mystmd.org#13

[agoose77]

As per a discussion with Chris, we're closing this in favour of new initiatives!