昔枫沐杰

昔枫沐杰是什么

昔枫沐杰是一个静态博客站点，站点语言为zh_CN。内容以技术笔记和生活记录为主，文章通过Markdown源文件构建，经生成器编译后输出纯HTML页面。

页面不依赖数据库。每次访问读取的是预生成文件。

这里有个细节：站点没有后台管理面板，发布新内容依靠本地编辑加构建部署。

昔枫沐杰主要功能

• 文章渲染：读取Markdown源文件，把标题、正文、代码块、引用等元素转成HTML标签，输出可被浏览器直接解析的静态页面，单篇文章生成耗时通常在毫秒级。
• 代码高亮：识别代码块中的语言标记，按对应语法规则着色，输出带class的span标签，支持的语言由高亮库版本决定，未标记语言的代码块按纯文本输出。
• 标签归档：按文章front-matter里的tags字段归类，生成标签索引页，每个标签下挂对应文章链接列表，标签数量上限取决于构建时内存。
• 分页输出：把文章列表按固定条数切分，生成page/2、page/3等路径，每页条数在配置文件里设定，默认每页10条。
• RSS订阅：把最近发布的文章标题、摘要、链接写进XML文件，输出符合RSS 2.0规范的feed，条目数量由配置项控制。
• 站内搜索：构建时生成文章索引JSON，前端加载后做本地匹配，输入关键词返回标题和路径，索引体积随文章总量线性增长。

昔枫沐杰使用要求

运行环境需要Node.js。版本一般不低于16.x，低版本可能在依赖安装阶段报错。

构建前要装依赖包。npm install会读取package.json拉取全部模块。

有一点需要注意：文章源文件必须带front-matter头。缺title或date字段时，构建流程可能跳过该文件。

输出目录是纯静态资源。部署时只需要HTML、CSS、JS和图片文件，不需要服务端运行时。

昔枫沐杰核心优势

构建产物是纯静态文件。没有数据库查询，没有服务端渲染，页面响应取决于文件读取和网络传输。并发访问时压力落在CDN或静态托管服务上，源站负载低。

内容与呈现分离。文章写在Markdown里，样式和布局由模板控制。改主题不动正文，改正文不碰模板。

昔枫沐杰如何使用

写新文章：在source目录下建.md文件，顶部补上title、date、tags字段，正文用Markdown语法写。

本地预览：执行构建命令后启动本地服务，浏览器打开localhost对应端口查看效果。

生成站点：运行build命令，输出文件进public目录，命令执行完即可部署。

发布更新：把public目录整体上传到静态托管服务，覆盖旧文件。

昔枫沐杰同类竞品对比

首页截图