From c969326c9255a2739443d27536b73512bfd0a227 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 23 Jun 2026 22:21:00 +0000 Subject: [PATCH] =?UTF-8?q?docs(guides):=20core=20guides=20=E2=80=94=20aut?= =?UTF-8?q?horing,=20templates=20&=20theming,=20Gnosis,=20accessibility?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add docs/guides/: authoring-a-site (content tree, front-matter, build, output, collections, tags, feeds, drafts, public/, site.conf), templates-and-theming (layout resolution, partials, the full template-variable list, assets, the built-in accessible theme), the-gnosis-layer ((:placeholder) + filters, DAX conditionals/loops, FlexiText, the descriptiles source + current .scm gap), and accessibility (engine-owned vs author-owned, WCAG mapping, the echo-types direction). All cross-linked; accurate to the built binary. Co-Authored-By: Claude Opus 4.8 Claude-Session: https://claude.ai/code/session_01WN6nPWWe4dvXfoqBG6auWN --- docs/guides/accessibility.adoc | 66 +++++++++++++ docs/guides/authoring-a-site.adoc | 128 +++++++++++++++++++++++++ docs/guides/templates-and-theming.adoc | 86 +++++++++++++++++ docs/guides/the-gnosis-layer.adoc | 89 +++++++++++++++++ 4 files changed, 369 insertions(+) create mode 100644 docs/guides/accessibility.adoc create mode 100644 docs/guides/authoring-a-site.adoc create mode 100644 docs/guides/templates-and-theming.adoc create mode 100644 docs/guides/the-gnosis-layer.adoc diff --git a/docs/guides/accessibility.adoc b/docs/guides/accessibility.adoc new file mode 100644 index 0000000..0f09d64 --- /dev/null +++ b/docs/guides/accessibility.adoc @@ -0,0 +1,66 @@ +// SPDX-License-Identifier: CC-BY-SA-4.0 +// SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell += Accessibility +:toc: left +:toclevels: 2 + +casket treats accessibility as a property of the *engine*, not a checklist for +the author. This guide separates what casket guarantees from what remains your +responsibility. + +== Engine-owned (casket guarantees) + +When you use the built-in template and the default pipeline, casket emits: + +[cols="2,3"] +|=== +| What | WCAG relevance + +| ``, ``, `color-scheme: light dark` +| 3.1.1 Language of Page; 1.4.10 Reflow; respects OS light/dark + +| A skip link (`Skip to content`) and labelled landmarks + (`header` / `nav[aria-label]` / `main#main` / `footer`) +| 2.4.1 Bypass Blocks; 1.3.1 Info & Relationships + +| `scope="col"` added to Pandoc table headers automatically +| 1.3.1 Info & Relationships (screen-reader table navigation) + +| Valid `