首页/ 博客/ 内容架构
内容架构

新闻和博客不该写死在 HTML 里:QuickQ 内容中心的 JSON 方案

首页没有新闻和博客模块,也不该硬塞一个。把内容放进独立页面和两个 JSON,后期替换只需要改数据,不用碰布局。

QuickQ 订阅页面设备示意
QuickQ 订阅页面设备示意

原站首页没有新闻和博客模块。需求里要求这两块内容结构清晰、后期能直接替换,我一开始想过在首页 FAQ 后面加一个资讯区。试排了一版就放弃了:首页是 01 到 11 的固定顺序,突然插一块内容,节奏会断,后面维护也容易把首页和内容页混在一起。

最后做成独立内容中心:news.html、blog.html 和 article.html,首页页脚只加入口。新闻和博客分别放在 data/news.json、data/blog.json,页面本身不写死任何一条内容。

数据长什么样

字段不复杂:slug、category、date、title、excerpt、image、imageAlt、author、readTime,再加一个 body 数组。正文只认四种块:段落 p、小标题 h2、列表 ul、引用 quote。这样内容人员改文字时不用碰 HTML,也不会把布局标签带进去。

列表页由 content.js 渲染。第一条自动成为精选,分类从数据里去重生成,搜索框在标题、摘要和分类里做匹配。详情页地址是 article.html?type=news&slug=...,找不到内容就显示 404 卡片,不跳空白页。新闻和博客共用一套渲染器,只有数据文件不同。

没有后台,也没有构建步骤

这批内容一共 8 条,4 条新闻加 4 篇博客。没有后台、没有构建步骤,编辑一个 JSON 就能发布,成本最低。代价是页面依赖 fetch,必须用本地 HTTP 服务打开,不能直接双击 file://;另外列表是客户端渲染,SEO 不如预渲染。

这个取舍我想过。如果以后内容涨到几百条,或者搜索流量变成主要入口,再把 JSON 换成一个轻量 CMS 或做静态预渲染,渲染层不用重写。现在这个规模,一份 JSON 加一个渲染器就够了。

做完后检查了 9 个页面:没有缺失的本地引用,没有重复 ID,所有图片都有 alt。新闻和博客的筛选、搜索、详情、404 都走通了。内容维护这件事,结构越小越容易长期用。

继续阅读

全部博客 →