如何使用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
微信扫一扫,支持一下!