- Tag index nests by '/' hierarchy (parent -> child heading levels)
- Content pages show last-updated/created footer (non-generated only)
- GitRevisionDatePlugin: real dates via single-pass LibGit2Sharp history walk
  (filesystem fallback; skipped during serve for fast rebuilds)

…d categories

… csproj

…TODO

…port; init glightbox

- PluginHost.Build returned a fresh host with empty Assets, discarding
  stylesheets/scripts/files registered by plugins. Share one PluginAssets.
- Add IPluginContext.AddInlineScript for raw JS injection
- Glightbox: wrap content images + initialize the lightbox

… highlighting

…lock line numbers

- SocialPlugin: generate 1200x630 Material-style OG cards per page (palette-colored,
  site name/title/description), cached, build/prod only; og:image + twitter meta tags
- AbbreviationsPlugin: dedicated plugin appending abbreviation definition files
- Code blocks: highlightjs line numbers + styling
- SocialImagePath helper shared by renderer and plugin

…splay-name, search reconsideration)

…put paths

- Blog posts get URL-rewritten but their co-located assets keep the source path,
  so relative <img> src 404'd. Rewrite image/file links to absolute /source-path.
- Also rewrite excerpt image links in generated blog list/category/archive pages.

…hips, back-to-index, header social icons

- BlogPlugin loads .authors.yml; sets post metadata (author/date/category/read-time/tags) on pages
- Post pages: left sidebar shows author + Metadata + Back to index (nav for non-posts)
- Tag chips above post title; header social icons (github/discord/reddit/globe/rss via social_icon)

FrontMatter.Split counted line.Length + 1, undercounting CRLF, so the tail
of the last front-matter line and the closing --- leaked into the body and
rendered as a stray setext heading. Track offsets with an explicit ReadLine
that handles LF, CRLF and lone CR. Add FrontMatter CRLF tests.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The page-level search document used the full page plain-text, so matched
results rendered walls of text. Use only the intro (content before the first
heading) for the page doc and rely on per-section docs for the rest, matching
Material's teaser behaviour.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

ReadExcerpt now strips a leading H1 and caps length even when a <!-- more -->
marker is present, so blog list excerpts are concise teasers instead of walls
of text that duplicate the title. Add a blog-nav partial (Archive years +
Categories) shown on blog index, category, archive and pagination pages.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Authors can control how a page appears on the tags page (and in tags.json)
with a front-matter tags_title override, falling back to the resolved title,
first H1, then filename.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Read .file-filter.yml from the project root and prune pages whose front-matter
labels match an exclude_tag and not an include_tag. Honors enabled and
enabled_on_serve, replacing the previous pass-through stub.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

A full docs site under docs-site/ covering getting-started, CLI reference,
appsettings.json configuration, theme, markdown extensions, and a per-plugin
reference for every built-in plugin. Builds to 24 pages with netdocs build.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Multi-stage build produces a self-contained single-file netdocs CLI (with the
Material theme carried alongside) and publishes tagged images to GHCR.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Enables curly quotes, en/em dashes and ellipses (code spans/blocks are left
untouched), replacing the previous no-op stub. Adds a typeset test.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Expands read_csv / read_table directives into pipe tables, resolving paths
against the docs dir then project root and honoring RFC 4180 quoted fields.
Replaces the previous no-op stub.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Give fenced code blocks a soft drop shadow (scheme-aware via --nd-code-shadow;
stronger on the dark palette where the page background is close to the block
background) so they read as elevated panels and "pop" off the page. Inner
children of wrapped blocks reset the shadow to avoid it bleeding inside the panel.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The overflow:hidden needed for rounded corners trapped the inner <pre>'s
margin inside the panel, producing internal whitespace and no gap between
stacked blocks. Move spacing to the .highlight container (margin:1em 0) and
zero the inner pre margin. Set the inner pre to position:static so the
injected copy/select nav anchors to the panel's top-right corner (over the
title bar) instead of the code area below it. Bump horizontal code padding
so text isn't flush against the border.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The 'Adding a title' example labelled the block appsettings.json (which is
JSON) but showed a YAML body. Use a JSON body with the json language so the
title, language, and content are consistent.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The breadcrumb rendered a redundant link to the current page above the H1,
which looked cluttered. Disable it via config (the theme still supports it
for users who want it).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

