A content-first personal site built with Nuxt 4, Nuxt Content v3 and Tailwind CSS / Nuxt UI. It mixes a trilingual article stream and public learning series with a digital garden of interlinked concept notes, entities, and project pages. Content is authored in Obsidian — the sibling ../folio/content/ is the active Obsidian vault.
Live at: https://parz1.minerei.dev
- Framework — Nuxt 4 (Vue 3, TypeScript), pnpm-managed
- Content — @nuxt/content v3 with a Zod-validated multi-collection schema
- UI — Nuxt UI, Tailwind CSS 4, SCSS, GitHub-flavoured markdown typography
- i18n — @nuxtjs/i18n (English / 简体中文 / 日本語); content localized per-language as separate markdown variants
- CMS — Folio for Markdown, assets and publication
- Analytics — @vercel/analytics + speed-insights
Paths below are relative to the Folio project root.
| Collection | Path | Purpose |
|---|---|---|
articles |
content/blog/articles/ |
Essays, logs, and loose thoughts selected by kind |
columns |
content/blog/columns/ |
Ordered public learning paths and planned chapters |
concepts |
content/concepts/ |
Digital-garden notes, linked via [[wikilinks]] |
entities |
content/entities/ |
Knowledge-graph nodes (tools, standards, instruments…) |
projects |
content/projects/ |
Projects bound to GitHub repos |
Schemas and validation live in content.config.ts.
Every Markdown document in the Folio vault declares an ordered authors list. List order determines first/second author; optional roles record contributions such as idea, writing, and editing. See the coauthorship guide for Koto/parz1 examples, and run pnpm test:authors when changing attribution.
Open ../folio/content/ as the Obsidian vault. The content:file:beforeParse hook (utils/rubyHook.ts) converts on build:
{漢字|かな}→<ruby>furigana annotations[[wikilink]]→ internal links to/concepts/…or/blog/…
Use pnpm (the lockfile is pinned; hoisting is required by some native deps):
pnpm install --shamefully-hoistpnpm dev # dev server on http://localhost:3000
pnpm build # production build
pnpm generate # static export (nuxt generate)
pnpm preview # serve the production build locallyAfter adding Nuxt modules or changing content collections, refresh generated typings:
pnpm exec nuxt preparepnpm lint # oxlint
pnpm lint:fix
pnpm format # oxfmt (writes)
pnpm format:checkCopy .env.example to .env and fill in what you need:
NUXT_GITHUB_TOKEN— server-side GitHub status for project pages (no anonymous fallback)
docs/cloudflare-preview.md— isolated Cloudflare test deployment and Web Analyticsdocs/gallery-media-workflow.md— gallery media pipelinedocs/concept-note-template.md— concept-note templateAGENTS.md— repository guidelines for agents & contributors
Folio owns Markdown, translations, assets and publishing. Nuxt Content loads the sibling ../folio/content/ vault during development, including drafts. Set CONTENT_WORKSPACE_DIR to the parent of another vault named content. Production reads published Folio releases and includes a validated snapshot for outages. Use pnpm write for local authoring and the Folio editor to confirm publication.
See the writing guide and production and rollback guide.