人物信息编辑

人物条目无法直接创建，只能在编辑电影/电视剧的演职员表时，点击 Add a New Cast/Crew Member 创建。

姓名（Name）

• 填写该人物的主要艺名
• 如果艺名发生过线性变更（如改名），使用当前使用的名字
• 如果同时使用多个名字，选择最常用、官方网站/社交账号使用的名字
• 已故人物使用最广为人知的名字
• 姓名不需要唯一，不要添加罗马数字后缀（如 John Doe (IV)）

译名（Translated Name）

中文人物的译名示例：

1
2

中文名 → 王一博 → 姓 [王] + 名 [一博] → Wang Yibo（东方顺序）
中文名 → 甄子丹 → 姓 [甄] 英文名 [Donnie] → Donnie Yen（西方顺序）

东亚人名规则：

传记（Biography）

• 保持中立客观，不要写成宣传文案
• 不要使用”currently starring”、”will star”等时效性表述
• 不要添加引用标记（如 [1] [2]）
• 不要添加链接
• 允许从 Wikipedia 复制，但必须标注来源，并删除引用编号
• 禁止从 IMDb 或其他受版权保护的网站复制

出生地与生日

出生地格式：城市, 省/州, 国家

1
2
3

Liverpool, England, UK
Paris, France
New York City, New York, USA

如果地名已变更，在方括号中注明：Madras, Tamil Nadu, India [now Chennai]

如果只知道出生年份（如 1968），日期填为 1968-01-01。

性别

填写个人自我认同的性别，而非出生指派性别。

如果需要修改某位人物的性别字段，请使用 Report 按钮提交。

主页

• 只填写该人物的官方网站
• 不允许粉丝站、IMDb/Wikipedia、社交媒体（Facebook/Twitter/Instagram/YouTube）
• 成人演员不允许添加含会员付费区的链接

翻译维护规范

中文翻译规则

TMDB 支持四种中文翻译：

不要跨区填写。电影只在大陆上映过，就不要在 zh-TW 里填大陆译名。

简介翻译

• 用自己的话翻译，不要机翻
• 保持简洁、无剧透
• 没有官方译文的留空

译名锁定规则

当译名与原名完全相同时，译名字段应该留空并锁定。例如：

• 英文电影的 English Translated Title 字段 → 留空锁定
• 泰语电影的 ภาษาไทย 字段 → 留空锁定

通用社区准则

禁止行为

1. 禁止发布粗俗或攻击性语言
2. 禁止发布或索要受版权保护的非合理使用内容
3. 禁止发布 NSFW 内容（成人专区除外）
4. 禁止骚扰、辱骂、嘲弄其他用户
5. 禁止发布垃圾信息或广告

编辑规范

• 避免编辑战：不要和其他贡献者来回修改同一数据，使用 Report 让管理员处理
• 来源可靠：修改数据应基于 IMDb、维基百科等可靠来源
• 锁定字段：被管理员锁定的数据不要尝试绕过
• 不要恶搞：故意提交错误数据、虚假内容会被封号

如何报告问题

在页面底部点击 Report 按钮，选择正确的类型：

实用资源

• TMDB Contribution Bible（官方指南全文）：https://www.themoviedb.org/bible
• 支持论坛：https://www.themoviedb.org/talk
• 贡献排行榜：https://www.themoviedb.org/leaderboard
• API 文档：https://developer.themoviedb.org/docs

三篇教程到这里就全部结束了，从注册到编辑再到规范，覆盖了 TMDB 维护的完整流程。祝维护愉快！

找到编辑入口

在任意电影、电视剧、人物的页面，点击底部的 编辑 按钮进入编辑界面。

编辑界面按模块划分，每个模块都可以独立修改和保存。

电影核心字段编辑规范

原标题（Original Title）

• 必须使用原始语言的原生文字，不要罗马化（例如写 Левиафан 而非 Leviathan）
• 不要添加年份、国家等额外信息（不要写成 Coco (2017)）
• 大写规则遵循语言惯例，英文标题遵循 Wikipedia/IMDb 的大写规则
• 罗马化的原标题应填入 译名（Alternative Titles） 字段

译名（Translated Title）

