这是一个发布博客的工具。本博客使用本工具发布。
本工具源码已上传至github:https://github.com/ChildishChange/BlogPublishTool
本工具主要参考了:如何高效的编写与同步博客(二)- 快速发布到多个渠道
最近实习,在给一个产品写教程博客,教程一共计划十篇博客。
平均每篇博客需要插入20+张图片,
同时博客之间有许多同一系列之间的链接,
并且我们需要在多个博客平台下发布博客(目前仅在cnblogs和csdn)上发布。
这就要求我们每次发布博客前手动上传20+次图片,
同时需要保持本地博客与平台上一致,
并且同一个平台上的系列博客之间的相互链接必须链接在原平台。
这些工作对一篇博客来说并不算很麻烦,但是当要维护的博客多了之后,这些工作手动完成是很麻烦的。
我相信其他发布过系列博客的博主也有这样的感受吧。
于是在mentor的要求下,我完成了这样一个博客发布工具:BlogPublishTool
这是一个C#完成的控制台程序,有如下三个功能:
注:该功能目前仅支持博客园博客。
在使用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
注:该功能目前仅支持博客园博客与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从哪里来?请继续往下看。
注:该功能目前仅支持博客园博客。
在系列博客的第一篇发布时,需要指定一个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包。
我使用了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);
这部分调用了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); //是否发布
联系客服