mirror of
https://github.com/zenlm/zen-blog.git
synced 2026-07-27 03:09:00 +00:00
Hanzo Dev
b31112a90a
- Replace Hugo static site generator with Next.js 15 + fumadocs-mdx - Convert 71 blog posts from Hugo format to MDX/MD - Convert Hugo shortcodes (figure, button, video, example, fullwidth) to MDX components (Figure, LinkButton, Video, Fullwidth) - Add remark-math + rehype-katex for LaTeX math rendering - Copy JSON case files to public/cases/ for reference - Update branding for Zen LM (site-nav, footer, metadata) - Static export for Cloudflare Pages deployment - Chinese (.zh.md) translations deferred for future migration
2.2 KiB
2.2 KiB
zen-blog -- AI Knowledge Base
Project: zen-blog Organization: zenlm Repository: https://github.com/zenlm/zen-blog Domain: https://blog.zenlm.org Last Updated: 2026-03-26
Overview
zen-blog is the Zen LM blog, built with fumadocs + Next.js (static export). Deployed to Cloudflare Pages.
Architecture
- Framework: Next.js 15 + fumadocs-mdx 11 + fumadocs-core 15
- Content: MDX and Markdown files in
content/ - Output: Static export (
output: "export") - Styling: Tailwind CSS 4 + shadcn/ui components
- Math: remark-math + rehype-katex (KaTeX rendering)
- Code highlighting: Disabled (rehypeCodeOptions: false) due to Shiki/math incompatibility
Content Format
Posts are stored as content/{slug}.mdx or content/{slug}.md:
---
title: "Post Title"
date: "YYYY-MM-DD"
description: "Post description"
author: "Author Name"
tags: ["tag1", "tag2"]
---
MDX posts can use custom components: <Figure />, <LinkButton />, <Video />, <Fullwidth>.
Markdown posts use standard markdown only (no JSX).
Posts with bare < in text or complex math use .md extension (not .mdx) to avoid JSX parsing issues.
Commands
npm run dev # Development server
npm run build # Production build (static export to out/)
npm start # Serve built site
Deploy
wrangler pages deploy out --project-name zen-blog --branch main
Migration History
- 2026-03-26: Migrated from Hugo (PaperMod theme) to fumadocs + Next.js
- Converted 71 blog posts from Hugo format
- Hugo shortcodes (figure, button, video, example, fullwidth) converted to MDX components or markdown
- Chinese (.zh.md) translations not migrated (English-only for now)
- JSON case files moved to
public/cases/
Rules for AI Assistants
- ALWAYS update LLM.md with significant discoveries
- NEVER commit model weights (*.safetensors, *.bin, *.gguf, *.pt)
- NEVER commit symlinked files (CLAUDE.md, AGENTS.md, GEMINI.md, QWEN.md)
- NEVER create random summary files -- update THIS file only
- Zen models are based on Qwen3 architecture
Context
This file (LLM.md) is symlinked as CLAUDE.md, AGENTS.md, GEMINI.md, QWEN.md.
Part of the Zen AI family -- Clarity Through Intelligence