• 使用首次官方发行的译名
• 如果译名与原名相同，留空并锁定（例如英文电影的英译名字段必须留空）
• 中文分四个区域：大陆 (zh-CN)、香港 (zh-HK)、台湾 (zh-TW)、新加坡 (zh-SG)，各填各的译名，不要混用
• 没有官方译名的留空，不要添加非官方翻译

简介（Overview）

TMDB 对简介有严格要求：

• 简短、无剧透，几行文字以内
• 客观中立，不要使用”fantastic”、”awful”、”票房大卖”等主观词汇
• 不要提及演职员信息，不要写”由 xxx 主演”
• 不要直接复制 IMDb 或其他受版权保护的网站的内容
• 不要添加链接或署名
• 找不到合适的简介就留空，不要写”暂无简介”

好的来源：官方网站、新闻稿、发行商的宣传材料。

标语（Tagline）

• 海报上的简短宣传语（如《盗梦空间》的”Your mind is the scene of the crime”）
• 每条标语单独填写
• 不要填写电影标题、剧情简介、演职员信息或类型标签
• 不要编造不存在的标语

时长（Runtime）

• 以分钟为单位填写
• 向上取整（93 分 57 秒 → 94 分钟）
• 包含片尾字幕的总时长

其他字段

• 预算与票房：以美元为单位，建议参考 Box Office Mojo 或 The Numbers
• 主页：只填官方网站，不要填 IMDb/Wikipedia/社交媒体的链接
• 语言：只填原版的语言，不要填配音/翻译的语言

电视剧编辑规范

电视剧的编辑规则与电影基本一致，以下几个字段是特有的：

剧集类型（TV Show Type）

剧集状态（TV Show Status）

迷你剧在最后一集播完后应标记为 Ended。

单集时长

• 填写不含广告的纯时长（通常美剧 43 分钟或 22 分钟）
• 如果每集时长不固定，在剧集级别填空白，逐集填写

海报与图片规范

TMDB 的图片管理模块有专门的质量指南：

基本要求

质量红线

1. 禁止水印：不能带有第三方网站的水印、Logo 或文字
2. 禁止拉伸：宽高比不对时只能裁剪，不能拉伸/压缩，也不能加黑边填充
3. 禁止放大低清图：上传的画质必须清晰，不能是模糊、像素化或有明显压缩 artifacts 的图片
4. 禁止滤镜：不要使用颜色滤镜或奇怪的特效，保持自然
5. 只传官方素材：海报必须是官方发布的版本

当没有高质量图片可用时，TMDB 的原则是 宁缺毋滥——没有图比放一张劣质图更好。

如何添加新条目

如果 TMDB 上完全没有某部作品：

1. 在搜索框搜不到时，点击 没有结果？提交一部新电影/新剧集
2. 至少填写标题和简介（简介可以暂时用占位文字，创建后立即删除）
3. 电视剧还需要至少一集的标题、简介和首播日期
4. 创建后尽快补充完整数据

发现错误数据怎么办

• 重复条目：点击 Report 按钮，选择 Duplicate（重复）
• 错误数据：选择 Incorrect Content（内容错误），附带可靠来源链接
• 被锁定的字段：如果数据已被管理员锁定无法修改，使用 Report 按钮向管理员反映

注意：不要和贡献者陷入”编辑战”（你改过来我改回去），用 Report 按钮让管理员做最终裁决。

Hexo 默认的主题比较简单，不够美观。Butterfly 是一个功能强大、设计精美的 Hexo 主题，拥有丰富的功能和良好的用户体验。

本教程将介绍如何安装和配置 Butterfly 主题。

安装 Butterfly 主题

1. 下载主题

在博客根目录下执行：

1

git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly

2. 安装依赖

Butterfly 主题需要安装渲染器插件：

1

npm install hexo-renderer-pug hexo-renderer-stylus --save

3. 启用主题

修改博客根目录下的 _config.yml 文件：

1

theme: butterfly

4. 复制主题配置文件

在博客根目录下执行：

1

cp themes/butterfly/_config.yml _config.butterfly.yml

这样可以在不修改主题源码的情况下自定义配置。

基础配置

1. 网站信息

