sam/kontra
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(DESIGN): add media model note (git files beside article; no S3); garage bucket+keys deleted

Browse Source
This commit is contained in:
sam
2026-09-10 09:43:52 +10:00
parent 804b37a9a3
commit ba5500710c
1 changed files with 8 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
DESIGN.md
View File

@@ -164,6 +164,14 @@ Brand: **Kontra** (centered masthead). Home section heading: **Topics** (not "By
Reference implementation: `prototype/` (index.html, article.html, assets/kontra.css). Reference implementation: `prototype/` (index.html, article.html, assets/kontra.css).
## Media (implementation note)
- Images are **git files beside their article**: `content/subjects/<s>/<slug>/<file>`.
Reference via `{{media:<slug>/<file>}}` (front-matter `image:` MUST be quoted —
`image: "{{media:slug/file.jpg}}"`). The app serves `/media/<path>` by searching
article folders (safe-path guarded). No S3/object store (Garage dropped 2026-09-10).
- Hero image: grayscale plate per §Hero plate; leave `image: ""` for text-only pieces.
## Token wiring (for the theme) ## Token wiring (for the theme)
- Implement as CSS custom properties on `:root` (the design-token layer). - Implement as CSS custom properties on `:root` (the design-token layer).