迁移到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 生成的内容是否符合预期。