Talks and slides¶
A slide deck is a single self-contained HTML file, index.html, in its own directory below
docs/slides/. The site serves each deck as it is, and a README next to it in the repository
explains how to view, edit and export the deck.
Decks¶
| Deck | Talk | README |
|---|---|---|
| chalkos: build your own API-driven, immutable Linux | A short technical talk on the motivation, a node's anatomy and trust chain, config kinds, config delivery, upgrades, layers and tests, with an air-gapped home lab demo. | docs/slides/chalkos-intro/README.md |
Add a deck¶
- Create a directory below
docs/slides/named after the talk, such asdocs/slides/chalkos-intro/. - Put the deck in it as
index.html, with its CSS and JavaScript inline. Assets the deck loads by a relative path go in the same directory, and the site serves them too. - Add a
README.mdthat says what the talk covers and how to view, edit and export the deck. The site leaves the README out, so the repository is where it is read. - Add a row for the deck to the table on this page, with a link to
index.htmland one to the README on GitHub.
The site serves docs/slides/<name>/index.html at slides/<name>/.
Build the site to see the deck as it is published:
the build sees only the files git tracks, so git add the deck first.