Rename @pluto block args to pluto_* prefix in docs and examples (#6)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: fonsp

CLAUDE.md

@@ -96,7 +96,7 @@ Per-page scoping is a v0.2+ idea.
 
 `PlutoBlock` stores two "resolved" fields set during the builder step:
 
-- For `url=`/`state=` (hosted): resolved fields are the URLs verbatim.
+- For `pluto_notebookfile`/`pluto_statefile` (hosted): resolved fields are the URLs verbatim.
 - For `notebook=` (local): resolved fields are **build-root-relative paths**
   (e.g. `"pluto_notebooks/foo.jl"`), not absolute paths. Domify turns them
   into page-relative hrefs via `HTMLWriter.relhref(page_url, target)` where

README.md

@@ -35,8 +35,8 @@ Or with a hosted notebook:
 
 ````markdown
 ```@pluto
-url   = "https://bucket1.pluto.land/n/….jl"
-state = "https://bucket1.pluto.land/n/….plutostate"
+pluto_notebookfile = "https://bucket1.pluto.land/n/….jl"
+pluto_statefile    = "https://bucket1.pluto.land/n/….plutostate"
 ```
 ````
 

docs/src/demo_url.md

@@ -3,9 +3,9 @@
 This page embeds a Pluto notebook hosted on `pluto.land`.
 
 ```@pluto
-url    = "https://bucket1.pluto.land/n/01JVKXFS45K76H3Y8HY3J158JA.jl"
-state  = "https://bucket1.pluto.land/n/01JVKXFS45K76H3Y8HY3J158JA.plutostate"
-binder = "https://mybinder.org/v2/gh/fonsp/pluto-on-binder/v0.20.8"
+pluto_notebookfile = "https://bucket1.pluto.land/n/01JVKXFS45K76H3Y8HY3J158JA.jl"
+pluto_statefile    = "https://bucket1.pluto.land/n/01JVKXFS45K76H3Y8HY3J158JA.plutostate"
+pluto_binder_url   = "https://mybinder.org/v2/gh/fonsp/pluto-on-binder/v0.20.8"
 ```
 
 And regular Documenter content still works below the notebook:

docs/src/index.md

@@ -44,20 +44,24 @@ If you already host the notebook and state (e.g. via
 
 ````markdown
 ```@pluto
-url    = "https://bucket1.pluto.land/n/01JVKXFS45K76H3Y8HY3J158JA.jl"
-state  = "https://bucket1.pluto.land/n/01JVKXFS45K76H3Y8HY3J158JA.plutostate"
-binder = "https://mybinder.org/v2/gh/fonsp/pluto-on-binder/v0.20.8"
+pluto_notebookfile = "https://bucket1.pluto.land/n/01JVKXFS45K76H3Y8HY3J158JA.jl"
+pluto_statefile    = "https://bucket1.pluto.land/n/01JVKXFS45K76H3Y8HY3J158JA.plutostate"
+pluto_binder_url   = "https://mybinder.org/v2/gh/fonsp/pluto-on-binder/v0.20.8"
 ```
 ````
 
 ### Options
 
-| Key          | Type    | Default | Meaning                                 |
-| ------------ | ------- | ------- | --------------------------------------- |
-| `notebook`   | String  | —       | Path to a local `.jl` notebook          |
-| `url`        | String  | —       | URL of a hosted `.jl` notebook          |
-| `state`      | String  | —       | URL of a hosted `.plutostate` file      |
-| `binder`     | String  | —       | Optional Binder launch URL              |
-| `disable_ui` | Bool    | `true`  | Hide Pluto's UI chrome                  |
-
-Set exactly one of `notebook` or `url`. If `url` is set, `state` is required.
+| Key                          | Type   | Default | Meaning                                        |
+| ---------------------------- | ------ | ------- | ---------------------------------------------- |
+| `notebook`                   | String | —       | Path to a local `.jl` notebook (relative to `docs/src/`) |
+| `pluto_notebookfile`         | String | —       | URL of a hosted `.jl` notebook                 |
+| `pluto_statefile`            | String | —       | URL of a hosted `.plutostate` file             |
+| `pluto_disable_ui`           | Bool   | `true`  | Hide Pluto's UI chrome                         |
+| `pluto_binder_url`           | String | —       | Binder launch URL for the "Edit" button        |
+| `pluto_slider_server_url`    | String | —       | PlutoSliderServer base URL for interactivity   |
+| `pluto_preamble_html`        | String | —       | HTML inserted before the notebook              |
+| `pluto_recording_url`        | String | —       | URL of a recording to play back               |
+| `pluto_recording_audio_url`  | String | —       | URL of the audio track for a recording        |
+
+Set exactly one of `notebook` or `pluto_notebookfile`. If `pluto_notebookfile` is set, `pluto_statefile` is also required.