Typora-博客园

手机

iphone11大小尺寸是多少？苹果iPhone11和iPhone13的区别是什么？

警方通报辅警执法直播中被撞飞：犯罪嫌疑人已投案

家电

Typora-博客园

2023-01-03 21:06:48 来源：博客园

简述

用Typora写Markdown笔记的朋友，应该不少吧？

把笔记上传到博客园的朋友，应该也不少吧？

那么大家都是怎么把笔记上传到博客园的呢？手动复制不？

(资料图)

想不想一键导出笔记到博客园呢？支持分类、标签哦！

想就往下看！

本文内容可与我的另一篇文章Typora-Picgo搭配使用，实现Picgo图床分目录存储图片！

一键发布

想必大家自己找过很多一键发布的方法了吧，我找到过：

donet插件：发现有文章介绍的这个，但只是上传图片用的，笔记内容还是得手动复制到博客园。而且博客园编辑页已经支持本地图片批量上传转换了，弃用此方法。
MetaWeblog API：这个API是个业内规范了，基本博客网站都支持，包括CSDN、博客园等。看到有个园友夜行过客写了篇文章，通过这个API上传笔记。可惜，没介绍到怎么发布分类、标签。而且只有新建笔记的介绍，没有更新。

于是，本文就诞生了，站在前面这位园友的肩膀上，我们搞个全套实现！

安装Python

园友是通过Python脚本调用API上传的，所以我们需要先安装Python。

Mac OS：自带python，无需额外安装
Windows：进入官方下载页，选择稳定版，对应自己操作系统的，然后傻瓜式安装就好了。

开启MetaWeblog

进入博客园的设置页：

划到最后的其他设置，勾选允许MetaWeblog访问：

然后点击访问令牌的"查看"，无则新建。

暂记下这里的MetaWeblog登录名、访问令牌、访问地址，要配置在本地的。

看到上图中的推荐客户端了么，Open Live Writer？当初想看看这个客户端是否支持笔记的分类、标签，就点开看看了：

看到没有，这里有篇文章介绍了客户端是支持分类、标签的！点开文章看到：

客户端也是通过API发布文章的，既然他可以，那我们也可以通过自定义脚本实现！

上图里类别、标签的名字分别是Categories、Keywords，点开我们前面其他设置中的MetaWeblog访问地址，查看API介绍：

我们点击新建文章的API名字，看到其参数有：

其他参数没什么，关键就是这个post参数了，点击前面的链接，查看其结构：

前面必填的3个参数分别是发布时间、文章内容、文章标题。

然后与客户端一样，有带category、keyword字样的参数，就是图里标出来的俩。那肯定是你们了，哼哼！

至此，我们可以大致有个实现思路了：通过Python脚本，调用API，发送参数里给定分类、标签就行啦！

配置文件

创建一个配置文件cnblogs.ini，内容为：

[server]url = xxxusername = xxxpassword = xxx[category]mdjfsmf2yq = [随笔分类]Java[keyword]mdjf5pww5o2u5bqt = 数据库[blogid]l1vzzxjzl3n0yxj0b25nl1dvcmttcgfjzs9t = 17013320

这里有四部分：

server：博客园中设置的MetaWeblog登录信息
category：分类的设置。
- 键：我用了笔记第一层目录的base64码。如笔记文件全路径为/pardir/Java/语法/基础语法.md，去掉前面的通用笔记路径/pardir后，第一层路径为Java，将Java转为base64码后，作为键。使用base64编码，是为了防止自建的目录中包含空格等特殊字符。
- 值：固定格式为[随笔分类]+自定义分类名中间不要有空格。可以不在博客园中预先定义好，API会自动创建！至于为什么用随笔分类，因为测试过其他值，发现不能发布为文章。可以用个脚本获取所有分类：
```
import xmlrpc.clientimport sslimport configparserssl._create_default_https_context = ssl._create_unverified_context# 读取配置文件config = configparser.ConfigParser()  # 获取解析器config.read("/xxx/cnblogs.ini")  # 读取配置文件内容# 获取配置中的博客园登录信息url = config.get("server", "url")username = config.get("server", "username")password = config.get("server", "password")# 调用类别查询APIproxy = xmlrpc.client.ServerProxy(url)categories = proxy.metaWeblog.getCategories("", username, password)print(categories)
```
keyword：标签的设置
- 键：与类别一样，只是用了第二层目录值
- 值：随便自定义
blogid：存了每笔文章的ID。用来判断文章是新建，还是更新。
- 键：与类别一样，只是用了去掉父目录后的剩余全部字符串
- 值：首次发布成功后，自动填入

编写脚本

上传脚本

基于前面园友已有的脚本，我们改造成了upload_to_cnblogs.py：

