README

此插件允许您从其他平台导入文章和页面到 Spress 网站。

支持的平台

• CSV 文件.
• Wordpress WXR 文件.

要求

• php >= 5.5.
• Spress >= 2.1.3.
• Composer.

如何安装？

1. 进入 your-spress-site/ 文件夹。
2. 运行 composer require spress/spress-import。
3. 当您运行 spress 命令时，导入命令将在 import 命名空间下显示。

如何使用？

查看具体提供者。

源永久链接

导入插件尝试保留每个项目的源永久链接。为了达到这个目标，此插件添加了以下属性： permalink 和 no_html_extension。

例如：对于一个源永久链接为以下的项目： http://acme.com/what-is-new-this-time 生成的 front matter 块将是

---
permalink: '/what-is-new-this-time'
no_html_extension: true
---

CSV 文件

此命令从 CSV 文件导入文章。

import:csv 命令的符号如下

import:csv [--dry-run] [--post-layout POST-LAYOUT] [--not-replace-urls]
[--not-header] [--delimiter-character DELIMITER-CHARACTER]
[--enclosure-character ENCLOSURE-CHARACTER]
[--terms_delimiter_character TERMS-DELIMITER-CHARACTER] [--] <file>

使用示例

$ spress import:csv /path-to/post.csv --post-layout=post

选项

• --dry-run：此选项显示导入的项目，而不会实际修改您的网站。
• --post-layout：应用于文章的布局。例如：--post-layout=post。
• --not-replace-urls：避免用本地 Spress URL 替换文章中的 URL。
• --not-header：第一行不会被当作标题处理。
• --delimiter-character：设置分隔符字符。默认为字符 ,。
• --enclosure-character：设置包围字符。默认为字符 "。
• --terms_delimiter_character：设置应用于分类和标签列中术语的分隔符字符。

CSV 结构

您的 CSV 文件将读取以下列

1. 标题
2. 永久链接
3. 内容
4. 发布日期
5. 分类（可选）：用分号分隔的术语列表。例如：“新闻;事件”。
6. 标签（可选）：用分号分隔的术语列表。
7. 标记（可选）：内容中使用的标记语言。例如：“md”、“html”。默认为“md”。此值将用作导入项目的文件名扩展名。

项目属性

此提供者为每个项目添加的属性列表

• categories：表示分类的术语列表。
• tags：表示标签的术语列表。

Wordpress 的 WXR 文件

此命令从由 Wordpress（社区和 dot com）生成的 WXR 文件导入文章。

import:wordpress 命令的符号如下

import:wordpress [--dry-run] [--post-layout POST-LAYOUT]
[--fetch-images] [--not-replace-urls] [--assets-dir ASSETS-DIR] [--] <file>

使用示例

$ spress import:wordpress /path-to/my-wxr-file.xml --post-layout=post

选项

• --dry-run：此选项显示导入的项目，而不会实际修改您的网站。
• --post-layout：应用于文章的布局。例如：--post-layout=post。
• --fetch-images：抓取 Wordpress 博客中使用的图片。
• --not-replace-urls：避免用本地 Spress URL 替换文章中的 Wordpress URL。
• --assets-dir：相对于 src 目录的文件夹。默认为 content/assets。

项目属性

此提供者为每个项目添加的属性列表

• author：文章的作者。
• excerpt：文章的摘要。
• categories：表示分类的术语列表。
• tags：表示标签的术语列表。