When toc.integrate nests the page TOC under the active nav item, it rendered
a redundant 'Table of contents' label heading that Material does not show.
Drop the label so the headings nest directly under the active page, matching
Material's integrated-TOC look. Tag the nav with md-nav--integrated for
future styling hooks.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add a theme.highlight config key selecting the client-side highlighter:
highlightjs (default), none, or any other value (custom, bring your own via
extra_javascript/extra_css). The core Markdig fence parser is unchanged and
still emits neutral <pre><code class="language-x"> HTML, so only the browser
colouriser is swapped. The theme gates the highlight.js partial on this key.

Move the server-emitted filename title-bar CSS out of the highlight partial
into netdocs.css so titles survive a renderer swap. Document the option under
Reference > Theme (Code highlighting) with a bring-your-own-highlighter
example, and cross-link from the code-blocks page.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The macros plugin only shipped two hardcoded macros with no way for a site to
add its own. Add a �ariables option: each key becomes a {{ key }} text
macro, so users can define their own macros with no code. Unknown tokens are
left untouched, and function-style macros (fileuri/button) are unaffected.

Rewrite the macros plugin doc to explain its purpose and both extension paths
— config variables (no code) and a custom IMarkdownPreprocessor plugin (with
a worked example) — cross-linking the external-plugin loader and the
events & callbacks reference. Add a variable-expansion unit test.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Cards are already content-cached by file existence, so a serve session only
pays the generation cost once (missing cards on first build) and skips them on
later incremental rebuilds. Stop hard-skipping serve; add an enabled_on_serve
option (default true) so large sites can still opt out. Update the social
plugin doc.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Reorganise the nav around the real user flow — set up, write docs, deploy —
instead of a generic Reference/Setup split:

- Setup: install/quickstart, configuration, theme, CLI, importing.
- Writing docs: markdown extensions, code blocks, admonitions & tabs, and a
  nested Plugins group (built-ins, no third-party deps, so they live with
  authoring rather than in a separate tab).
- Deployment: the former 'Setup' (publishing, docker, packaging), which was
  really about deploying.
- Development moves to the end (before About) and gains External plugins,
  which was misfiled under Reference.

Move external-plugins.md from reference/ to development/ and fix its two
inbound links.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Complete the IA restructure: point the nav at the task-oriented sections
(Setup, Writing docs with a nested Plugins group, Deployment, Development,
About) and update the two inbound links to the relocated external-plugins
page.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Close the two documentation-coverage gaps:
- Add a plugins/typeset.md page (SmartyPants smart typography) and list it in
  the plugin catalogue and nav; it was the only registered plugin with no doc.
- Add Deployment and Optimization sections to the configuration reference
  (deploy target/path/clean/branch/remote/message/push/bucket/prefix/region
  and optimize minifyHtml/minifyCss/minifyJs/convertImagesToWebp/webpQuality),
  and list slugify/deploy/optimize in the top-level keys table. These existed
  in the model but were absent from the config reference.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add an end-to-end regression test confirming abbreviations render as <abbr>
tooltips in prose while inline code and fenced code blocks are left untouched
(Markdig behavior). Clarify the plugin doc: default files list, code-block
safety, and that the plugin must be enabled in the plugins config to run.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

fileuri() gains an optional second argument selecting how the resolved URL is
written: default/absolute (site_url-prefixed), path/root (root-absolute /path
without a host), and relative/rel (page-relative ../ path that survives being
served under a base path). The default is unchanged and backward compatible.

Add tests for the path/relative/absolute modes and document the modes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Introduce UserDefinedMacro: subclass it, override DefineMacros, and register
named handlers via a fluent IMacroBuilder - no regex or Markdown parsing. It
supports no-arg function macros ({{ name() }}), argument macros ({{ name(a,b) }}),
contextual macros with page/site access, and bare-token variables ({{ name }}).
Unknown tokens pass through untouched and pages can opt out with ignore_macros /
render_macros: false front matter.

Document it as the recommended path for custom macros, keeping raw
IMarkdownPreprocessor as the advanced escape hatch. Add tests.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add an optional order to a plugin's config entry that overrides its natural
IMarkdownPreprocessor.Order, so users can change where a plugin runs in the
preprocess stage without recompiling. Parsed by both the JSON and mkdocs config
loaders and applied in PluginHost (stable sort keeps config order on ties).

