Skip to content
parz1Public

About

blog build with nuxt

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

239 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

parz1 ZHOU — Personal Site & Digital Garden

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

Stack

  • 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

Content collections

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.

Obsidian authoring

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/…

Setup

Use pnpm (the lockfile is pinned; hoisting is required by some native deps):

pnpm install --shamefully-hoist

Development

pnpm dev        # dev server on http://localhost:3000
pnpm build      # production build
pnpm generate   # static export (nuxt generate)
pnpm preview    # serve the production build locally

After adding Nuxt modules or changing content collections, refresh generated typings:

pnpm exec nuxt prepare

Quality

pnpm lint          # oxlint
pnpm lint:fix
pnpm format        # oxfmt (writes)
pnpm format:check

Configuration & secrets

Copy .env.example to .env and fill in what you need:

  • NUXT_GITHUB_TOKEN — server-side GitHub status for project pages (no anonymous fallback)

Documentation

Writing and publication

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.

About

blog build with nuxt

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages