把个人博客改造成共创博客：一次 Jekyll/TeXt 实战记录

这篇文章记录一次很小、但很有意义的博客改造：把一个原本偏个人表达的 GitHub Pages 博客，调整成由 wuli 和 cc00mi 共创的博客。

目标不是大动干戈重写主题，而是在尽量尊重原有仓库结构的前提下，让博客具备“多作者身份”“文章署名”“关于我们说明”和“可持续发布流程”。

1. 改造目标

这次改造希望达成四件事：

博客整体身份从“个人博客”变成“共创博客”。
文章可以区分作者，例如 wuli 或 cc00mi。
关于页不再是主题默认介绍，而是展示共创者信息。
后续发布文章时，只需要在 Front Matter 中声明作者即可。

最终采用的是 Jekyll 原生能力和 TeXt 主题已经预留的作者机制。

2. 先确认博客技术栈

当前博客是一个 GitHub Pages + Jekyll 项目，主题结构接近 TeXt。

关键目录如下：

.
├── _config.yml
├── _data
│   ├── authors.yml
│   └── navigation.yml
├── _includes
├── _layouts
├── _posts
└── about.md

其中最重要的是：

_config.yml：站点级配置，比如标题、描述、默认作者、文章默认布局。
_data/authors.yml：作者资料库。
_posts：文章目录。
about.md：关于页。

TeXt 主题内部已经会读取文章 Front Matter 中的 author 字段，并通过 site.data.authors[page.author] 找到对应作者信息。

这意味着我们不需要重写复杂模板，只要把作者数据补齐即可。

3. 修正站点默认作者配置

原配置中作者信息位置不完全符合主题预期。

主题通常会读取：

author:
  name: wuli

因此需要在 _config.yml 中确保站点作者字段是 author:，而不是任意自定义键名。

同时，把站点标题和描述调整为共创博客语义：

title: fox小栖共创博客
description: >
  wuli 和 cc00mi 共创的技术、工具与探索笔记

author:
  type: person
  name: wuli
  url: https://wuli-git.github.io
  avatar: "/assets/头像.png"
  bio: 做一个诗意，浪漫，自律的人.
  email: 1328433750@qq.com
  github: wuli-git

这里的 author 更像是站点默认作者，也会被页脚、默认文章信息等位置使用。

4. 增加作者资料库

接下来编辑 _data/authors.yml，加入两位作者。

wuli:
  type: person
  name: wuli
  url: https://wuli-git.github.io
  avatar: /assets/头像.png
  bio: 做一个诗意，浪漫，自律的人.
  email: 1328433750@qq.com
  github: wuli-git
  npm: http://106nixi213493.vicp.fun

cc00mi:
  type: person
  name: cc00mi
  url: https://github.com/cc00mi
  avatar: /assets/cc00mi-avatar.png
  bio: explore anything new!
  github: cc00mi

这里有一个实践细节：头像最好放在 assets 目录下，而不是放在 _posts 目录里。

例如：

assets/cc00mi-avatar.png

这样引用路径更稳定，也更符合静态站点资源管理习惯。

5. 给文章设置默认作者

为了避免历史文章没有作者字段时显示异常，可以给所有文章配置默认作者。

在 _config.yml 的 defaults 中加入：

defaults:
  - scope:
      path: ""
      type: posts
    values:
      layout: article
      author: wuli
      sharing: true
      license: true
      aside:
        toc: true
      show_edit_on_github: true
      show_subscribe: true
      pageview: true

这样，老文章即使没有写 author，也会默认归属到 wuli。

新文章如果是 cc00mi 发布，只需要显式写：

---
title: 文章标题
author: cc00mi
---

6. 重写关于页

原来的 about.md 还是主题默认说明，不适合作为共创博客的门面。

因此将其改成“关于我们”：

# 关于我们

这里是 wuli 和 cc00mi 共创的个人博客：记录技术实践、工具体验、学习笔记，以及那些值得被认真探索的新东西。

## 共创者

### wuli

做一个诗意，浪漫，自律的人。

### cc00mi

explore anything new!

关于页承担的是“这个站点是谁和谁一起维护、为什么存在、会写什么”的说明作用。

这是共创博客非常重要的一步，因为它让访问者能立刻理解站点身份。

7. 发布新文章的方式

以后发布文章，只需要在 _posts 目录中新建 Markdown 文件。

命名格式：

YYYY-MM-DD-文章标题.md

例如：

2026-05-14-把个人博客改造成共创博客.md

文章头部写：

---
title: 把个人博客改造成共创博客：一次 Jekyll/TeXt 实战记录
tags: Jekyll GitHub-Pages Blog
author: cc00mi
---

这里有一个非常重要的坑：文章日期不要写成未来日期。

Jekyll 默认不会发布未来日期的文章。也就是说，如果今天是 2026-05-14，而文件名写成：

2026-05-18-xxx.md

那么文章在 GitHub 仓库里能看到，但博客页面不会显示。等到日期到达，或者开启 future: true 后才会被构建出来。

更推荐的做法是：当天发布就使用当天或过去日期。

8. Git 提交与推送

本地写完后，使用 Git 提交：

cd F:\wuli00\wuli-git.github.io
git status
git add _config.yml _data/authors.yml about.md assets/cc00mi-avatar.png
git add _posts/2026-05-14-把个人博客改造成共创博客.md
git commit -m "Add co-created blog setup post"
git push origin master

推送后，GitHub Pages 会自动构建并发布。

一般几十秒到几分钟后就能在博客中看到新文章。

9. 这次改造后的效果

完成后，博客具备了这些能力：

站点标题和描述体现共创属性。
作者信息集中维护在 _data/authors.yml。
文章可以通过 author: cc00mi 指定署名。
历史文章默认归属 wuli。
关于页展示两位共创者，而不是主题默认内容。
后续新增作者时，只需要继续扩展 _data/authors.yml。

这是一种比较轻量的改造方式：不破坏主题、不重写布局，但把博客从“一个人的空间”推进成了“可以共同生长的空间”。

10. 后续可以继续增强什么

当前方案是单作者署名。如果未来需要更完整的共创能力，可以继续做这些增强：

支持一篇文章多个作者，例如 authors: [wuli, cc00mi]。
新增作者列表页，例如 /authors.html。
为每位作者生成独立归档页。
在文章底部显示作者卡片。
在导航栏加入“共创者”入口。

但对当前阶段来说，最重要的是先把发布流程跑顺。

一个博客不必一开始就复杂。它可以先拥有清晰的身份、稳定的写作入口，然后在一次次发布里慢慢长出自己的形状。

PREVIOUSCodex做一个桌宠使用体验

NEXT流式输出