Make gallery render metrics in browser

Author: aivuk

README.md

@@ -57,7 +57,7 @@ Download a book from Project Gutenberg:
 uv run bookviz gutenberg 2701 --title moby-dick
 ```
 
-Generate a static gallery:
+Generate the GitHub Pages gallery:
 
 ```bash
 uv run bookviz gallery \
@@ -67,6 +67,10 @@ uv run bookviz gallery \
   --window-size 200
 ```
 
+The gallery is a static browser app. It publishes the book text files and lets
+the browser compute metrics, change window size, change window step, switch
+books, and redraw the visualization without regenerating images in CI.
+
 ## Metrics
 
 Token metrics:
@@ -92,7 +96,6 @@ inside each window.
 
 ## GitHub Pages
 
-The workflow at `.github/workflows/pages.yml` builds the gallery with `uv` and
-publishes the generated `site/` directory to GitHub Pages. Enable Pages in the
-repository settings and choose GitHub Actions as the source.
-
+The workflow at `.github/workflows/pages.yml` builds the client-side gallery
+with `uv` and publishes the generated `site/` directory to GitHub Pages. Enable
+Pages in the repository settings and choose GitHub Actions as the source.

bookviz/cli.py

@@ -55,7 +55,7 @@ def build_parser() -> argparse.ArgumentParser:
     gutenberg.add_argument("--force", action="store_true")
     gutenberg.set_defaults(func=cmd_gutenberg)
 
-    gallery = subparsers.add_parser("gallery", help="Generate a static HTML gallery.")
+    gallery = subparsers.add_parser("gallery", help="Generate the static client-side gallery.")
     gallery.add_argument("--input", type=Path, default=Path("books"))
     gallery.add_argument("--output", type=Path, default=Path("site"))
     gallery.add_argument("--metrics", nargs="+", default=["word-freq", "lexical-diversity"])
@@ -157,4 +157,3 @@ def cmd_list(_args: argparse.Namespace) -> None:
 
 if __name__ == "__main__":
     main()
-