如何使用ruby同步markdown博文到博客园

这两天折腾了一下用ruby通过MetaWeblog接口把本博客同步到博客园，特此记录。

MetaWeblog

MetaWeblog是一个专门关于博客的协议标准，通过xmlrpc，很简单的定义了新增、编辑、删除三个基本接口。

在博客园设置页签的最下方，保存按钮之前有每个用户的MetaWeblog接口地址：

MetaWeblog访问地址: http://rpc.cnblogs.com/metaweblog/personball

打开这个接口地址，可以看到接口文档。

那么通过什么方式调用这个服务呢？
最好是脚本语言，这毕竟不是开发项目，用需要编译生成的静态语言有点小题大做。

如果你熟悉Python，或许也可以找到MetaWeblog的客户端库，下面介绍通过Ruby版MetaWeblog客户端进行XmlRpc调用。

通过Ruby脚本调用metaWeblog.newPost

准备工作：

  1. ruby升级到2.3版本；
  2. gem install metaweblog

对了，我这里是Mac系统。下面先讲几个注意点，具体操作放最后。

Tip1 发布频率

博客园的MetaWeblog接口对博文发布频率做了限制，发布间隔太短会遇到提示：

30秒内只能发布1篇博文，请稍候发布

间隔30秒还是很容易触发，建议发布间隔60秒。

Tip2 发布Markdown

发布Markdown内容要求Post结构中的categories设成[Markdown]，注意categories要求是数组，具体请看接口文档中struct Post一栏。

Tip3 扩展MetaWeblog中的Post对象

你找到的MetaWeblog客户端很可能是通用的，所以不会针对博客园的接口做适配，肯定需要针对Post对象做扩展。

博客园MetaWeblog接口Post结构中的title是文章标题，description是文章内容，这两个都是必填项。
如果遇到异常提示，必须思考下是不是博客园服务器端抛出来的。

本博客的同步脚本

完整代码见：

cnblogs_post.rb
post_sync.rb

其中cnblogs_post.rb是针对博客园接口的扩展，主要加了个:categories，去掉了原先MetaWeblog::Post定义的:link。
:dateCreated虽然加了，但是目前博客园不使用接口传进去的值，而用服务器接收时间作为发布时间。需要修改的话，必须到后台编辑文章页面，展开最下方的其他选项，勾选修改发布时间。（我嫌麻烦，直接title上加日期前缀了）

post_sync.rb主要是单篇文章同步用脚本，处理了几个问题：

  1. 加载cnblogs_post.rb，以使用MetaWeblog::CnblogsPost；
  2. 读取配置（接口地址、用户名、密码等）；
  3. 打开_posts目录中的markdown文件，进行一定的处理（解析Jekyll文件头之类）；
  4. 处理文章中的相对路径，主要是资源链接和博文链接等；

Yaml配置文件

post_sync.yml范例：

target: http://rpc.cnblogs.com/metaweblog/personball
source: http://personball.com
username: yourUserName
password: yourPWD

配置文件一定记得不要推送到github上，.gitignore中必须指定忽略post_sync.yml。

批量调用

首先post_sync.rb必须设置成可执行：

chmod u+x post_sync.rb

然后使用bash脚本批量调用， 批量调用脚本参考batch_sync.sh

这个脚本可以通过find命令遍历_posts目录自动生成：

find _posts/*|xargs -n 1 echo ./post_sync.rb >> batch_sync.sh

对了，其中sleep 55s这是通过vscode多行编辑插入的。

最后，强烈建议程序员一定要多玩玩命令行。

git add .
git commit -a
git push && ./post_sync.rb _posts/2017-08-31-how-to-sync-post-to-cnblogs-with-ruby.md

Go!

Published: August 31 2017

prize