Documentation Index

This note maps the documentation base by subject. Each entry links to a dedicated note, and the glossary defines the technical terms that recur across notes. The notes assume a working Hugo site built with PKB-theme: content creation and theme machinery first, then deployment, then the self-hosted services (analytics, ecommerce) the theme integrates with.

Hugo and theme development

• How the Hugo System Works (2026-07-29): the dated architecture reference for the whole setup: version floor, module and config model, templates, content pipeline, and CI.
• Creating Posts with Hugo: the content workflow, from archetypes and front matter to page bundles.
• Quarto Basics with PKB Theme: authoring and publishing Quarto documents, with the Quarto Test Sample showing a rendered .qmd page.
• Hugo SEO Implementation Guide: the meta tags, Open Graph, JSON-LD, and sitemap machinery built into the theme.
• Development Tips: day-to-day practices for working on the theme itself.
• SOTA: Hugo Static Site Generator: a fully sourced survey of Hugo through v0.164.0, with an upgrade plan grounded against this theme.

Deployment and hosting

• Hosting Your Hugo Site: hosting-platform comparison and deployment steps.
• Setting up GitHub Pages: first-time GitHub Pages setup for a Hugo site.
• GitHub Pages with Hugo: the Hugo-specific CI build and deploy pipeline.
• Deploying with exampleSite: using the bundled exampleSite as a deployment template.

Analytics

• Self-Hosted Analytics for PKB-theme: choosing and wiring a privacy-friendly analytics backend.
• Analytics Configuration: the theme’s analytics params and supported providers.
• Matomo Analytics Setup Guide: a full Matomo self-hosting walkthrough.
• Reverse Proxy Configuration for Analytics: serving analytics first-party through your own domain.

Ecommerce

• Self-Hosted Ecommerce Solutions: comparison of the store platforms the notes integrate.
• OpenCart Integration Guide: connecting an OpenCart store to the theme.
• PrestaShop Integration Guide: connecting a PrestaShop store to the theme.
• Saleor Integration Guide: connecting a Saleor storefront to the theme.

Theme components

• Color Theme Customization: overriding the theme’s color schemes.
• Gallery Slider Documentation: the gallery-slider shortcode and its options.
• Portfolio Usage: the portfolio content type and its templates (draft, unpublished).
• Text to Speech: the browser-native read-aloud feature and its voice strategy.

Glossary

Terms are listed alphabetically. Each entry gives a short definition followed by links to the notes that cover the term in depth; the glossary disambiguates, the notes explain.

Archetype: the template Hugo uses to seed a new content file created with hugo new. See Creating Posts with Hugo.

Chroma: the syntax highlighter built into Hugo; the theme drives it class-based with generated dark/light style pairs that follow the color-scheme toggle. See How the Hugo System Works, SOTA: Hugo.

Zettelkasten Method

The Zettelkasten method is a powerful note-taking and knowledge management system developed by German sociologist Niklas Luhmann.

What is Zettelkasten?

Zettelkasten (German for “slip box”) is a method that emphasizes:

1. Atomic notes (one idea per note)
2. Explicit connections between notes
3. Emergent structure through links

For formatting your Zettelkasten notes, see our Markdown reference.

Core Principles

Atomic Notes

Each note should contain exactly one idea, making it easier to connect and recombine.

Digital Garden Guide

Digital gardens represent a new approach to personal websites—less blog, more evolving collection of notes and ideas. For guidance on formatting your digital garden entries, refer to our comprehensive Markdown Boilerplate.

What is a Digital Garden?

A digital garden is a collection of notes, essays, and ideas that aren’t necessarily finished or polished. Unlike blogs organized chronologically, digital gardens organize content by topic and connections.

For a broader context on knowledge management, see our Personal Knowledge Base guide. The proper formatting of your garden notes is crucial—our Markdown Boilerplate provides all the syntax examples you’ll need.

Building a Personal Knowledge Base

A personal knowledge base (PKB) is a system for storing, organizing, and retrieving your knowledge and ideas. This post explains how to build one effectively.

What is a Personal Knowledge Base?

A PKB is a personalized system that helps you collect, connect, and cultivate your ideas and information. Unlike traditional note-taking, a PKB emphasizes connections between concepts.

For formatting your notes properly, refer to our Markdown tester guide.