feat(site): initialize Hugo project with Book theme and docs navigation

dndungu · dndungu · commit 974e3184f62e · 2026-03-25T11:15:57.000-07:00
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,4 @@
+public/
+resources/_gen/
+.hugo_build.lock
+.claude/
diff --git a/.gitmodules b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "themes/hugo-book"]
+	path = themes/hugo-book
+	url = https://github.com/alex-shpak/hugo-book
diff --git a/archetypes/default.md b/archetypes/default.md
@@ -0,0 +1,5 @@
++++
+date = '{{ .Date }}'
+draft = true
+title = '{{ replace .File.ContentBaseName "-" " " | title }}'
++++
diff --git a/content/docs/_index.md b/content/docs/_index.md
@@ -0,0 +1,29 @@
+---
+title: Documentation
+weight: 1
+bookToc: false
+---
+
+# Zerfoo Documentation
+
+Welcome to the Zerfoo documentation. Zerfoo is a production-grade ML inference and training framework written entirely in Go.
+
+## Getting Started
+
+New to Zerfoo? Start here:
+- [Installation](/docs/getting-started/installation/)
+- [Quick Start](/docs/getting-started/quickstart/)
+- [Your First Inference](/docs/getting-started/first-inference/)
+
+## Sections
+
+- **[Getting Started](/docs/getting-started/)** - Install and run your first model
+- **[Tutorials](/docs/tutorials/)** - Step-by-step learning guides
+- **[API Reference](/docs/api/)** - Detailed API documentation
+- **[Cookbooks](/docs/cookbooks/)** - Ready-to-use code recipes
+- **[Architecture](/docs/architecture/)** - How Zerfoo works under the hood
+- **[Deployment](/docs/deployment/)** - Production and enterprise deployment
+- **[zonnx](/docs/zonnx/)** - ONNX and SafeTensors to GGUF conversion
+- **[Ecosystem](/docs/ecosystem/)** - ztensor, ztoken, float16, float8
+- **[Contributing](/docs/contributing/)** - How to contribute to Zerfoo
+- **[Reference](/docs/reference/)** - Benchmarks, API stability, migration guides
diff --git a/content/docs/api/_index.md b/content/docs/api/_index.md
@@ -0,0 +1,5 @@
+---
+title: API Reference
+weight: 3
+bookCollapseSection: true
+---
diff --git a/content/docs/architecture/_index.md b/content/docs/architecture/_index.md
@@ -0,0 +1,5 @@
+---
+title: Architecture
+weight: 5
+bookCollapseSection: true
+---
diff --git a/content/docs/blog/_index.md b/content/docs/blog/_index.md
@@ -0,0 +1,5 @@
+---
+title: Blog
+weight: 11
+bookCollapseSection: true
+---
diff --git a/content/docs/contributing/_index.md b/content/docs/contributing/_index.md
@@ -0,0 +1,5 @@
+---
+title: Contributing
+weight: 9
+bookCollapseSection: true
+---
diff --git a/content/docs/cookbooks/_index.md b/content/docs/cookbooks/_index.md
@@ -0,0 +1,5 @@
+---
+title: Cookbooks
+weight: 4
+bookCollapseSection: true
+---
diff --git a/content/docs/deployment/_index.md b/content/docs/deployment/_index.md
@@ -0,0 +1,5 @@
+---
+title: Deployment
+weight: 6
+bookCollapseSection: true
+---
diff --git a/content/docs/ecosystem/_index.md b/content/docs/ecosystem/_index.md
@@ -0,0 +1,5 @@
+---
+title: Ecosystem
+weight: 8
+bookCollapseSection: true
+---
diff --git a/content/docs/getting-started/_index.md b/content/docs/getting-started/_index.md
@@ -0,0 +1,5 @@
+---
+title: Getting Started
+weight: 1
+bookCollapseSection: true
+---
diff --git a/content/docs/reference/_index.md b/content/docs/reference/_index.md
@@ -0,0 +1,5 @@
+---
+title: Reference
+weight: 10
+bookCollapseSection: true
+---
diff --git a/content/docs/tutorials/_index.md b/content/docs/tutorials/_index.md
@@ -0,0 +1,5 @@
+---
+title: Tutorials
+weight: 2
+bookCollapseSection: true
+---
diff --git a/content/docs/zonnx/_index.md b/content/docs/zonnx/_index.md
@@ -0,0 +1,5 @@
+---
+title: zonnx
+weight: 7
+bookCollapseSection: true
+---
diff --git a/hugo.yaml b/hugo.yaml
@@ -0,0 +1,21 @@
+baseURL: https://zerfoo.feza.ai/
+languageCode: en-us
+title: Zerfoo - ML Framework for Go
+theme: hugo-book
+
+params:
+  BookTheme: auto
+  BookToC: true
+  BookSection: docs
+  BookLogo: /logo.png
+  BookMenuBundle: /menu
+  BookSearch: true
+  BookDateFormat: January 2, 2006
+
+markup:
+  goldmark:
+    renderer:
+      unsafe: true
+  highlight:
+    style: monokai
+    lineNos: false
diff --git a/layouts/_partials/docs/html-head.html b/layouts/_partials/docs/html-head.html
@@ -0,0 +1,60 @@
+{{ "<!--" | safeHTML }}
+Made with Book Theme
+https://github.com/alex-shpak/hugo-book
+{{ "-->" | safeHTML }}
+
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<meta name="description" content="{{ or .Description .Summary | plainify | htmlUnescape }}">
+<meta name="theme-color" media="(prefers-color-scheme: light)" content="#ffffff">
+<meta name="theme-color" media="(prefers-color-scheme: dark)" content="#2e3440">
+<meta name="color-scheme" content="light dark">
+
+{{- with .Page.Params.BookHref -}}
+  <meta http-equiv="Refresh" content="0; url='{{ . }}'" />
+{{- end -}}
+
+{{ partial "opengraph.html" . }}
+{{ partial "schema.html" . }}
+
+<title>{{ partial "docs/html-head-title" . }}</title>
+{{ partial "docs/html-head-favicon" . }}
+
+{{- $manifest := resources.Get "manifest.json" | resources.ExecuteAsTemplate "manifest.json" . }}
+<link rel="manifest" href="{{ $manifest.RelPermalink }}">
+<link rel="canonical" href="{{ .Permalink }}">
+
+{{- range .Translations }}
+  <link rel="alternate" hreflang="{{ default .Site.LanguageCode .Language.Lang }}" href="{{ .Permalink }}" title="{{ partial "docs/title" . }}">
+{{- end -}}
+
+<!-- Theme stylesheet, you can customize scss by creating `assets/custom.scss` in your website -->
+{{- $styles := resources.Get "book.scss" | resources.ExecuteAsTemplate "book.scss" . | css.Sass (dict "transpiler" "dartsass") | resources.Minify | resources.Fingerprint }}
+<link rel="stylesheet" href="{{ partial "docs/links/resource-precache" $styles }}" {{ template "integrity" $styles }}>
+
+<!-- Search -->
+{{- if default true .Site.Params.BookSearch -}}
+  {{- $searchJSFile := printf "%s.search.js" .Language.Lang }}
+  {{- $searchJS := resources.Get "search.js" | resources.ExecuteAsTemplate $searchJSFile . | resources.Minify | resources.Fingerprint }}
+  <script defer src="{{ "fuse.min.js" | relURL }}"></script>
+  <script defer src="{{ partial "docs/links/resource-precache" $searchJS }}" {{ template "integrity" $searchJS }}></script>
+{{ end -}}
+
+<!-- Service Worker -->
+{{- if .Site.Params.BookServiceWorker -}}
+  {{- $swJS := resources.Get "sw-register.js" | resources.ExecuteAsTemplate "sw.js" . | resources.Minify | resources.Fingerprint }}
+  <script defer src="{{ $swJS.RelPermalink }}" {{ template "integrity" $swJS }}></script>
+{{ end -}}
+
+{{ partial "google_analytics.html" . }}
+
+<!-- RSS -->
+{{- with .OutputFormats.Get "rss" -}}
+  {{ printf `<link rel="%s" type="%s" href="%s" title="%s" />` .Rel .MediaType.Type .Permalink $.Site.Title | safeHTML }}
+{{ end -}}
+
+{{- define "integrity" -}}
+  {{- if (urls.Parse .Permalink).Host -}}
+    integrity="{{ .Data.Integrity }}" crossorigin="anonymous"
+  {{- end -}}
+{{- end -}}
diff --git a/static/CNAME b/static/CNAME
diff --git a/static/index.html b/static/index.html
diff --git a/static/logo.png b/static/logo.png
diff --git a/static/zerfoo.png b/static/zerfoo.png
diff --git a/static/zerfoo.svg b/static/zerfoo.svg
diff --git a/themes/hugo-book b/themes/hugo-book
@@ -0,0 +1 @@
+Subproject commit 751bde097bc9288666305bdb10c73e491fc43a72

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+[submodule "themes/hugo-book"]`
	`2`	`+ path = themes/hugo-book`
	`3`	`+ url = https://github.com/alex-shpak/hugo-book`