Add configuration for GNOME

.config/gnome-settings/README.md

@@ -0,0 +1,64 @@
+# GNOME Settings
+
+
+This folder contains my GNOME settings
+    split into several `*.ini` files by logical group.
+
+Machine-specific overrides may live in `local/*.ini` and are loaded last.
+
+
+All paths inside the files are absolute,
+    anchored at the root of `dconf`.
+Therefore, they must always be loaded anchored at the root as well:
+
+```bash
+dconf load / < <file>
+```
+
+
+[`restore-gnome`](../../.local/bin/restore-gnome) automates this upon every login
+    (via the `restore-gnome.service` systemd user unit).
+
+Process:
+1. Back up the current `dconf` state into ~/.local/state/gnome-settings-backups/
+2. Reset all managed sub-trees,
+   so that keys removed from the `*.ini` files do not linger in the live state,
+   and
+3. Load every `*.ini` here, then every `local/*.ini`.
+
+
+[`verify-dconf`](../../.local/bin/verify-dconf) lists keys diverging
+    between the live state and the `*.ini` files,
+    and can be used to find live keys worth adopting.
+
+
+
+## Color Palette
+
+
+A teal ramp from light to dark,
+    plus two neutral tones for the shell chrome.
+
+Translucent colors are always alpha-variants of a stop,
+    used for `forge`'s tile previews and tab decorations.
+
+
+| Stop | Hex       | RGB                | Role                                         |
+|------|-----------|--------------------|----------------------------------------------|
+| 1    | `#DEEDF1` | rgb(222, 237, 241) | Foreground and text, focused borders         |
+| 2    | `#AED6DE` | rgb(174, 214, 222) | Quiet chrome: bar and unfocused windows      |
+| 3    | `#7CBDCB` | rgb(124, 189, 203) | Tile previews                                |
+| 4    | `#4AA4B6` | rgb( 74, 164, 182) | Borders of active elements                   |
+| 5    | `#2190A4` | rgb( 33, 144, 164) | Accent                                       |
+| 6    | `#028397` | rgb(  2, 131, 151) | Stacked and tabbed layout, floated windows   |
+| 7    | `#067A8D` | rgb(  6, 122, 141) | Openbar Highlights                           |
+| 8    | `#086E7F` | rgb(  8, 110, 127) | Tab decorations                              |
+| 9    | `#0A6271` | rgb( 10,  98, 113) | Dimmed backgrounds (e.g., inactive tabs)     |
+| 0    | `#054A55` | rgb(  5,  74,  85) | Dark base: terminal and sub-menu backgrounds |
+| gray | `#2E2E32` | rgb( 46,  46,  50) | Surfaces: bar and menu backgrounds           |
+| base | `#000000` | rgb(  0,   0,   0) | Screensaver, shadows                         |
+
+
+Stop 5 is GNOME's default "teal" color,
+    which is one of nine built-in colors that cannot be changed.
+"gray" is GNOME's dark surface gray.