@kecan0406/ttheme 1.0.49 → 1.1.2

package/README.md

@@ -80,37 +80,45 @@ a checkout are in [docs/install.md](docs/install.md).
 Both images are drawn from the live catalog, so they always match what
 `ttheme browse` offers. `init` installs the series you pick; `ttheme browse`
 adds or drops single palettes any time, and a merged palette reaches everyone
-through `ttheme update` without waiting for a release.
+within a day of using ttheme — or at once through `ttheme update` — without
+waiting for a release.
 
 ### Markets
 
 Anyone can publish palettes from a GitHub repository. A market is named
 `<owner>@<name>` — its repository's owner and the name its index gives — and
-sits below the series in `ttheme preview` and `ttheme browse`, past a line:
+sits below the series in `ttheme preview` and `ttheme browse`, past a line, with
+the folders under its `palettes/` as catalogs:
 
 ```
 ▾ Evangelion
     rei
     asuka
-── markets ──────────
+── Markets ──────────
 ▾ alice@pastel
-    dusk
-    rei
+  ▾ night
+      dusk
+      moon
+  ▸ day
 ```
 
 ```sh
-ttheme market search                  # repositories with the ttheme-market topic
-ttheme market add alice/ttheme-pastel # or a folder
-ttheme add alice@pastel/dusk
+ttheme add dusk --market alice/ttheme-pastel  # add alice's market and install from it
+ttheme market add alice/ttheme-pastel#v1      # or add it alone, pinned to a tag
+ttheme browse                                 # tab to Markets: add, remove, auto-update
 ```
 
-Nobody reviews a market. Its palettes are colors and post numbers, never code,
-and the contrast gate's numbers are shown for them but never enforced — only
-the official catalog is held to the gate. `ttheme update` refreshes every
-market; `ttheme market remove alice@pastel` drops one, and the palettes you
-installed from it keep working. The official catalog is a market too
-(`official`). [The markets page](https://kecan0406.github.io/ttheme/markets)
-lists the public ones.
+`ttheme browse` handles markets the way it handles palettes: its Markets tab
+adds one by repository or folder, finds the public ones on GitHub, marks one for
+removal and switches its auto-update, and enter applies all of it with the
+palettes you picked. The official catalog updates on its own once a day as you
+use ttheme; a repository asks when you add it. Nobody reviews a market. Its
+palettes are colors and post numbers, never code, and the contrast gate's
+numbers are shown for them but never enforced — only the official catalog is
+held to the gate. `ttheme update` refreshes every market now; `ttheme market
+remove alice@pastel` drops one, and the palettes you installed from it keep
+working. The official catalog is a market too (`official`). [The markets
+page](https://kecan0406.github.io/ttheme/market) lists the public ones.
 
 ### Your own palettes
 
@@ -119,7 +127,8 @@ handle and a market name the first `new` asks for, in
 `~/.config/ttheme/market/<market>`, and installs it. `ttheme edit rei` opens it
 in `$EDITOR`; `ttheme check --fix` suggests colors that pass the gate.
 
-A local market is already a repository layout: `palettes/*.toml`, the
+A local market is already a repository layout: `palettes/*.toml` (a folder
+under it, such as `palettes/night/`, is a catalog), the
 `ttheme-market.json` index and a workflow that rebuilds the index on every
 push. `ttheme market init <name>` makes one and prints the commands that
 publish it:
@@ -140,16 +149,16 @@ from the booru the way `find` does.
 
 | Command | |
 |---|---|
-| `ttheme preview` | browse live — the tab repaints as the cursor moves, enter applies it to this tab or makes it the default |
-| `ttheme use <palette>` | paint this tab (a unique prefix works) |
-| `ttheme next` | advance this tab to the next palette |
-| `ttheme default <palette>` | the palette new tabs open with |
-| `ttheme pin` / `unpin` | a palette for this directory — `cd` in repaints, `cd` out restores |
-| `ttheme browse` | pick palettes from the catalog |
-| `ttheme market add <owner/repo>` | add someone's market — `ttheme market` lists yours; `search`, `remove` too |
-| `ttheme new <name> --from <palette>` | make a palette of your own; `edit`, `check`, `share` follow |
-| `ttheme on` / `off` | wear the default again / give the terminal its own colors back |
-| `ttheme config` | settings in `$EDITOR` |
+| `ttheme preview` | Browse live — the tab repaints as the cursor moves, enter applies it to this tab or makes it the default |
+| `ttheme use <palette>` | Paint this tab (a unique prefix works) |
+| `ttheme next` | Advance this tab to the next palette |
+| `ttheme default <palette>` | The palette new tabs open with |
+| `ttheme pin` / `unpin` | A palette for this directory — `cd` in repaints, `cd` out restores |
+| `ttheme browse` | Pick palettes and markets — tab moves between Catalog, Installed, Markets and Errors |
+| `ttheme market add <owner/repo>` | Add someone's market (`#v1` pins it) — `ttheme market` lists yours; `search`, `remove` too |
+| `ttheme new <name> --from <palette>` | Make a palette of your own; `edit`, `check`, `share` follow |
+| `ttheme on` / `off` | Wear the default again / give the terminal its own colors back |
+| `ttheme config` | Settings in `$EDITOR` |
 
 `ttheme help` shows the three to start with and the rest by task; `ttheme help
 all` lists every command. Preview's keys, directory pins, rotating new
@@ -170,7 +179,7 @@ is what it is: [docs/terminals.md](docs/terminals.md).
 ## Background pictures
 
 A palette can wear a picture behind the text. ttheme ships none: `ttheme
-preview` → tab searches danbooru, konachan and yande.re for the character live
+preview` → tab searches danbooru, konachan, yande.re and zerochan for the character live
 (safe-rated by default), or takes a picture you paste or drop, cuts the
 character out on macOS, tints it to the palette and installs it on your machine
 only. Ghostty shows the focused tab's picture, iTerm2 one per tab, kitty one per