feat(theme): add extra.footer_links for footer meta links

Render an optional row of text links (e.g. Disclaimers, Privacy, Terms)
in the footer meta area beneath the copyright/attribution line, driven
by extra.footer_links ([{ name, link }]).

Internal paths are resolved against base_url so they work from any page
depth; absolute URLs (http/https or //) are left as-is and open in a new
tab. Adds .md-footer-links styling, docs, and tests.

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

Author: Netdocs

docs-site/docs/reference/theme.md

@@ -170,7 +170,7 @@ your `customDir` and it wins over the bundled version.
 | `partials/breadcrumbs.html` | Breadcrumb trail above the page title (`navigation.path`, driven by `breadcrumbs`). |
 | `partials/source-file.html` | "Last updated / Created" line under the article body (`show_source_meta`, non-post pages). |
 | `partials/toc.html` | Right-hand table of contents. |
-| `partials/footer.html` | Site footer: prev/next nav, copyright, social links. |
+| `partials/footer.html` | Site footer: prev/next nav, copyright, footer links, social links. |
 | `partials/post-meta.html` | Blog-post byline: author avatar/name, date, reading time, categories. |
 | `partials/blog-nav.html` | Blog sidebar: recent posts / categories / archive listing. |
 | `partials/scripts.html` | End-of-body scripts: Material `__config` blob, the vendored bundle, hashed site scripts, inline scripts, and the highlight/mermaid loaders. |
@@ -344,3 +344,27 @@ only the last path segment is used.
 Need one that isn't listed? Add it via [`extra.social_icons`](#custom-icons) — the override map
 feeds nav icons and [badges](../plugins/macros.md) too.
 
+## Footer links
+
+Add a row of text links to the footer meta area (below the copyright/attribution line) with
+`extra.footer_links`. Each entry has a `name` and a `link`. Use this for pages such as
+Disclaimers, Privacy, or Terms:
+
+```json
+{
+  "Netdocs": {
+    "extra": {
+      "footer_links": [
+        { "name": "Disclaimers", "link": "/pages/disclaimers/" },
+        { "name": "Privacy", "link": "/pages/privacy/" },
+        { "name": "Source", "link": "https://github.com/you/repo" }
+      ]
+    }
+  }
+}
+```
+
+Links are resolved relative to the current page automatically: an internal path (e.g.
+`/pages/disclaimers/`) is prefixed with the correct `base_url` so it works from any depth,
+while absolute URLs (starting with `http` or `//`) are left as-is and open in a new tab.
+

src/Netdocs.Theme.Material/assets/netdocs.css

@@ -28,6 +28,20 @@ body {
   fill: currentColor;
 }
 
+/* Footer meta links (e.g. Disclaimers) rendered from `extra.footer_links`.
+   Sit on their own line under the copyright/attribution text. */
+.md-footer-links {
+  margin-top: 0.3rem;
+}
+
+.md-footer-links__link {
+  color: inherit;
+}
+
+.md-footer-links__sep {
+  opacity: 0.5;
+}
+
 /* ----------------------------------------------------------------------------
    Header: logo + site title on the left; social links, palette toggle and
    search on the right. Top-level navigation lives in the separate `.md-tabs`

src/Netdocs.Theme.Material/templates/partials/footer.html

@@ -30,6 +30,17 @@
       <div class="md-copyright">
         {{~ if config.copyright ~}}<div class="md-copyright__highlight">{{ config.copyright }}</div>{{~ end ~}}
         Built with Netdocs, a derivative of <a href="https://github.com/squidfunk/mkdocs-material" target="_blank" rel="noopener">MkDocs-Material</a>
+        {{~ if extra.footer_links ~}}
+        <nav class="md-footer-links" aria-label="Footer links">
+          {{~ for l in extra.footer_links ~}}
+          {{~ href = l.link ~}}
+          {{~ external = (href | string.starts_with "http") || (href | string.starts_with "//") ~}}
+          {{~ if !external ~}}{{~ href = base_url + (strip_slash href) ~}}{{~ end ~}}
+          {{~ if !for.first ~}}<span class="md-footer-links__sep"> &middot; </span>{{~ end ~}}
+          <a href="{{ href }}" class="md-footer-links__link"{{ if external }} target="_blank" rel="noopener"{{ end }}>{{ l.name }}</a>
+          {{~ end ~}}
+        </nav>
+        {{~ end ~}}
       </div>
       {{~ if extra.social ~}}
       <div class="md-social">

tests/Netdocs.Core.Tests/FooterLinksTests.cs

@@ -0,0 +1,82 @@
+using Netdocs.Core.Templating;
+using Xunit;
+
+namespace Netdocs.Core.Tests;
+
+/// <summary>
+/// Covers the <c>extra.footer_links</c> rendering logic used by the theme footer:
+/// internal paths are resolved against <c>base_url</c> (so they work from any page depth)
+/// while absolute URLs are left untouched and open in a new tab.
+/// </summary>
+public class FooterLinksTests : IDisposable
+{
+    private readonly string _dir = Path.Combine(Path.GetTempPath(), "netdocs-footer-" + Guid.NewGuid().ToString("N"));
+
+    public FooterLinksTests()
+    {
+        Directory.CreateDirectory(_dir);
+        // Mirrors the resolution logic in partials/footer.html.
+        File.WriteAllText(Path.Combine(_dir, "t.html"),
+            "{{~ for l in extra.footer_links ~}}" +
+            "{{~ href = l.link ~}}" +
+            "{{~ external = (href | string.starts_with \"http\") || (href | string.starts_with \"//\") ~}}" +
+            "{{~ if !external ~}}{{~ href = base_url + (strip_slash href) ~}}{{~ end ~}}" +
+            "<a href=\"{{ href }}\"{{ if external }} target=\"_blank\"{{ end }}>{{ l.name }}</a>" +
+            "{{~ end ~}}");
+    }
+
+    public void Dispose()
+    {
+        try { Directory.Delete(_dir, recursive: true); } catch (IOException) { }
+        GC.SuppressFinalize(this);
+    }
+
+    private string Render(string baseUrl, params (string name, string link)[] links)
+    {
+        var engine = new TemplateEngine([_dir]);
+        var model = new Dictionary<string, object?>
+        {
+            ["base_url"] = baseUrl,
+            ["extra"] = new Dictionary<string, object?>
+            {
+                ["footer_links"] = links
+                    .Select(l => (object?)new Dictionary<string, object?> { ["name"] = l.name, ["link"] = l.link })
+                    .ToList(),
+            },
+        };
+        return engine.Render("t.html", model);
+    }
+
+    [Fact]
+    public void InternalLinkIsPrefixedWithBaseUrl()
+    {
+        var html = Render("../../", ("Disclaimers", "/pages/disclaimers/"));
+        Assert.Contains("<a href=\"../../pages/disclaimers/\">Disclaimers</a>", html);
+        Assert.DoesNotContain("target=\"_blank\"", html);
+    }
+
+    [Fact]
+    public void InternalLinkAtRootHasNoPrefix()
+    {
+        var html = Render("", ("Disclaimers", "/pages/disclaimers/"));
+        Assert.Contains("<a href=\"pages/disclaimers/\">Disclaimers</a>", html);
+    }
+
+    [Theory]
+    [InlineData("https://github.com/you/repo")]
+    [InlineData("//cdn.example.com/x")]
+    public void AbsoluteLinkIsLeftAsIsAndOpensInNewTab(string link)
+    {
+        var html = Render("../../", ("Source", link));
+        Assert.Contains($"<a href=\"{link}\" target=\"_blank\">Source</a>", html);
+    }
+
+    [Fact]
+    public void RendersMultipleLinksInOrder()
+    {
+        var html = Render("../", ("Disclaimers", "/pages/disclaimers/"), ("Privacy", "/pages/privacy/"));
+        var disc = html.IndexOf("Disclaimers", StringComparison.Ordinal);
+        var priv = html.IndexOf("Privacy", StringComparison.Ordinal);
+        Assert.True(disc >= 0 && priv > disc);
+    }
+}