This project is a static site built with [aphid](https://github.com/LHelge/aphid), a Rust
static site generator that builds a blog, a wiki, and standalone pages from Markdown files
with `[[wiki-link]]` cross-referencing.
**Keeping these instructions current**: this file and the accompanying skill files are
generated by `aphid agent <tool>` and embedded in the aphid binary. After upgrading aphid,
re-run the same `aphid agent` command — the skill files will be refreshed so they describe
features added by the new release. This main file is preserved on re-run so you can extend
it with project-specific guidance; delete it first if you want a clean regeneration.
# Repository layout
- `aphid.toml` — site configuration (title, base URL, theme directory, authors, socials).
- `content/blog/` — dated blog posts.
- `content/wiki/` — reference / wiki pages.
- `content/pages/` — standalone pages (About, Contact, etc.).
- `content/home.md` — optional home page content.
- `theme/` (or whatever `theme_dir` points at) — Tera templates and static assets.
- `static/` — user static files; copied as-is into the build output.
- `dist/` — generated build output (gitignored).
# Common commands
- `aphid serve` — start the dev server on port 3000 with file watching and live reload. `--port` overrides the port.
- `aphid build` — render the site into `dist/`. `--output <dir>` overrides the directory.
- `aphid new <name>` — scaffold a complete site in a new directory.
- `aphid init [path]` — scaffold a site in the current (or given) directory.
- `aphid blog new "Title"` — scaffold a new blog post (filename gets today's date prefix).
- `aphid wiki new "Title"` — scaffold a new wiki page.
- `aphid page new "Title"` — scaffold a new standalone page.
- `aphid agent <tool>` — regenerate the AI-agent instruction files. `<tool>` is `claude`, `codex`, `copilot`, etc. Pass no tool for a generic `AGENTS.md`. Run this after upgrading aphid to refresh the skill files with any new features.
The global `--config <path>` flag (default `aphid.toml`) overrides the config file location on every subcommand.
# Detailed references
Two topic-specific reference files ship alongside this one. Read the relevant one before
working on a given area:
- **Content authoring** (Markdown, frontmatter, wiki-links, `aphid.toml`) — see the
`aphid-content` skill / instructions.
- **Theme editing** (Tera templates, template variables, static assets) — see the
`aphid-theme` skill / instructions.
The canonical user-facing reference is the wiki under `docs/content/wiki/` if this project
includes one, otherwise see the upstream documentation.