编辑 _config.yml：

1
2
3
4
5
6
7

title: 我的博客
subtitle: 记录生活，分享知识
description: 基于 Hexo + Butterfly 的个人博客
keywords: Hexo, Butterfly, 博客
author: 你的名字
language: zh-CN
timezone: Asia/Shanghai

2. 导航栏配置

编辑 _config.butterfly.yml：

1
2
3
4
5
6
7
8
9
10
11
12

nav:
  logo: /img/logo.png  # Logo 图片
  display_title: true
  display_post_title: true
  fixed: true  # 固定导航栏

menu:
  首页: / || fas fa-home
  归档: /archives/ || fas fa-archive
  标签: /tags/ || fas fa-tags
  分类: /categories/ || fas fa-folder-open
  关于: /about/ || fas fa-heart

3. 代码块配置

1
2
3
4
5
6

code_blocks:
  theme: light  # 代码块主题
  macStyle: true  # Mac 风格
  height_limit: false  # 高度限制
  copy: true  # 复制按钮
  language: true  # 语言显示

4. 封面图片

1
2
3
4
5
6
7
8

cover:
  index_enable: true  # 首页启用封面
  aside_enable: true  # 侧边栏启用封面
  archives_enable: true  # 归档页启用封面
  default_cover:  # 默认封面列表
    - /img/1.jpg
    - /img/2.jpg
    - /img/3.jpg

创建页面

1. 创建分类页

1

hexo new page categories

编辑 source/categories/index.md：

1
2
3
4
5

---
title: 分类
date: 2026-01-02 21:00:00
type: categories
---

2. 创建标签页

1

hexo new page tags

编辑 source/tags/index.md：

1
2
3
4
5

---
title: 标签
date: 2026-01-02 21:00:00
type: tags
---

3. 创建关于页

1

hexo new page about

编辑 source/about/index.md：

1
2
3
4
5
6
7
8

---
title: 关于
date: 2026-01-02 21:00:00
---

## 关于我

这是一个关于我的页面...

文章配置

1. Front-matter

文章开头的配置区域：

1
2
3
4
5
6
7
8
9
10

---
title: 文章标题
date: 2026-01-02 21:00:00
tags:
  - 标签1
  - 标签2
categories:
  - 分类
cover: /img/cover.jpg  # 封面图片
---

2. 摘要

在文章中添加 <!-- more -->，前面的内容将作为摘要显示在首页。

1
2
3
4
5

这是文章的摘要内容...

<!-- more -->

这是文章的正文内容...

侧边栏配置

1. 启用侧边栏

1
2
3
4
5
6

aside:
  enable: true
  hide: false
  button: true  # 显示隐藏按钮
  mobile: true  # 移动端显示
  position: right  # 位置：left/right

2. 卡片配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

aside:
  card_author:
    enable: true
    description: 这是我的个人博客
    button:
      enable: true
      icon: fab fa-github
      text: Follow Me
      link: https://github.com/yourname

  card_recent_post:
    enable: true
    limit: 5  # 显示数量

  card_categories:
    enable: true
    limit: 8

  card_tags:
    enable: true
    limit: 40

评论系统

Butterfly 支持多种评论系统，这里以 Gitalk 为例：

1. 申请 GitHub OAuth App

1. 访问 https://github.com/settings/developers
2. 点击 “New OAuth App”
3. 填写信息：
   • Application name: 博客评论
   • Homepage URL: https://yourname.github.io
   • Application description: 博客评论系统
   • Authorization callback URL: https://yourname.github.io
4. 创建后获取 Client ID 和 Client Secret

2. 配置 Gitalk

编辑 _config.butterfly.yml：

1
2
3
4
5
6
7
8
9
10

comments:
  use: Gitalk
  text: true

gitalk:
  client_id: your_client_id
  client_secret: your_client_secret
  repo: yourname.github.io
  owner: yourname
  admin: yourname

搜索功能

1. 安装搜索插件

1

npm install hexo-generator-searchdb --save

2. 配置搜索

编辑 _config.yml：

1
2
3
4
5

search:
  path: search.xml
  field: post
  format: html
  limit: 10000

编辑 _config.butterfly.yml：

