由于之前用的WordPress里存了不少文章,而且用了wordpress的一些插件和特殊格式,所以要先去WordPress的后台里导出文章的xml格式文件到本地,然后使用Hexo的迁移插件进行一些特殊处理并生成MarkDown格式的文件。

目录

  1. 文章导出
  2. 文章转换
    1. 安装迁移扩展
    2. 防止扩展生成的markdown文件名乱码
    3. WordPress特殊格式转换
      1. html实体转换(附加防止转换删除线)
      2. 高亮代码标签转换,以及短代码提示框转换
      3. 生成和tag相同的Keywords
  3. 迁移文章导入

文章导出

按照Hexo官方文档的说明,在 WordPress 仪表盘中导出数据(“Tools” → “Export” → “WordPress”),检查生成并下载到本地的xml文件,去除其中的无用分类(因为当前版本的Hexo的同级分类只能有一个,多个分类会变成父分类-子分类的格式。或许此问题以后会有妥善的解决方案)。


文章转换

安装迁移扩展

在Hexo的项目目录下安装迁移扩展hexo-migrator-wordpress:

1
npm install hexo-migrator-wordpress --save

防止扩展生成的markdown文件名乱码

  1. 编辑Hexo项目中的node_modules/hexo-migrator-wordpress/index.js 文件
  2. 修改56行的slug,改为 slug = item[‘wp:post_id’][0] ,这里是将slug修改为文章id

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    var title = item.title[0],
    id = item['wp:post_id'][0],
    date = item['wp:post_date'][0],
    slug = item['wp:post_id'][0],//修改这里
    content = item['content:encoded'][0],
    comment = item['wp:comment_status'][0],
    status = item['wp:status'][0],
    type = item['wp:post_type'][0],
    categories = [],
    tags = [];

    if (!title && !slug) return next();
    if (type !== 'post' && type !== 'page') return next();
    if (typeof content !== 'string') content = '';
  3. 解释下上一步的原因:我之前的WordPress文章是按照数据库里的文章id作为唯一别名的(http://域名/blog/数字),而Hexo的文章链接是按照MarkDown文件名来决定的(http://域名/可选前缀/MarkDown文件名/)。为了新的站的链接也和之前相同,使用post_id作为slug即可迁移生成按文章id的文章文件。如果你的文章slug有特殊含义,请勿用这种方式处理。

WordPress特殊格式转换

同样编辑Hexo项目中的node_modules/hexo-migrator-wordpress/index.js 文件,然后根据自己需要修改的部分,在文件中分别进行以下处理.

html实体转换(附加防止转换删除线)

  1. 添加函数replaceHTMLEntity:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    function replaceHTMLEntity(str){
    str = str.replace(/amp;/g, '');
    str = str.replace(/&lt;/g, '<');
    str = str.replace(/&gt;/g, '>');
    str = str.replace(/&quot;/g, '"');
    str = str.replace(/&#92;/g, '\\');
    str = str.replace(/&#48;/g, '0');
    str = str.replace(/~~/g, '~ ~ ');//防止被转为删除线
    return str;
    };
  2. 添加一行代码到content = tomd(content).replace(/\r\n/g, ‘\n’);前面 :

    1
    2
    content = replaceHTMLEntity(content);//添加这行
    content = tomd(content).replace(/\r\n/g, '\n');

高亮代码标签转换,以及短代码提示框转换

在WordPress使用了Syntax Highlighter代码高亮插件,还有一个短代码提示框S-shortcodes插件,请根据实际插件使用情况自行修改函数中的替换内容。

  1. 添加函数replaceCodeTag :

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    function replaceCodeTag(str){
    //Syntax Highlighter代码高亮插件
    str = str.replace(/\[code\]/gi, '```\n');
    str = str.replace(/\[\/code\]/gi, '\n```');
    str = str.replace(/\[code\ lang\=\"bash\"\ collapse=\"true\"\]/gi, '```bash\n');
    str = str.replace(/\[code\ lang\=\"bash\"\]/gi, '```bash\n');
    str = str.replace(/\[code\ lang\=\"php\"\]/gi, '```php\n');
    str = str.replace(/\[code\ lang\=\"shell\"\]/gi, '```bash\n');
    str = str.replace(/\[code\ lang\=\"csharp\"\]/gi, '```cs\n');
    str = str.replace(/\[code\ lang\=\"html\"\]/gi, '```html\n');
    str = str.replace(/\[code\ lang\=\"js\"\]/gi, '```javascript\n');
    str = str.replace(/\[code\ lang\=\"javascript\"\]/gi, '```javascript\n');
    str = str.replace(/\[code\ lang\=\"sql\"\]/gi, '```sql\n');
    str = str.replace(/\[php\]/gi, '```php\n');
    str = str.replace(/\[\/php\]/gi, '\n```');

    //短代码提示框插件S-shortcodes
    str = str.replace(/\[box\ style\=\"alert\"\]/gi, '{% alert danger %}\n');
    str = str.replace(/\[box\ style\=\"warning\"\]/gi, '{% alert warning %}\n');
    str = str.replace(/\[box\ style\=\"download\"\]/gi, '{% alert info %}\n');
    str = str.replace(/\[box\ style\=\"info\"\]/gi, '{% alert success %}\n');
    str = str.replace(/\[box\ style\=\"tip\"\]/gi, '{% alert success %}\n');
    str = str.replace(/\[box\ style\=\"blue\"\]/gi, '{% alert info %}\n');
    str = str.replace(/\[\/box\]/gi, '\n{% endalert %}');


    return str;
    };
  2. 添加一行代码到content = tomd(content).replace(/\r\n/g, ‘\n’);前面 :

    1
    2
    3
    content = content = replaceCodeTag(content);//添加这行
    content = replaceHTMLEntity(content);
    content = tomd(content).replace(/\r\n/g, '\n');

生成和tag相同的Keywords

后续我们还要做SEO优化,这里可以先对其做一些前期准备。
Front-matter 是Hexo文章的MarkDown文件最上方以 --- 分隔的区域,可以用来指定个别文件的变量。
由于迁移插件会自动在Hexo文章最前面的Front-matter区域生成tags,我们可以也同时在Front-matter中生成与tags相同的关键词Keywords字符串。只需要在tag赋值处后面加一行:

1
2
3
if (categories.length && type === 'post') data.categories = categories;
if (tags.length && type === 'post') data.tags = tags;
if (tags.length && type === 'post') data.keywords = tags.join();//添加这行

这样在迁移文件生成的时候,每篇文章的tag还会以逗号分隔生成keywords项.


迁移文章导入

在hexo目录下,执行迁移指令:

1
hexo migrate wordpress ***.xml

  • 其中,*.xml为导出的WordPress文章数据文件。
  • 执行完成后,就可以看到hexo项目的source/_posts文件夹下生成了对应的MarkDown文件。
  • 如果有需要调整迁移脚本的地方,可以把生成的文件都删除(如果posts文件夹下已有文章记得转移或备份),修改迁移扩展的脚本文件后,重新执行迁移指令。
  • WordPress的加密文章也是会迁移过来的,需要注意处理。

剩下的就是修改和微调啦,毕竟有些地方转换为markdown的版式和缩进细节难以完美,可能需要手动校对修改一遍。

如未特殊注明,本站文章均为原创

转载请注明:转载自quericy的博客(https://quericy.me)

本文链接地址: WordPress迁移Hexo之数据迁移