Draft marketing content across channels — blog posts, social media, email newsletters, landing pages, press releases, and case studies. Use when writing any marketing content, when you need channel-specific formatting, SEO-optimized copy, headline options, or calls to action.
系统内核更新与内容迭代
王小泽的知识库现在运行在新的系统内核上:后端使用 Mix Space Core,前端使用 Shiro。两个都是成熟的开源项目,本站按自己的内容分类、阅读习惯和维护需求做了调整。
这次变动不是版本升级:换掉的是支撑内容的系统,同时文章的分类、专题和查找路径也重新整理了一轮。写作方向没有变,这里仍然记录技术学习、工程实践、部署排障,以及值得留存的生活片段;变的是内容怎么管理、发布后怎么呈现,以及读者从哪里找到它。
一、为什么要换
Rspress 阶段先解决了一个问题:把散落在博客列表里的技术笔记整理成按专题阅读的文档。技能小册适合顺着章节看,排错笔记适合按问题查,团队文档则要先找到协作主题,再进入具体流程。这些组织经验会继续保留。
换内核并不是因为 Rspress 做不了文档站,而是本站要同时照顾两种阅读场景:既要有适合连续查阅的长篇技术内容,也要有适合单篇发布的公告、复盘和随笔。
旧站怎么发布
文章、导航和界面配置一起放进静态构建流程。增加一篇文章或调整一个入口,通常都要改仓库里的文件,再随站点整体构建发布。章节关系稳定的文档这样很直观;但文章经常要改分类、补充背景、修订排错结论时,内容维护和前端构建绑在一条流程里,就会多出不少日常摩擦。
现在怎么分工
改正文、补分类、修订一篇笔记,是内容维护;改首页布局、阅读样式或交互,是前端维护。两者不必再默认绑在一次改动里。
相应地,新内核也有更多要照看的部分:除了前端,还要维护后端服务、数据和资源备份,并检查两端升级后的兼容性。这是用更多运行维护成本,换取更独立的内容发布和界面迭代。
二、系统结构
现在的结构可以按三层来看:内容后端、阅读前端,以及本站自己的定制。
层级
项目
在本站的职责
内容后端
Mix Space Core
管理文章等站点内容与相关信息,向前端提供内容接口。
阅读前端
Shiro
获取并展示后端内容,承载首页、导航、文章列表和正文阅读页面。
站点定制
王小泽的知识库
在上游项目基础上,按知识库的使用场景调整入口、专题组织和阅读体验。
简单来说,一篇笔记在内容侧维护,前端从接口取回后再呈现给读者。以后整理同一个主题,可以分别考虑两件事:它在内容上该归到哪里,读者又该从哪里进入。
本站定制的重点是三件事:
Shiro 和 Mix Space Core 提供的是基础,实际栏目、页面入口和可用功能以本站页面为准,不等同于上游项目的全部能力。
三、内容分区
下面是内容的归类方式,不是对菜单名称或路径的承诺。原来依赖固定目录和侧栏的内容,会结合新的导航、分类和文章内链接逐步整理。
内容分区
主要收录
推荐的查找方式
站点指南
站点介绍、阅读说明、反馈方式
第一次来访时,从首页或站点介绍了解内容分布。
技能小册
前端、工程化、后端、数据库等学习笔记与系列教程
先找系列名或专题索引,再按文章顺序阅读。
服务与运维
部署、自托管、技术调研和故障排查
用工具名或具体报错找单篇,例如 Docker、1Panel、CNB。
团队文档
协作流程、规范、工具和工作记录
仍按协作主题整理,可从服务与运维相关内容查找,不必依赖原来的目录地址。
生活记录
日常随笔、生活日志和《临终前的回溯》等系列
按系列名或文章标题查找,不与技术教程混在一起。
系统公告
架构调整、栏目变化等影响读者的变更
查看公告了解站点级调整;普通文档的勘误与补充直接更新原文。
如果你在补一门技术,不妨从系列入口开始,先看前置知识和章节顺序;如果只是想解决一个故障,优先找完整报错、工具名或版本号,找到笔记后先核对文中记录的环境,再判断当时的结论是否适用于现在。
四、不只是搬正文
静态文档站的目录本身就包含信息:文件夹决定文章归属,侧栏体现章节顺序,标题锚点还可能被其他文章引用。换成新内核后,这些关系不能只靠搬运正文解决,整理时分成两层来看。
内容关系
呈现细节
五、旧链接与搜索
以往收藏的 wangxiaoze.cn/know 下的深层地址,可能仍指向旧版的专题路径。新的内容路由和分类不一定与旧目录一一对应,这次也不承诺每个旧地址都有自动跳转。搜索引擎的索引更新通常也有延迟,短时间内看到旧标题或旧地址并不罕见。
遇到旧链接打不开时,可以这样处理:
六、接下来做什么
近期
长期
日常维护会按新流程走:内容修订、前端调整和上游升级分别检查,后端数据与资源备份也在维护范围内,而不只是确保页面能打开。
七、常见问题
是版本升级吗
不是。换掉的是支撑内容的系统,文章的分类、专题和站内链接也随之整理了一轮,站点记什么、怎么写并没有变。原来的 Rspress 选型和目录约定属于旧站阶段,不再作为现在的使用说明。
导航和快捷键还一样吗
不一定。旧站的顶栏、固定侧栏和 ⌘K / Ctrl+K 属于当时的前端实现,不应视为现在的承诺。查找内容以当前页面提供的入口为准。
旧文还能照着做吗
请先看文章的写作背景和工具版本。学习笔记和排错记录说明的是特定环境下的做法;遇到版本差异时,建议对照工具的最新文档,再决定是否沿用。
以后哪里看更新
站点架构、栏目或访问方式的重要变化会通过系统公告说明;补充示例、修正笔误和更新命令等日常修订,直接落在相关原文里。
怎么反馈问题
欢迎通过 GitHub:@wangxiaoze-view 或本站已有的联系方式反馈。附上问题页面、新旧链接或截图中的具体位置即可;如果是移动端显示问题,补充设备和浏览器会更容易复现。
感谢 Mix Space Core 与 Shiro 的开发者和贡献者,也感谢一直收藏、分享和帮忙纠错的读者。