import xmlrpc.clientimport sslimport osimport sysimport configparserimport base64ssl._create_default_https_context = ssl._create_unverified_context# 读取配置文件rootPath = os.path.abspath(os.path.dirname(__file__))  # 获取当前路径config = configparser.ConfigParser()  # 获取解析器config.read(os.path.join(rootPath, "cnblogs.ini"))  # 读取配置文件内容if __name__ == "__main__":    # 获取配置中的博客园登录信息    url = config.get("server", "url")    username = config.get("server", "username")    password = config.get("server", "password")    # 设置Base64编码的+/替换符    altchars = bytes("Xx", encoding="utf-8")    # 获取参数    fileName = sys.argv[1]    parMkdPath = sys.argv[2]    # 获取分类    markdownDir = fileName.replace(parMkdPath, "").lstrip(os.path.sep)    markdownDir = markdownDir.split(os.path.sep)    category = base64.b64encode(bytes(markdownDir[0], encoding="utf-8"), altchars)    category = bytes.decode(category).rstrip("=")    keyword = base64.b64encode(bytes(markdownDir[1], encoding="utf-8"), altchars)    keyword = bytes.decode(keyword).rstrip("=")    validateFlag = True    # 分类维护时    if not config.has_option("category", category):        validateFlag = False        print(f"目录({markdownDir[0]}, base64码: {category})未维护对应分类！")        if not config.has_option("keyword", keyword):        validateFlag = False        print(f"目录({markdownDir[1]}, base64码: {keyword})未维护对应标签！")    if validateFlag:        # 获取编码后文件名对应博客ID-读自配置        category = config.get("category", category)        print(category)        keyword = config.get("keyword", keyword)        print(keyword)        # 文件名用Base64编码        fileNameEnc = base64.b64encode(            bytes(fileName, encoding="utf-8"), altchars)        fileNameEnc = bytes.decode(fileNameEnc).rstrip("=")        # 获取文件内容        with open(fileName, "r", encoding="utf8") as f:            data = f.read()        # 获取文件名        title = os.path.basename(fileName)[:-3]        post = dict(            dateCreated=xmlrpc.client.DateTime(),            description=data,            title=title,            categories=["[Markdown]", category],            mt_keywords=keyword,        )        proxy = xmlrpc.client.ServerProxy(url)        # 若有博客ID，则使用editPost API编辑        if config.has_option("blogid", fileNameEnc):            # 获取编码后文件名对应博客ID-读自配置            blogId = config.get("blogid", fileNameEnc)            s = proxy.metaWeblog.editPost(                blogId, username, password, post, True)        # 若无博客ID，则使用newPost API新建        else:            blogId = proxy.metaWeblog.newPost(                "", username, password, post, True)            if len(blogId) > 0:                config.set("blogid", fileNameEnc, blogId)        # 输出文章连接        userName = url.split("/")[-1]        print(f"https://www.cnblogs.com/{userName}/p/{blogId}.html")        # 写入配置信息        cfgWrite = open(os.path.join(rootPath, "cnblogs.ini"), "w")        config.write(cfgWrite)        cfgWrite.close()

大致逻辑：

获取传入的参数：Markdown笔记全路径、父路径。参数传递下文会介绍。
笔记全路径去掉父路径后，取得剩下的第一层、第二层路径、全部路径，分别用Base64编码，去掉最后的"="，作为键，获取配置文件中对应的分类、标签、文章ID。
设置API参数：文章标题、文章内容、发布时间
根据文章ID是否存在，调用创建或更新API。若为创建，则根据API返回值，将文章对应ID写入配置文件。
最后输出文章链接。

试过加入校验不通过时，如分类配置未维护，主动以错误状态退出sys.exit(1)，结果Typora端触发发布文章时，什么提示都没有了。。。。

所以脚本里将错误输出到控制台了，不定义异常抛出。

调用脚本

在Typora中第一步调用的脚步，设置成了另一个shell脚本。主要是为了与我的Picgo图床同步。

我的另一篇文章中介绍了Picgo+阿里云图床的设置，上传的图片按笔记路径存储，但是云端这样分类了，本地还是没有。所以在上传笔记前，做了份脚本移动图片目录。

如果无此需要，可以跳过本节。

shell脚本upload_to_cnblogs.sh：

MKD_FILE_PATH=$1 #获取Markdown文件全路径FILE_NAME=${MKD_FILE_PATH%.*} #删除最后一个“及右侧内容FILE_NAME=${FILE_NAME##*/} #删除最后一个"及其左侧内容，获取所有图片父路径PAR_IMG_DIR=$(cat ~/.picgo/config.json |grep img_ignore_path) #获取图片路径配置PAR_IMG_DIR=${PAR_IMG_DIR%\"*} #删除最后一个“及右侧内容PAR_IMG_DIR=${PAR_IMG_DIR##*\"} #删除最后一个"及其左侧内容，获取所有图片父路径PAR_MKD_DIR=$(cat ~/.picgo/config.json |grep mkd_ignore_path) #获取Markdown路径配置PAR_MKD_DIR=${PAR_MKD_DIR%\"*} #删除最后一个“及右侧内容PAR_MKD_DIR=${PAR_MKD_DIR##*\"} #删除最后一个"及其左侧内容，获取Markdown父路径EXTRA_DIR=$MKD_FILE_PATH #获取Markdown文件全路径EXTRA_DIR=${EXTRA_DIR%/*} #删除最后一个/及右侧所有字符串EXTRA_DIR=${EXTRA_DIR#$PAR_MKD_DIR} #删除父级Markdown目录if [[ ! "$MKD_FILE_PATH" =~ ^"${PAR_MKD_DIR}".* ]]; then    echo "Markdown文件路径与插件配置的父路径不一致！"    exit 1fiif [ ! -e $PAR_IMG_DIR$EXTRA_DIR ]; then    mkdir -p $PAR_IMG_DIR$EXTRA_DIR #创建与Markdown相同结构的目录fiif [ -e $PAR_IMG_DIR/$FILE_NAME ]; then    cp -R $PAR_IMG_DIR/$FILE_NAME $PAR_IMG_DIR$EXTRA_DIR #移动图片至新层级下    rm -r $PAR_IMG_DIR/$FILE_NAMEfipython3 ~/WorkSpace/Scripts/Typora/upload_to_cnblogs.py $MKD_FILE_PATH $PAR_MKD_DIR #上传至博客园

大致逻辑：