迁移到Jekyll

开始使用

如果你是从其他博客系统切换到 Jekyll,Jekyll 的导入工具可以帮助你完成迁移。此页面列出的多数方法都需要对旧系统数据库具有读取权限,以便生成 Jekyll 的文章。每种方法都会根据外部系统中的内容,在 _posts 目录中生成 .markdown 文章。

其他系统

如果你使用的系统目前没有对应的迁移工具,可以考虑自行编写一个,并向我们提交 pull request

安装

由于这些导入工具各自依赖较多,因此它们被拆分为一个独立的 gem,名为 jekyll-import。要使用它们,只需安装该 gem,它们就会作为 Jekyll 标准命令行的一部分可用。

gem install jekyll-import
jekyll-import 需要你手动安装部分依赖

大多数导入工具需要一个或多个依赖项。为了保持 jekyll-import 的体积尽可能小,我们不会将所有可能用到的依赖一起打包。相反,当缺少依赖时,你会看到清晰的错误提示,并告诉你如何安装。

如果你比较熟悉,可以查看所选 importer 中的 require_deps 方法,一次性安装所有依赖。

使用方法

现在你可以通过以下方式运行导入工具:

ruby -r rubygems -e 'require "jekyll-import";
    JekyllImport::Importers::MyImporter.run({
        # 此处填写该导入器的配置参数
})'

其中 MyImporter 是具体导入器的名称。

注意:请务必检查迁移后的内容

导入工具可能无法区分已发布和私有内容,因此你应始终检查 Jekyll 生成的内容是否符合预期。

支持的平台