1
2
3

search:
  use: local_search
  placeholder: 搜索文章...

图片处理

1. 图片资源文件夹

在 _config.yml 中启用：

1

post_asset_folder: true

这样创建文章时会自动创建同名文件夹，用于存放图片。

2. 引用图片

在文章中使用相对路径引用图片：

1

![图片描述](图片文件名.jpg)

自定义 CSS

如果需要自定义样式，可以在 source/css/ 目录下创建 custom.css：

1
2
3
4

/* 自定义样式 */
.post-content {
  font-size: 16px;
}

然后在 _config.butterfly.yml 中引入：

1
2
3

inject:
  head:
    - <link rel="stylesheet" href="/css/custom.css">

常见问题

Q: 主题没有生效？

A: 检查 _config.yml 中的 theme 是否设置为 butterfly，并执行 hexo clean && hexo g。

Q: 如何更新主题？

A: 进入主题目录执行 git pull。

Q: 如何自定义主题颜色？

A: 在 _config.butterfly.yml 中配置 theme_color。

Q: 如何添加社交链接？

A: 在 _config.butterfly.yml 的 social 部分添加。

下一步

恭喜你，已经配置好了 Butterfly 主题！

接下来的教程将介绍：

• Hexo博客GitHub Actions自动部署教程 - 实现自动化部署

继续学习，让你的博客更加完善吧！

之前部署 Hexo 博客都是本地构建静态文件，然后手动推送到 GitHub Pages。这种方式有几个问题：

• 源码只在本地，存在丢失风险
• 换电脑需要重新配置环境
• 每次更新都需要手动执行部署命令

本文介绍如何使用 GitHub Actions 实现自动部署，解决这些问题。

准备工作

1. 两个仓库

我们将使用两个 GitHub 仓库：

• 源码仓库：存放 Hexo 源码（可以私有）
• Pages 仓库：存放生成的静态文件（必须公开）

例如：

• 源码：https://github.com/CeRu-007/hexo-cerublog
• Pages：https://github.com/CeRu-007/CeRu-007.github.io

2. 创建源码仓库

在 GitHub 上创建新仓库，用于存放 Hexo 源码。

配置源码仓库

1. 初始化 Git 并推送

在博客根目录执行：

1
2
3
4
5
6

git init
git add .
git commit -m "Initial commit: Hexo blog source code"
git branch -M main
git remote add origin https://github.com/CeRu-007/hexo-cerublog.git
git push -u origin main

2. 配置 .gitignore

确保 .gitignore 文件包含以下内容：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

.DS_Store
Thumbs.db
db.json
*.log
node_modules/
public/
.deploy*/
_multiconfig.yml
.sass-cache/
.deploy_git/
.idea/
.vscode/
*.swp
*.swo
*~

这样可以避免推送不必要的文件：

3. 处理主题（Git Submodule）

如果主题是通过 git clone 安装的（如 Butterfly），需要添加为 Git Submodule：

1
2
3
4

git submodule add https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
git add .gitmodules
git commit -m "Add butterfly theme as submodule"
git push

为什么要用 Submodule？

• 记录主题的具体版本，确保一致性
• 不存储主题完整代码，节省空间
• GitHub Actions 会自动拉取子模块

创建 GitHub Actions 工作流

1. 创建工作流文件

在项目根目录创建 .github/workflows/deploy.yml：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

name: Hexo Deploy

on:
  push:
    branches:
      - main
  workflow_dispatch:

jobs:
  build-and-deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout source
        uses: actions/checkout@v4
        with:
          submodules: true

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'

      - name: Install dependencies
        run: |
          npm install -g hexo-cli
          npm install

      - name: Generate static files
        run: hexo generate

      - name: Deploy to GitHub Pages
        uses: peaceiris/actions-gh-pages@v3
        with:
          personal_token: ${{ secrets.HEXO }}
          external_repository: CeRu-007/CeRu-007.github.io
          publish_dir: ./public
          publish_branch: gh-pages
          force_orphan: true

关键配置说明：

• submodules: true：自动拉取主题子模块
• external_repository：指定 Pages 仓库地址
• personal_token：使用 Personal Access Token（HEXO）用于跨仓库部署
• publish_branch：部署到 gh-pages 分支

