deps: Bump SixLabors.ImageSharp and SixLabors.ImageSharp.Drawing

.dockerignore

@@ -0,0 +1,11 @@
+# Build output
+site/
+dist/
+artifacts/
+
+# .NET
+bin/
+obj/
+
+# Local
+.venv/

.editorconfig

@@ -0,0 +1,56 @@
+root = true
+
+[*]
+charset = utf-8
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 2
+
+[*.{cs,csx}]
+indent_size = 4
+
+[*.{csproj,props,targets,slnx,xml}]
+indent_size = 2
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+# C# conventions
+[*.cs]
+# Namespaces
+csharp_style_namespace_declarations = file_scoped:warning
+
+# 'this.' not required
+dotnet_style_qualification_for_field = false:suggestion
+dotnet_style_qualification_for_property = false:suggestion
+dotnet_style_qualification_for_method = false:suggestion
+dotnet_style_qualification_for_event = false:suggestion
+
+# Language keywords over BCL type names
+dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
+dotnet_style_predefined_type_for_member_access = true:suggestion
+
+# var preferences (codebase uses var freely)
+csharp_style_var_for_built_in_types = true:suggestion
+csharp_style_var_when_type_is_apparent = true:suggestion
+csharp_style_var_elsewhere = true:suggestion
+
+# Modern C# expression styles
+csharp_style_expression_bodied_methods = when_on_single_line:suggestion
+csharp_style_expression_bodied_properties = true:suggestion
+csharp_prefer_braces = when_multiline:suggestion
+csharp_using_directive_placement = outside_namespace:suggestion
+dotnet_sort_system_directives_first = true
+
+# Usings
+dotnet_diagnostic.IDE0005.severity = suggestion
+
+# New line preferences
+csharp_new_line_before_open_brace = all
+csharp_new_line_before_else = true
+csharp_new_line_before_catch = true
+csharp_new_line_before_finally = true

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,47 @@
+name: Bug report
+description: Something isn't working as expected
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the report! Netdocs is a spare-time project, so please be patient.
+        A minimal reproduction dramatically increases the odds of a fix.
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened?
+      description: What did you do, what did you expect, and what happened instead?
+      placeholder: When I build a site with ..., I expected ..., but got ...
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      description: Commands, a snippet of `appsettings.json`, and/or the Markdown involved.
+      render: shell
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Netdocs version / commit
+      placeholder: v1.0.0 or commit sha
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: OS / .NET version
+      placeholder: Windows 11 / .NET 11
+    validations:
+      required: false
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs
+      description: Output of the failing command, ideally with `--verbose`.
+      render: shell
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Discord
+    url: https://static.xtremeownage.com/discord
+    about: Questions, ideas, or just saying hi (tag the maintainer).
+  - name: Security vulnerability
+    url: https://github.com/XtremeOwnage/Netdocs/security/advisories/new
+    about: Please report vulnerabilities privately, not as public issues.

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,32 @@
+name: Feature request
+description: Suggest an idea or enhancement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: The use case or pain point behind the request.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: What you'd like Netdocs to do. Config/CLI/API sketches welcome.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other approaches, or how you work around this today.
+    validations:
+      required: false
+  - type: input
+    id: mkdocs-parity
+    attributes:
+      label: Material for MkDocs equivalent (if any)
+      description: A link helps, since Netdocs targets near drop-in compatibility.
+    validations:
+      required: false

.github/dependabot.yml

@@ -24,3 +24,16 @@ updates:
       interval: "weekly"
     commit-message:
       prefix: "ci"
+
+  # Front-end JS/CSS libraries loaded from a CDN, tracked via /package.json.
+  # Dependabot flags new releases here; a maintainer then bumps the matching CDN
+  # URL in the theme templates / plugins. See
+  # docs-site/docs/development/frontend-dependencies.md.
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    commit-message:
+      prefix: "deps(frontend)"
+

.github/pull_request_template.md

@@ -0,0 +1,24 @@
+<!-- Thanks for contributing! Keep PRs focused on one logical change. -->
+
+## What & why
+
+<!-- What does this change and why? Link any related issue: Fixes #123 -->
+
+## Type of change
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Documentation
+- [ ] Refactor / chore
+
+## Checklist
+
+- [ ] `dotnet format Netdocs.slnx --verify-no-changes` passes
+- [ ] `dotnet build Netdocs.slnx -c Release` succeeds
+- [ ] `dotnet test Netdocs.slnx -c Release` passes
+- [ ] Added/updated tests for the change
+- [ ] Updated docs under `docs-site/docs/**` if behavior changed
+
+## Notes for reviewers
+
+<!-- Anything worth calling out: trade-offs, follow-ups, screenshots, etc. -->

.github/workflows/action-selftest.yml

@@ -0,0 +1,49 @@
+name: Action Self-Test
+
+# Exercises the composite action end-to-end (container pull + docker run) against
+# the repo's own docs-site, so the exact path consumers hit is observable in CI.
+on:
+  push:
+    branches: [main]
+    paths:
+      - "action.yml"
+      - ".github/workflows/action-selftest.yml"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  selftest:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Build docs-site via the Netdocs action
+        uses: ./
+        with:
+          command: build
+          config: docs-site/appsettings.json
+
+      - name: Verify output
+        shell: bash
+        run: |
+          set -euo pipefail
+          out="docs-site/site"
+          if [ ! -d "${out}" ]; then
+            echo "::error::Expected build output at ${out} was not produced." >&2
+            exit 1
+          fi
+          count="$(find "${out}" -name '*.html' | wc -l)"
+          echo "Generated ${count} HTML pages in ${out}."
+          test "${count}" -gt 0
+
+          # The social plugin is enabled on docs-site; confirm cards were rendered
+          # inside the container (this is the path that previously crashed on a
+          # missing font).
+          cards="$(find "${out}/assets/social" -name '*.png' 2>/dev/null | wc -l)"
+          echo "Generated ${cards} social card(s)."
+          test "${cards}" -gt 0

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+      - name: Restore
+        run: dotnet restore Netdocs.slnx
+
+      - name: Format check (lint)
+        run: dotnet format Netdocs.slnx --verify-no-changes --no-restore
+
+      - name: Build
+        run: dotnet build Netdocs.slnx -c Release --no-restore
+
+      - name: Test
+        run: dotnet test Netdocs.slnx -c Release --no-build --verbosity normal

.github/workflows/docker.yml

@@ -0,0 +1,47 @@
+name: Docker
+
+on:
+  push:
+    branches: [main]
+    # Full semver tags only; the moving `v1` alias tag should not rebuild images.
+    tags: ["v[0-9]+.[0-9]+.[0-9]+"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  packages: write
+
+env:
+  IMAGE: ghcr.io/${{ github.repository }}
+
+jobs:
+  image:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Docker metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.IMAGE }}
+          tags: |
+            type=ref,event=branch
+            type=ref,event=tag
+            type=sha
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

.github/workflows/docs.yml

@@ -0,0 +1,49 @@
+name: Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # git-revision-date needs full history
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          global-json-file: global.json
+
+      - name: Build docs site
+        run: >-
+          dotnet run --project src/Netdocs.Cli -c Release --
+          build --prod --config docs-site/appsettings.json
+
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs-site/site
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4