V1

README.md

@@ -25,6 +25,7 @@ luxtools provides DokuWiki syntax that:
 - Renders an image thumbnail gallery (with lightbox)
 - Provides "open this folder/path" links for local workflows
 - Embeds file-backed scratchpads with a minimal inline editor (no wiki revisions)
+- Links a page to a media folder via a UUID (.pagelink), enabling a `blobs/` alias
 
 It also ships a small file-serving endpoint (`lib/plugins/luxtools/file.php`) used
 to deliver files and generate cached thumbnails.
@@ -141,6 +142,10 @@ Key settings:
   URL of a local client service used by `{{open>...}}` and directory links.
   See luxtools-client.
 
+- **pagelink_search_depth**
+  Maximum directory depth for `.pagelink` discovery under each configured root.
+  `0` means only the root directory itself is checked.
+
 ### Template style settings
 
 The `{{open>...}}` links and directory “open” links use a dedicated color
@@ -206,6 +211,27 @@ Supported input examples include:
 - `2026-01-30 13:45`
 - `2026-01-30T13:45:00`
 
+### 0.2) Editor toolbar: Page Link
+
+The **Page Link** toolbar button creates a page-scoped UUID and stores it in
+page metadata. This UUID is used to link the page to a folder that contains
+a `.pagelink` file with the same UUID.
+
+Workflow:
+
+1. Click **Page Link** in the editor toolbar to create the UUID.
+2. View the page and copy the UUID from the “Not linked: Copy ID” status.
+3. Create a `.pagelink` file in the target folder (within your configured
+  `paths` roots) and paste the UUID into that file.
+
+Once linked, you can use `blobs/` as an alias in luxtools syntax on that page,
+for example:
+
+```
+{{images>blobs/*.png}}
+{{directory>blobs/&recursive=1}}
+```
+
 ### 1) List files by glob pattern
 
 The `{{directory>...}}` syntax (or `{{files>...}}` for backwards compatibility) can handle both directory listings and glob patterns. When a glob pattern is used, it renders as a table: