zensical.toml

[project]
site_name = "Edge Computing LLM Documentation"
site_description = "End-to-end documentation for local Ollama GGUF inference on Ubuntu, k3s, and NVIDIA GPUs with an observability stack."
site_author = "Edge-Computing-LLM contributors"
site_url = "https://edge-computing-llm.github.io/"
repo_url = "https://github.com/Edge-Computing-LLM/Edge-Computing-LLM.github.io"
repo_name = "Edge-Computing-LLM/Edge-Computing-LLM.github.io"
edit_uri = "edit/main/docs/"
copyright = "Copyright © 2026 Edge-Computing-LLM contributors"

nav = [
  { "Home" = "index.md" },
  { "Get started" = [
    { "Orientation" = "getting-started/index.md" },
    { "Prerequisites" = "getting-started/prerequisites.md" },
    { "Fresh-clone quickstart" = "getting-started/quickstart.md" },
    { "First inference" = "getting-started/first-inference.md" },
  ] },
  { "Concepts" = [
    { "Architecture" = "concepts/architecture.md" },
    { "Repository map" = "concepts/repository-map.md" },
    { "Ownership boundaries" = "concepts/ownership-boundaries.md" },
    { "Accelerator modes" = "concepts/accelerator-modes.md" },
  ] },
  { "Install" = [
    { "Prepare Ubuntu" = "installation/prepare-host.md" },
    { "NVIDIA substrate" = "installation/nvidia-layer.md" },
    { "LLM and observability" = "installation/observability-layer.md" },
    { "Model profiles" = "installation/model-profiles.md" },
    { "CPU fallback" = "installation/cpu-fallback.md" },
  ] },
  { "Operate" = [
    { "Codex and EdgeProof" = "operations/codex-edgeproof.md" },
    { "Operations runbook" = "operations/runbook.md" },
    { "Access services" = "operations/access-services.md" },
    { "Model lifecycle" = "operations/model-lifecycle.md" },
    { "Storage and upgrades" = "operations/storage-upgrades.md" },
    { "Troubleshooting" = "operations/troubleshooting.md" },
  ] },
  { "Observe" = [
    { "Telemetry flow" = "observability/telemetry-flow.md" },
    { "Metrics and dashboards" = "observability/metrics-dashboards.md" },
    { "GPU observability" = "observability/gpu.md" },
  ] },
  { "Develop" = [
    { "Development setup" = "development/setup.md" },
    { "CLI and Go boundaries" = "development/cli-go.md" },
    { "Tests and evidence" = "development/tests-evidence.md" },
    { "Add a GGUF model" = "development/add-model.md" },
  ] },
  { "Secure" = [
    { "Threat model" = "security/threat-model.md" },
    { "Hardening checklist" = "security/hardening.md" },
    { "Privacy and evidence" = "security/privacy-evidence.md" },
  ] },
  { "Reference" = [
    { "CLI reference" = "reference/cli.md" },
    { "Profiles and services" = "reference/profiles-services.md" },
    { "Test matrix" = "reference/test-matrix.md" },
    { "Validated environment" = "reference/validated-environment.md" },
    { "Glossary" = "reference/glossary.md" },
  ] },
  { "FAQ" = "faq.md" },
]

[project.theme]
language = "en"
logo = "assets/images/mark.svg"
favicon = "assets/images/mark.svg"
features = [
  "content.action.edit",
  "content.action.view",
  "content.code.annotate",
  "content.code.copy",
  "content.tabs.link",
  "navigation.footer",
  "navigation.indexes",
  "navigation.instant",
  "navigation.instant.prefetch",
  "navigation.path",
  "navigation.sections",
  "navigation.tabs",
  "navigation.tabs.sticky",
  "navigation.top",
  "navigation.tracking",
  "search.highlight",
  "toc.follow",
]

[project.theme.icon]
repo = "fontawesome/brands/github"

[project.theme.font]
text = "Inter"
code = "JetBrains Mono"

[[project.theme.palette]]
scheme = "default"
toggle.icon = "lucide/sun"
toggle.name = "Switch to dark mode for Edge Computing LLM docs"

[[project.theme.palette]]
scheme = "slate"
toggle.icon = "lucide/moon"
toggle.name = "Switch to light mode for Edge Computing LLM docs"

[[project.extra.social]]
icon = "fontawesome/brands/github"
link = "https://github.com/Edge-Computing-LLM"
name = "Edge-Computing-LLM on GitHub"

[project.markdown_extensions.abbr]
[project.markdown_extensions.admonition]
[project.markdown_extensions.attr_list]
[project.markdown_extensions.def_list]
[project.markdown_extensions.footnotes]
[project.markdown_extensions.md_in_html]
[project.markdown_extensions.toc]
permalink = true
[project.markdown_extensions.pymdownx.details]
[project.markdown_extensions.pymdownx.emoji]
emoji_generator = "zensical.extensions.emoji.to_svg"
emoji_index = "zensical.extensions.emoji.twemoji"
[project.markdown_extensions.pymdownx.highlight]
anchor_linenums = true
line_spans = "__span"
pygments_lang_class = true
[project.markdown_extensions.pymdownx.inlinehilite]
[project.markdown_extensions.pymdownx.keys]
[project.markdown_extensions.pymdownx.magiclink]
[project.markdown_extensions.pymdownx.superfences]
custom_fences = [{ name = "mermaid", class = "mermaid", format = "pymdownx.superfences.fence_code_format" }]
[project.markdown_extensions.pymdownx.tabbed]
alternate_style = true
[project.markdown_extensions.pymdownx.tasklist]
custom_checkbox = true