Updates

Author: TotallyInformation

CHANGELOG.md

@@ -47,6 +47,9 @@ It supports YAML front-matter in the markdown files. All front-matter attributes
 
 CommonMark and GitHub Flavored Markdown (GFM) are supported. Syntax highlighting for code blocks is also included. Some additional extensions are also supported such as custom attributes.
 
+
+An optional web component `<show-meta>` is also provided to display the current page's metadata (front-matter attributes). This is useful for debugging and development.
+
 See the [node documentation](./docs/nodes/uib-markweb.md) for full details.
 
 ### Documentation

docs/nodes/uib-markweb.md

@@ -3,7 +3,7 @@ title: uib-markweb - Dynamic web sites using Markdown
 description: >
   The `uib-markweb` node allows you to create dynamic web sites using Markdown files.
 created: 2026-01-09 15:10:14
-updated: 2026-02-01 15:37:55
+updated: 2026-02-02 16:10:39
 status: Release
 since: v7.6.0
 ---
@@ -74,32 +74,38 @@ These provide more complex processing than simple variable replacement. They are
 
 These provide simple variable replacement from front-matter and global/system fields. They are enclosed in `{{...}}` tags.
 
-All front-matter fields from the Markdown files can be used as variables. Some common ones are:
+All front-matter fields from the Markdown files can be used as variables. Some common ones are listed here.
+
+If not provided in the front-matter, the following default fields are always available, generated from the filing system information of the source Markdown files:
 
 * `title` - The title of the page.
-* `description` - The description of the page.
-* `author` - The author of the page.
 * `created` - The creation date of the page.
 * `updated` - The last updated date of the page.
-* `status` - The status of the page. E.g., `draft`, `published`, etc.
-* `tags` - The list of tags of the page.
-* `category` - The category of the page.
 
-In addition, a global JSON config file is provided, the default version adds, you may override these in `global-attributes.json` in the config folder:
+From system data and not overridable by front-matter:
+
+* `depth` - How deep in the folder structure the page is.
+* `path` - The current page path relative to the site root.
+* `toUrl` - The resource URL of the current page relative to the site root.
+* `fsMtimeMs` - The last modified time of the source file in milliseconds since epoch. (Used internally checking for file updates).
+* `type` - The type of page: `file` or `folder`.
 
-* `status` - The default page status if pages don't provide one. `Draft`.
+Provided by the default global config file but overridable by front-matter. Additional ones may be added in your own `global-attributes.json` file:
 
-* From system data:
+* `status` - The status of the page. E.g., `draft`, `published`, etc. *Default is `draft`.*
 
-  * `depth` - How deep in the folder structure the page is.
-  * `path` - The current page path relative to the site root.
-  * `toUrl` - The resource URL of the current page relative to the site root.
+Other commonly used front-matter fields you may wish to include in your Markdown files:
+
+* `description` - The description of the page.
+* `author` - The author of the page.
+* `tags` - The list of tags of the page.
+* `category` - The category of the page.
 
 * Possible future globals:
 
   * `template` - A different HTML template to the default to allow for different page layouts.
-  * `siteTitle` - The site title from global config.
-  * `siteDescription` - The site description from global config.
+  * `siteTitle` - The site title from global config. (Read-only).
+  * `siteDescription` - The site description from global config. (Read-only).
 
 ## Optional front-end web components
 

docs/roadmap/next.md

@@ -26,22 +26,27 @@ A node that creates a website out of a folder of markdown content.
 
 * [ ] ~~Check if return msgs get clientId, etc.~~ They don't, should they?
 * [ ] Indexes cannot currently deal with rename or delete events.
+* [ ] Generate title, created, updated from file details if not in front-matter.
+* [ ] Watcher for config folder.
+* [ ] Cache the default config folder files to avoid re-reading on every page load.
+* [ ] Watcher for default config folder?
+* [ ] Make sure nav and index are rebuilt on file changes.
 
 #### Wish list:
 
 * [x] Level specifier on nav element to limit depth and start level.
 * [x] On scroll, when nav menu scrolls offscreen, collapse it to a burger menu and keep it visible.
 * [x] Use server fs watch to provide live updates to pages. Send msg to ALL connected clients when a file changes. Clients can then decide what to do (e.g. reload if they are viewing that page).
+* [x] Allow source folder to be outside the userDir folder.
 
 * [-] Auto-menu generation.
   * [x] Horizontal
   * [ ] Vertical options.
 
-* [ ] Allow source folder to be outside the userDir folder.
+* [ ] Add watcher to the page template and global attributes files to auto-reload changes.
 * [ ] Improve HTML styling.
 * [ ] Page aliases. Allow front-matter `alias` field to specify alternative url paths for a page. Also have a master map.
 * [ ] Add manual index-rebuild button to Editor.
-* [ ] Add watcher to the page template and global attributes files to auto-reload changes.
 
 * [ ] uibuilder Editor
   * [ ] Include uib-markweb in common url checks.