Skip to content

Prototype: a session as a chat

A source

This page is a source of edakit – a concept, a prompt or the rules of a session –, shown as it is in the repository. Read it as such; the guides say what edakit does.

The sketch of session-chat.md, kept as the record: what was built is docs/session.md, chat_parse and chat_html in docs/pages.py, and the chat's styles in docs/brand/edakit.css.

  • session.md – the page as it would stand in docs/: an intro of two paragraphs and one ```chat fence, the walkthrough's board from the first sentence to the cart. On GitHub the fence reads as a plain transcript.
  • chat.py – the fence turned into HTML, as docs/pages.py would do it on assembly; the tally under the chat counted from the entries. python3 chat.py session.md out/session.html writes a standalone page.
  • chat.css – the chat's styles in the tokens of docs/brand/tokens.json, for docs/brand/edakit.css.
  • example.md – steps 8 and 9, shortened: every kind of entry once, the layout example of the concept's section 4; out/example.html, out/example-light.png (720 px, light) and out/example-dark-phone.png (390 px, dark).
  • out/session.html – the rendered page; out/session-light.png its top at 900 px, light, up to step 6; out/session-dark-phone.png steps 8 and 9 at 390 px, dark.

Its tally, counted by chat.py: 8 messages typed, 15 answers in 5 forms, 6 things done outside the chat. The click in EasyEDA carries a footnote (†): KiCad needs none, and the issues reported to EasyEDA.