文档首页
说明
本站 website 代码仓库暂未开放，文档仅供参考。
jimmysong.io 是一个基于 Hugo Extended 的多语言内容平台（英文为默认语言、中文在 /zh/），衍生自 Hugo Blox / Educenter 主题并重度定制，部署在 Cloudflare Pages。
快速入口¶
| 我想… | 去哪 |
|---|---|
| 本地跑起来 | 快速开始 |
| 写文章 / 内容 | 内容创建 |
| 用 Shortcode | Shortcode 总览 |
| 理解架构 | 架构概览 |
| 跑构建/部署 | 构建流程 |
| 用工具（PDF/RAG/图片） | PDF 导出器 |
| 排错 | 故障排除 |
站点实际速查¶
- 语言：英文在根（无前缀），中文在
/zh/（DefaultContentLanguage=en，defaultContentLanguageInSubdir=false）。 - 内容类型：blog、book、podcast（仅 zh）、ai 资源、analysis、glossary、slide、notice 等。
- Shortcode：共 15 个（
layouts/shortcodes/），见 总览。 - 工具：
tools/下 10+ 个（pdf-book-exporter、rag-worker、ai-oss-rank、wechat-markdown-exporter、convert-images-to-webp、tunnel-manager 等）。 - 脚本：
scripts/{ai,content,docs,site}/，构建/内容/分析自动化。 - 构建：
make dev/make server/make build/npm run site:build:production。 - 部署：Cloudflare Pages（preview + production）。
本文档结构¶
- 内容创作 — 写作、内容类型、Front Matter CMS、AI 资源。
- Shortcode — 15 个组件的权威参考。
- 功能特性 — 内容分析、图片优化、PDF 导出、液态玻璃、懒加载等。
- 开发者指南 — 环境、架构、构建、Cloudflare、缓存、文档维护。
- 工具 — 各工具与 RAG Worker、AI 原生全景图。
- 工作流 — 图片上传、链接检查、Markdown 导出等流程。
- 参考文档 — 配置、Makefile、命令速查、故障排除、更新日志。
完整导航见左侧侧栏。开始前建议先读 项目概览。