~/talk

Designing MkDocs

Talkat Write the Docs Prague 2014 · 2014-09-08..09-09· [web-performance]
slides:none on file

A minimalist documentation generator that builds static sites from Markdown, written in Python and driven by a single YAML config. It includes a live-reloading dev server, navigation ordering and prev/next links, Jinja2 themes and simple theme overrides, and direct GitHub Pages deployment. The demo shows mkdocs creating a site folder and serving it, so it works end-to-end; missing items include the ref-style interlinking, theme documentation, and polished docs for a 1.0 release.

AI-written summary · about

  1. 0:00Start
  2. 6:06Prerequisites
  3. 17:38Configuration File
  4. 22:11Build a Theme
  5. 24:43Deployment Options
  6. 25:05Github Pages
~/search
type to search 6,249 conferences, 138,987 speakers and 185,172 talks
~/help
cmdctrl k
search every conference, speaker and series
/
focus the filter search
h
home
c
conferences
s
speakers
e
series
t
light / dark — the status bar button does the same
?
this help
esc
close this, then clear every filter — or just the search, while you are typing in it

Ignored while you are typing. Pages without a filter rail have no search to focus.