博客的内容模型很简单:一切都是文章。机构官网不一样——新闻是文章,产品不是,团队不是,案例也不是。如果硬把所有内容塞进文章系统,分类页会变得莫名其妙。
这一篇讲我怎么给三类内容分层,以及踩到的坑。
一、三层内容模型
| 层 | 内容 | 载体 | 谁在维护 |
|---|---|---|---|
| 动态内容 | 新闻动态 | source/_posts/*.md(文章) |
经常更新 |
| 固定栏目 | 关于我们 / 产品服务 / 联系我们 | source/<slug>/index.md(页面) |
半年改一次 |
| 结构化数据 | 产品列表 / 团队成员 / 合作伙伴 | _config.yml 配置项 |
偶尔增删 |
- 需要独立页面 + 按时间倒序 → 文章(新闻);
- 需要独立页面 + 数量固定 → 页面(关于/联系);
- 不需要独立页面,只在首页露脸 → 配置项(产品卡片、团队成员)。
产品我没有做成文章,因为它不需要详情页(客户习惯在首页看,点进去是联系页)。做成配置项后,客户改一个产品只要改三行 YAML。
二、新闻:文章即动态
新闻列表页用独立 layout:
1 | <%# layout/news.ejs %> |
页面只要在 front-matter 里指定 layout:
1 |
|
卡片渲染读这些字段:
1 | <% if (post.cover) { %> |
1 |
|
cover 和 <!-- more --> 是两个最值得教客户的字段——它们直接决定列表页好不好看。
三、固定栏目:page 形态
关于我们、联系我们这些页面走 page.ejs,它自带页面头图区:
1 | <article class="page"> |
目录约定是一个页面一个目录(产出 pretty URL):
1 | source/ |
写成单文件会得到 /about-us.html,而导航菜单里写的是 /about-us/(带斜杠),链接直接 404。
规则:每个页面建自己的目录,文件一律叫 index.md。
四、真实案例的目录长什么样
以落地的企业站(cn.xongyi.com)为例:
1 | source/ |
注意 search/ 和 categories/ 也是手建的页面目录——分类页和搜索页都需要一个承载页面,否则链接进去是 404。
分类页 / 标签页 / 归档页需要 hexo-generator-category / -tag / -archive,Hexo 核心不带(这一点在 xfm 系列的坑 2 里也提过)。
表现是:页面模板在、菜单链接在,但访问 404。而且 hexo generate 不报错。
五、多语言内容:界面和内容分开
languages/zh-CN.yml 和 en.yml 只管界面文案(”了解更多”、”联系我们”):
1 | <a class="post-card__more" href="<%- url_for(post.path) %>"><%= __('read_more') %><%- icon('arrow-right') %></a> |
文章内容不参与翻译——这是刻意的:机构官网的英文版通常是另一套内容,不是逐句翻译。
做法是两套内容目录 + 两个站点配置(_config.yml 里 language 不同),而不是在单页里塞两种语言。静态站做「同一 URL 双语言切换」的代价很高,机构官网通常不需要。
六、回头看这个模型
最满意的一点:客户新增一条内容永远只需要做一件事——
- 发新闻 → 在
_posts/加一个 md 文件; - 加产品 → 在配置里加三行;
- 加页面 → 建一个目录写
index.md。
不需要理解主题结构,不需要碰模板。这就是第一篇说的「客户要能自己改」落到实处。
系列导航
xongyi 系列总入口 · 上一篇:配置即产品 · 下一篇:零依赖前端
评论