Gridea 迁移到 Twilight

约 1404 字大约 5 分钟

2025-10-10

本指南将帮助您将现有的 Gridea 博客内容迁移到 Twilight 主题。

Gridea 与 Twilight 文章格式差异

Gridea 使用 Markdown 格式存储文章，并包含 Frontmatter。这使得从 Gridea 迁移到 Twilight 相对简单，因为两者都基于 Markdown 和 Frontmatter。

主要差异在于 Frontmatter 字段的命名和结构可能不同，以及静态资源（图片等）的路径处理。

Gridea 文章示例：

---
title: "我的 Gridea 文章"
date: 2023-10-26 10:00:00
tags:
  - 随笔
categories:
  - 日常
--- 

这是一篇 Gridea 博客文章的内容。

## 小标题

更多内容...

Twilight 格式示例：

---
title: Markdown Tutorial
published: 2025-01-20
pinned: true
description: A simple example of a Markdown blog post.
tags: [Markdown, Blogging]
category: Examples
licenseName: "Unlicensed"
author: emn178
sourceLink: "https://github.com/emn178/markdown"
draft: false
---

# 我的 Gridea 文章

这是一篇 Gridea 博客文章的内容。

## 小标题

更多内容...

迁移步骤

1. 准备工作

确保已安装 Twilight 主题。
准备文章存放目录：src/content/posts/。
找到您的 Gridea 博客源文件，通常在 Gridea 客户端设置的“源文件目录”中。文章通常位于 [源文件目录]/posts/。

2. 复制文章文件

将 Gridea 博客源文件目录中的 posts 文件夹下的所有 Markdown 文件复制到 Twilight 的文章目录 src/content/posts/。

3. 调整 Frontmatter

这是迁移过程中最关键的一步，您需要根据 Twilight 的 Frontmatter 规范调整 Gridea 文章的 Frontmatter。

常见字段映射：

title: Gridea 的 title 直接对应 Twilight 的 title。
date: Gridea 的 date (例如 2023-10-26 10:00:00) 需要转换为 Twilight 的 pubDate (例如 2023-10-26)。如果 Gridea 没有 updatedDate，可以使用 pubDate 作为 updatedDate 的值。
tags: Gridea 的 tags 列表直接对应 Twilight 的 tags 列表。
categories: Gridea 的 categories 列表通常只有一个元素，对应 Twilight 的 category。
description: Gridea 可能没有独立的 description 字段，您可以手动添加或从文章内容中提取。
cover: Gridea 可能没有独立的 cover 字段，您可以手动添加。
draft: Gridea 通常通过文章是否发布来判断，Twilight 需要 draft: true 或 false。

批量修改建议：

对于大量文章，建议编写脚本（如 Python 脚本）来自动化 Frontmatter 的转换。

Python 脚本示例 (概念性):

import os
import re
import yaml

def migrate_gridea_frontmatter(file_path):
    with open(file_path, 'r', encoding='utf-8') as f:
        content = f.read()

    # 提取 Frontmatter 和内容
    match = re.match(r'^---\s*\n(.*?)\n---\s*\n(.*)$', content, re.DOTALL)
    if not match:
        print(f"Skipping {file_path}: No valid Frontmatter found.")
        return

    fm_str = match.group(1)
    body = match.group(2)

    try:
        gridea_fm = yaml.safe_load(fm_str)
    except yaml.YAMLError as e:
        print(f"Error parsing YAML in {file_path}: {e}")
        return

    twilight_fm = {}
    twilight_fm['title'] = gridea_fm.get('title', 'Untitled')
    
    # 处理日期
    date_str = gridea_fm.get('date', '').split(' ')[0] # 只取日期部分
    twilight_fm['pubDate'] = date_str if date_str else 'YYYY-MM-DD'
    twilight_fm['updatedDate'] = date_str if date_str else 'YYYY-MM-DD'

    twilight_fm['description'] = gridea_fm.get('description', '') # Gridea 可能没有，需要手动补充
    twilight_fm['tags'] = gridea_fm.get('tags', [])
    twilight_fm['category'] = gridea_fm.get('categories', ['未分类'])[0] if gridea_fm.get('categories') else '未分类'
    twilight_fm['cover'] = gridea_fm.get('cover', '') # Gridea 可能没有，需要手动补充
    twilight_fm['draft'] = gridea_fm.get('draft', False) # Gridea 可能没有，默认为 False

    new_fm_str = yaml.dump(twilight_fm, allow_unicode=True, sort_keys=False)

    new_content = f"---\n{new_fm_str}---\n\n{body}"

    with open(file_path, 'w', encoding='utf-8') as f:
        f.write(new_content)
    print(f"Migrated Frontmatter for: {file_path}")

# 示例用法
# posts_dir = 'path/to/your/blog/src/content/posts'
# for filename in os.listdir(posts_dir):
#     if filename.endswith('.md'):
#         migrate_gridea_frontmatter(os.path.join(posts_dir, filename))

4. 静态资源处理

Gridea 通常将图片等静态资源存储在 [源文件目录]/media/ 或文章同级目录下的 assets 文件夹中。您需要将这些资源复制到 Twilight 的 public/ 目录下，并更新文章中的路径。

复制资源文件：将 Gridea 的 media 文件夹（或包含图片的 assets 文件夹）下的所有图片、视频等媒体文件复制到 Twilight 的 public/images/ 或 public/assets/ 目录下。
更新文件路径：在 Markdown 文件中，批量替换图片链接，使其指向 Twilight 项目中的正确路径。
- 示例：将 ![alt](/media/image.jpg) 替换为 ![alt](/images/image.jpg)。
- 如果图片在文章同级目录的 assets 文件夹中，例如 ![alt](./assets/image.jpg)，则需要将其路径调整为 Twilight 的相对路径或绝对路径，例如 ![alt](/images/post-slug/image.jpg) 或 ![alt](/images/image.jpg)。