diff options
| author | Craig Jennings <c@cjennings.net> | 2026-06-08 06:35:06 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-06-08 06:35:06 -0500 |
| commit | cd24eedbf4871dd5ecd91a228bcff586c6494f92 (patch) | |
| tree | 5629cf77ca9a6afc0955ba61b9e6e86a34cbe9f0 | |
| parent | 39fcd5112b29139f4cf41e5101dc474f89169ebd (diff) | |
| download | dotemacs-cd24eedbf4871dd5ecd91a228bcff586c6494f92.tar.gz dotemacs-cd24eedbf4871dd5ecd91a228bcff586c6494f92.zip | |
docs(theme-selector): document underline and strike in the theme.json contract
Record the two new face booleans in the README contract and the spec's state-and-export-policy block, including that the converter writes them as :underline t and :strike-through t.
| -rw-r--r-- | docs/design/theme-selector-package-faces-spec.org | 3 | ||||
| -rw-r--r-- | scripts/theme-selector/README.md | 8 |
2 files changed, 7 insertions, 4 deletions
diff --git a/docs/design/theme-selector-package-faces-spec.org b/docs/design/theme-selector-package-faces-spec.org index 973f3d72..def6a430 100644 --- a/docs/design/theme-selector-package-faces-spec.org +++ b/docs/design/theme-selector-package-faces-spec.org @@ -307,7 +307,8 @@ Each package face object carries a =source= marker so export can tell a seeded default from a user edit from a deliberate clear: #+begin_src js -{ fg:"#67809c", bg:null, bold:true, italic:false, inherit:null, height:1.0, source:"default" } +{ fg:"#67809c", bg:null, bold:true, italic:false, underline:false, strike:false, inherit:null, height:1.0, source:"default" } +// underline / strike: booleans -> the converter writes :underline t / :strike-through t // height: float multiplier off the base font (1.0 = unchanged); see Relative height // source: "default" (seeded) | "user" (edited) | "cleared" (user removed a default) #+end_src diff --git a/scripts/theme-selector/README.md b/scripts/theme-selector/README.md index b7e8f155..8f63383c 100644 --- a/scripts/theme-selector/README.md +++ b/scripts/theme-selector/README.md @@ -118,6 +118,7 @@ The export (and what a build step consumes): "packages": { "org-mode": { "org-level-1": {"fg": "#67809c", "bg": null, "bold": true, "italic": false, + "underline": false, "strike": false, "inherit": null, "height": 1.3, "source": "default"} } } @@ -127,9 +128,10 @@ The export (and what a build step consumes): - `assignments` maps syntax category keys to hexes; `bg` is the `default` face background, `p` the foreground. - `ui` and `packages` faces carry `fg`/`bg` (hex or `null`), `bold`, `italic`, - and for package faces `inherit` (a face name or `null`), `height` (a float, - omitted at 1.0), and `source` (`"default"` seeded, `"user"` edited, - `"cleared"`). + `underline`, `strike`, and for package faces `inherit` (a face name or + `null`), `height` (a float, omitted at 1.0), and `source` (`"default"` seeded, + `"user"` edited, `"cleared"`). The converter writes `underline` as + `:underline t` and `strike` as `:strike-through t`. - The theme name is both the `name` field and the download filename. Import a `theme.json` to start from a prior theme; a file with no `packages` key still loads. |