Jekyll

S9Y 数据库

其他依赖项

此导入器需要以下其他库。

你可以通过运行 gem install GEM_NAME 单独安装所需的 gem，或者通过一次调用安装所有 gem：gem install nokogiri safe_yaml sequel unidecode

此导入器仅转换你的文章并创建 YAML 前置内容。它不会导入任何布局、样式或外部文件（图像、CSS 等）。

调用

调用导入器的示例代码段 

jekyll-import s9ydatabase --dbname DB --socket SOCKET --user USER --password PW --host HOST --port PORT --table_prefix PREFIX --clean_entities --comments --categories --tags --drafts --markdown --permalinks --excerpt_separator --includeentry --imgfig --linebreak --relative

选项 <PARAM>说明
--dbname DB

数据库名称。

 默认值：  ''
--socket SOCKET

数据库套接字。

 默认值：  ''
--user USER

数据库用户名。

 默认值：  ''
--password PW

数据库用户的密码。

 默认值：  ''
--host HOST

数据库主机名。

 默认值：  'localhost'
--port PORT

连接到的自定义数据库端口。

 默认值：  3306
--table_prefix PREFIX

表前缀名称。

 默认值：  'serendipity_'
--clean_entities

是否清理实体。

 默认值：  true
--comments

是否导入评论。

 默认值：  true
--categories

是否导入类别。

 默认值：  true
--tags

是否导入标签。

 默认值：  true
--drafts

是否导出草稿。

 默认值：  true
--markdown

转换为 Markdown 格式。

 默认值：  false
--permalinks

保留 S9Y 永久链接。

 默认值：  false
--excerpt_separator

摘要分隔符。

 默认值：  ''
--includeentry

替换 includeentry 插件的宏。

 默认值：  false
--imgfig

使用 HTML 图形标签替换嵌套的 img 和 youtube div。

 默认值：  true
--linebreak

换行符处理：wp、nokogiri、ignore。

 默认值：  wp
--relative

将带有此前缀的链接转换为相对链接。

 默认值：  nil
迁移选项

此导入器现在支持两个选项，以帮助您将博客迁移到新的托管提供商。

  • relative

    将其设置为您的 URL 前缀，以将帖子中的所有绝对 URL 转换为相对 URL。例如，当设置为 myhost.com/blog 时，诸如 http://myhost.com/blog/lifestyle/7-lucky-post.html 的 URL 将转换为 /lifestyle/7-lucky-post.html。请注意，您不应包含尾部 / 斜杠，并且 https: 尚不支持。

  • linebreak

    如果您使用了格式化扩展，此选项可能很有用。使用以下值之一，以尽可能准确地复制您的帖子换行符

    • wp（默认值）

      复制 Wordpress 换行符行为，这是 S9Y 的默认值。

    • nokogiri

      使用 nokogiri gem 将条目解释为 XHTML 格式。如果您编写 HTML 条目，这将保留 HTML 换行符。

    • ignore

      此选项根本不处理条目，而是原样导入到 Jekyll 中。如果您以兼容 Jekyll 的格式编写条目，这可能很有用。

扩展选项

此导入器现在支持一些最常见的 S9Y 插件。

  • includeentry

    将其设置为 true 以转换类似于 includeentry 插件的条目。将包含条目的当前静态内容。不会同步未来的更新。

  • excerpt_separator

    S9Y 将常规帖子正文视为摘要，仅在帖子详细信息中显示扩展正文。Jekyll 仅显示帖子的第一段作为摘要。此选项允许你恢复 S9Y 行为：正文扩展的帖子将在其 front matter 中添加指定的分隔符，并且你可以修改你的索引布局以显示摘要。

  • imgfig

    默认情况下，此操作会将对 S9Y 媒体库的引用转换为 HTML figure 标记。将其设置为 false 以保留原始引用，你必须手动更新这些引用。

查看源代码 →