BlogPublishTool - 博客发布工具
这是一个发布博客的工具。本博客使用本工具发布。
本工具源码已上传至github：https://github.com/ChildishChange/BlogPublishTool
本工具主要参考了：如何高效的编写与同步博客（二）- 快速发布到多个渠道
一、痛点
最近实习，在给一个产品写教程博客，教程一共计划十篇博客。
平均每篇博客需要插入20+张图片，
同时博客之间有许多同一系列之间的链接，
并且我们需要在多个博客平台下发布博客（目前仅在cnblogs和csdn）上发布。
这就要求我们每次发布博客前手动上传20+次图片，
同时需要保持本地博客与平台上一致，
并且同一个平台上的系列博客之间的相互链接必须链接在原平台。
这些工作对一篇博客来说并不算很麻烦，但是当要维护的博客多了之后，这些工作手动完成是很麻烦的。
我相信其他发布过系列博客的博主也有这样的感受吧。
二、于是
于是在mentor的要求下，我完成了这样一个博客发布工具：BlogPublishTool
这是一个C#完成的控制台程序，有如下三个功能：
1.上传图片
注：该功能目前仅支持博客园博客。
在使用VS code编写Markdown文本时，图片引用一般是以路径或URL的形式链接的，这个工具可以将文本中所有以文件路径形式链接的图片上传，并用得到的URL替换原有的文件路径（需要登录博客园）。
使用时支持如下的命令格式：
//将路径下的.md文件/文件夹下所有.md文件中未上传的图片上传，路径支持绝对路径与相对路径
BlogPublishTool.exe uploadpic --input json_file/directory
//当带有--test时，仅列出路径下的.md文件/文件夹下所有.md文件中未上传的图片，不上传
BlogPubilshTool.exe uploadpic --input json_file/directory --test
2.替换链接
注：该功能目前仅支持博客园博客与CSDN博客。
当系列博客中的一篇需要引用系列中的其他博客时，仅需将链接写为:
即可，接下来只需要运行本工具，程序将从json文件中读取该博客在对应平台下的链接，并进行替换，可在不同平台上发布的多份文件。
使用时支持如下的命令格式：
//将路径下的.md文件/文件夹下所有.md文件中所有链接替换为json中的URL，并写回原文件，路径支持绝对路径与相对路径
BlogPublishTool.exe replace --input json_file/directory --config json_file_path
//将路径下的.md文件/文件夹下所有.md文件中所有链接替换为json中的URL，并写入指定的目录下，路径支持绝对路径与相对路径
BlogPublishTool.exe replace --input json_file/directory --output directory --config json_file_path
json从哪里来？请继续往下看。
3.发布博客
注：该功能目前仅支持博客园博客。
在系列博客的第一篇发布时，需要指定一个json文件，文件可以是空的。
在发布了第一篇之后，程序就会自动将发布信息写入json；之后再发布新博客同样也会将新的信息写入json。但如果发布之前发布的博客（即json中记录的博客），那么只会修改原博客，而不会发布新的。
使用时支持如下的命令格式：
//将路径下的.md文件/文件夹下所有.md文件发布至博客，并修改json文件
BlogPublishTool.exe publish --input json_file/directory --config json_file_path
json的格式如下：
[
{
"1.md":{
"title":"test-1",
"cnblogs":"https://www.cnblogs.com/ChildishChange/p/9372888.html",
"csdn":""
}
},
{
"2.md":{
"title":"test-2",
"cnblogs":"https://www.cnblogs.com/ChildishChange/p/9372972.html",
"csdn":""
}
}
]
但是，由于CSDN关闭了metaweblog接口，因此并不能发布到CSDN，也不能生成json中CSDN对应的内容，需要复制.md文件手动发布并添加进json。
三、设计思路
首先这个程序要解决三个痛点：
- 上传图片
- 替换链接
- 发布博客
因此，不难想到这个程序的运行流程：
命令 <= 解析命令()
switch(命令)
case uploadpic：上传图片(命令)
break
case replace: 替换链接(命令)
break
case publish: 发布博客(命令)
break
于是，不难想到这个程序需要以下三个模块：
- 命令行解析模块：用于解析命令行，获取参数
- 命令处理模块：根据命令与参数执行对应的操作
- 核心模块：获取命令行，调用命令行解析模块，根据解析结果调用命令处理模块
进一步分析：
- 上传图片、替换链接：都需要解析markdown中的特定文本并替换，最终写入到文件
- 上传图片、发布博客：都需要建立与博客服务器的连接
- 上传图片、替换链接、发布博客：都需要处理绝对路径与相对路径，都需要获取路径中的所有.md文件
把相似的功能放到一起，又多出三个模块：
- 路径处理模块：处理路径、获取.md文件
- Markdown处理模块：解析markdown特定文本、替换、写入文件
- 博客连接模块：登录博客、发布博客、修改博客
四、实现过程
在造轮子之前，先看看有没有轮子
于是我发现了这个项目：如何高效的编写与同步博客（二）- 快速发布到多个渠道
在查看了他的代码之后，我发现了一个用于连接博客服务器的Nuget包：MetaweblogClient.core
更进一步地，我找到了一个强大的解析命令行的Nuget包：
Command Line Parser Library for CLR and NetStandard
于是，实现的难度大幅度降低了，这里主要讲两个部分，命令解析和博客连接部分，因为这两个部分使用了Nuget包。
1.命令解析部分
我使用了commandlineparser提供的verb功能，创建了三个类，分别代表上文提到的三种verb command：
[Verb("publish", HelpText = "Publish the blog file to the specified blog platform.")]
public class PublishOptions
{
//自定义参数，例如输入路径--input或者测试命令--test等等
}
[Verb("replace", HelpText = "Replace link of picture in the blog.")]
public class ReplaceOptions
{
//自定义参数
}
[Verb("uploadpic", HelpText = "Upload and replace picture with URL.")]
public class UploadPicOptions
{
//自定义参数
}
简单举几个verb command（即动词命令）的例子：
git add . //add 就是verb
git commit ... //commit 同理
git push //push 也是
定义好了不同的动词命令后，只需在main函数中调用命令行解析函数ParseArguments即可，并支持将解析结果进行map操作：
//命令行解析
Parser.Default.ParseArguments<UploadPicOptions, ReplaceOptions, PublishOptions>(args)
.MapResult(
(UploadPicOptions opts)=> RunUploadPicOptions(opts),
(ReplaceOptions opts) => RunReplaceOptions(opts),
(PublishOptions opts) => RunPublishOptions(opts),
errs => 1);
2.博客处理部分
这部分调用了metaweblogclient.core提供的接口。
//建立博客连接所需的信息：
BlogConnectionInfo _connectionInfo = new BlogConnectionInfo(
BlogUrl, //例如我的博客园博客URL就是 http://www.cnblogs.com/ChildishChange/
MetaWeblogUrl, //同理，我的博客园的metaweblog地址是 https://rpc.cnblogs.com/metaweblog/ChildishChange/
blogId, //我的ID就是 ChildishChange
userName, //我的用户名还是 ChildishChange
passWord); //我的密码是******************
//建立连接
var blogClient = new Client(_connectionInfo);
//上传图片（其实这个接口是用于上传文件的）
var pictureUrl = blogClient.NewMediaObject(
picturePath, //文件路径
"image/jpeg", //文件类型
File.ReadAllBytes(pictureAbsPath)); //文件内容
//发布博客
var postId = blogClient.NewPost(
blogTitle, //博客标题
blogContent, //博客内容
new List<string> { "[Markdown]" }, //博客类别
true, //是否发布
DateTime.Now); //发布时间
//编辑博客
blogClient.EditPost(
postId, //post ID 比如本篇博客的postID就是：9378139
blogTitle, //博客标题
blogContent, //博客内容
new List<string> { "[Markdown]" }, //博客类别
true); //是否发布