[Tim-Conrad]

papercuts repo

Why the change

The site gets a Tools sheet and a page for papercuts, whose text comes from the papercuts README at deploy time, so the README and the page never drift.

Special things to note

• Do not merge yet. The deploy fetches the README of the latest papercuts release. The repo is private for now and has no release, so the deploy fails until papercuts is public and has a v0.1.0 release.
• tools/ moved to scripts/, so that /tools/ can be a page. The review container t7d-review must be recreated after the merge, because its command path moved to scripts/review/devserver.py.
• The README renders with raw HTML turned off, so the page keeps its strict CSP. The drafts/ folder is gitignored and never published.

Screenshots

The After images of the papercuts page use the current README through --readme-dir, because no release exists yet.

Front page top, 1440 px

Before	After

Front page Sheet 5, 1440 px

Before	After

Front page Sheet 5, 390 px

Before	After

/tools/papercuts/, 1440 px and 390 px

Before	After
The page did not exist.
The page did not exist.

Change outline

  index.html          Sheet 5 is Tools (PGP is 6, Contact is 7), Contents says "1 tool"
+ tools/index.html    the list of tools
+ tools/papercuts/    intro by hand, then <!-- tool-readme: Tim-Conrad/papercuts --> ... filled at deploy
+ scripts/gen-tools.py         latest release README -> HTML (Python-Markdown, no raw HTML)
+ scripts/test_gen_tools.py    8 tests
- tools/*.py, tools/review/    moved to scripts/
  deploy.sh, deploy.yml        add tools/ to the site, run gen-tools, pip install markdown==3.11.3
  check.yml                    runs the generator tests
  .gitignore                   /drafts/

Deploy flow:

deploy -> gen-tools.py -> GET latest release of Tim-Conrad/papercuts -> README.md
       -> render -> replace the text between the markers -> exit 1 if anything fails