纯静态内容站:52 篇章节自动生成,零框架零依赖产品系统

我要开发同款
Nebula2026年11月14日
7阅读

技术信息

语言技术
Python、HTML5、CSS、JavaScript
系统类型
Web
行业分类
企业服务

作品详情

行业场景

这个站最初是为了把 52 篇长文按章节稳定地发布出来,而不是每写一篇就手工复制一遍模板。当时的需求很具体:页头页脚导航必须完全一致、章节之间能互相跳转、不能引入构建工具和前端框架。目标是用一个生成脚本把 Markdown 源批量转成静态页面,同时保持全站视觉与交互的统一。

功能介绍

1、批量生成模块:读取 Markdown 源文件,批量产出 52 个章节页与目录页,自动生成面包屑、上一篇下一篇、章节编号。
2、统一外壳模块:所有页面共用同一套页头、导航、页脚与状态栏,新增章节时只需重跑生成脚本。
3、设计系统模块:用 CSS 变量统一管理颜色、字号、间距与边框,列表、卡片、状态灯、表格复用同一套组件类。
4、划线批注模块:正文选中文字即可划重点并写备注,本地缓存与服务端同步双写,支持按记录 id 合并与删除。
5、数据安全模块:服务端写入采用原子替换,读取失败与空数据严格区分,避免一次读取异常清空用户批注。
6、检索模块:全站注入离线性本地词库,任意页面右键或双击英文单词即可查词,不依赖第三方接口。
7、质量检查模块:内置坏链检查脚本,每次改动后全站扫描内部链接,确保交付时坏链为 0。

项目实现

我独立负责该项目的全部环节:内容结构、生成脚本、前端实现与数据同步。
1、内容结构:把 52 篇文章统一为同一套 Markdown 约定(标题层级、脚注、引用),便于脚本解析。
2、生成脚本:用 Python 写生成器,读取源文件并套用页面模板,产出章节页与目录页,避免任何前端构建链。
3、前端实现:原生 HTML、CSS、JavaScript,无框架、无依赖,单页体积保持在几十 KB。
4、设计系统:用 CSS 变量做设计令牌,所有页面共享,改一处全站生效。
5、划线批注同步:localStorage 本地缓存加服务端接口双写,按记录 id 合并,删除走独立接口。
6、数据安全:服务端原子写与读坏容错,客户端在服务端返回空数据时不覆盖本地,防止数据被清空。
7、质量保障:写坏链检查脚本,对全部内部链接做一次扫描,交付前后各跑一次。

示例图片

声明:本文仅代表作者观点,不代表本站立场。如果侵犯到您的合法权益,请联系我们删除侵权资源!如果遇到资源链接失效,请您通过评论或工单的方式通知管理员。未经允许,不得转载,本站所有资源文章禁止商业使用运营!
下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态

评论