Add PluginHost tests for default and overridden ordering; document the order
key in the lifecycle and configuration references.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Rewrite the RSS plugin with:
- Optional Atom 1.0 feed (atom / atom_file options) alongside RSS.
- Image support: front-matter image or the first <img> in the post becomes an
  <enclosure>; a channel image logo option; MIME guessed from extension.
- Per-post front-matter overrides: 
ss_title and 
ss_description.
- More customization: feed_title, feed_description, ttl, rss_file, length/limit,
  and full_content (emit content:encoded / Atom content instead of excerpt).
- atom:link rel="self" advertised on the RSS channel.

Add RssPluginTests covering metadata, overrides, images, full content, Atom, and
length limiting. Document all options and the post->feed field mapping.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The theme's browser libraries (highlight.js, mermaid, mathjax, glightbox, ...) are
loaded from a CDN with pinned versions, so Dependabot had no way to see them. Add
a private /package.json tracking manifest mirroring those versions and enable the
npm ecosystem in dependabot.yml. Document the CDN-URL mapping and the update
workflow in a new Development > Front-end dependencies page.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Extract three self-contained blocks out of the monolithic main.html so
users can override a single piece without copying the whole layout:

- partials/social.html  - header social links (the canonical "override
  just the social icons" example)
- partials/head.html    - <head> meta/OG/Twitter/styles/fonts + the inline
  __md_* helper script
- partials/scripts.html - end-of-body __config blob, Material bundle,
  hashed site scripts, inline scripts, highlight/mermaid loaders

Each partial (new and existing) begins with a Scriban {{ # }} comment
documenting the globals it receives and how to override it. Scriban
comments emit no output, so they never reach the HTML (minified or not).

Document every overridable template/partial in reference/theme.md, and
clarify that blog-index and tag pages render through main.html (no
dedicated template to copy).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The plugin is generic (attach a note/footnote to matching outbound links);
"affiliate links" is just one use-case, and the affiliate framing is
unfriendly in FOSS contexts. Rename AffiliateLinksPlugin -> LinkNotesPlugin
(Name "link-notes") and register "affiliate-links" as a backward-compatible
alias. The legacy config keys stay supported: "programs" -> "rules",
"disclosure" -> "note".

New capabilities:
- patterns: optional list of regular expressions matched case-insensitively
  against the full URL, in addition to (or instead of) domain rules.
- label: title for the standalone fallback admonition used for table-only
  links (default "Links"), so the affiliate use-case can keep its wording.

Footnote label prefix changed affiliate-<id> -> linknote-<id> (invisible in
rendered output). Tests renamed and extended (regex, regex+domain, legacy
keys, invalid-regex, custom label). Docs: affiliate-links.md -> link-notes.md
with the new options, cross-links and nav updated.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

A new first-party plugin that turns a fenced `calc` block written in
YAML into a client-side calculator: labelled inputs (number/range/select)
plus outputs computed live from expressions referencing the input names.

- Preprocessor (order 15) replaces each calc fence with a raw-HTML
  <form class="nd-calc"> that Markdig passes through.
- A single vanilla-JS evaluator is injected once per page; it builds a
  Function from each sanitised expression with the inputs as named
  variables (JS Math is in scope) and recomputes on input. Re-binds on
  Material's document$ so it survives instant navigation.
- Expressions are restricted to a safe character set (no quotes/semicolons/
  brackets/backslashes); unsafe outputs are dropped with a warning.
- Lightweight number formatting (e.g. ".00", "0.0 kWh").
- Theme CSS for the input grid and result cards (palette-aware).

Registered as "calculator" (alias "calc"), enabled in the dogfood site
with a live power-cost example. Adds plugins/calculator.md + nav entry and
10 unit tests (198 total).

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Bumps SixLabors.ImageSharp from 3.1.12 to 4.0.0
Bumps SixLabors.ImageSharp.Drawing from 2.1.7 to 3.0.0

---
updated-dependencies:
- dependency-name: SixLabors.ImageSharp
  dependency-version: 4.0.0
  dependency-type: direct:production
  update-type: version-update:semver-major
- dependency-name: SixLabors.ImageSharp.Drawing
  dependency-version: 3.0.0
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>