注意： 这里必须使用 personal_token 而不是 github_token，因为 github_token 不能跨仓库推送。

2. 提交工作流文件

1
2
3

git add .github/workflows/deploy.yml
git commit -m "Add GitHub Actions workflow for auto deployment"
git push

配置 GitHub Personal Access Token

由于要跨仓库部署，需要创建 Personal Access Token。

1. 创建 Token

1. 访问 https://github.com/settings/tokens
2. 点击 Generate new token (classic)
3. 填写信息：
   • Note: Hexo Deploy
   • Expiration: 选择过期时间
   • 勾选权限：repo（完整的仓库访问权限）
4. 点击 Generate token
5. 复制生成的 token（只显示一次）

2. 添加 Secret

1. 进入源码仓库：Settings → Secrets and variables → Actions
2. 点击 New repository secret
3. 填写：
   • Name: HEXO
   • Value: 粘贴刚才复制的 token
4. 点击 Add secret

配置 GitHub Pages

进入 Pages 仓库（CeRu-007/CeRu-007.github.io）：

• 点击 Settings → Pages
• 在 Build and deployment 部分：
  • Source: Deploy from a branch
  • Branch: gh-pages（第一次部署后会自动创建）
  • Folder: / (root)
• 点击 Save

测试自动部署

现在推送代码就会自动触发部署：

1
2
3

git add .
git commit -m "测试自动部署"
git push

查看部署状态：https://github.com/CeRu-007/hexo-cerublog/actions

工作流程

自动部署的完整流程：

1. 推送代码到源码仓库的 main 分支
2. GitHub Actions 自动触发
3. 拉取源码和主题子模块
4. 安装依赖
5. 生成静态文件
6. 部署到 Pages 仓库的 gh-pages 分支
7. GitHub Pages 自动更新网站

优势对比

之前的方式

❌ 源码只在本地，容易丢失
❌ 换电脑需要重新配置
❌ 每次手动执行 hexo deploy
❌ 无法查看历史修改

现在的方式

✅ 源码备份在 GitHub，安全可靠
✅ 随时随地 git clone 即可工作
✅ 推送代码自动部署
✅ 完整的 Git 历史记录
✅ 多设备协作方便

常见问题

Q: 源码仓库可以是私有的吗？

A: 可以。源码仓库私有不影响自动部署，只有 Pages 仓库需要公开。

Q: 为什么不用同一个仓库？

A: 分开更清晰：

• 源码仓库：只存放源代码
• Pages 仓库：只存放静态文件
• 便于管理和协作

Q: 如何更新主题？

A: 更新子模块：

1
2
3
4
5
6

cd themes/butterfly
git pull
cd ../..
git add themes/butterfly
git commit -m "Update theme"
git push

Q: 如何在其他电脑上工作？

A: 克隆源码仓库：

1
2
3

git clone --recursive https://github.com/CeRu-007/hexo-cerublog.git
cd hexo-cerublog
npm install

Q: 为什么使用 personal_token 而不是 github_token？

A: 因为我们要跨仓库部署（从源码仓库部署到 Pages 仓库），而 github_token 是 GitHub 自动生成的，只能访问当前仓库，无法跨仓库推送。personal_token 是你创建的 Personal Access Token，拥有完整的仓库访问权限，可以跨仓库操作。

1
2
3
4
5
6
7
8
9
10

# 复制主题中的图片到 source/img/
cp themes/butterfly/source/img/7.jpg source/img/7.jpg
cp themes/butterfly/source/img/8.jpg source/img/8.jpg
cp themes/butterfly/source/img/9.jpg source/img/9.jpg
cp themes/butterfly/source/img/10.jpg source/img/10.jpg

# 添加到 Git 仓库
git add source/img/7.jpg source/img/8.jpg source/img/9.jpg source/img/10.jpg
git commit -m "Add missing images to source/img"
git push

总结

通过 GitHub Actions 实现自动部署，大大简化了博客的维护工作。现在只需要专注于写文章，推送代码后一切自动完成。

同时，源码备份在 GitHub 上，再也不用担心数据丢失了！