日志
- 2022-12-14:更新了一些使用细节。比如,建议运行脚本不要使用和m2w包同名(我改为了
myblog.py
),否则会出来一些bug。 - 2022-12-11:将
m2w 2
上传至PyPi (v2.2.10),让大家可以通过pip安装m2w。具体用法去Github文档看吧,也蛮简单的。当然,像原来那样用也是可以的。 - 2022-12-08:教程中增加
post_metadata
不可以为空值的提醒;更新了m2w v2.2.4
,在上传新文件前先检查其是否已经存在于WordPress后台,避免重复上传。 - 2022-12-06:升级至
m2w 2.2
。优化了user.json
的参数结构使其更加灵活。至少在v2.2.1
版本或以上。更新若干教程。 - 2022-12-03:创建船新版本m2w 2.0!
前言
m2w 1.0的教程可见《Docker系列 WordPress系列 WordPress上传或更新Markdown的最佳实践》。
之前我一直使用m2w
来管理自己的博客文章。某次和小伙伴交流时,我发现大家管理本地文件夹的习惯不太一样。比如,我虽然会将某文件放在一个具有特定结构的文件目录里,但我定位文件的时候习惯使用everything
之类的软件搭配正则表达式,因此只是记文件大致名字而不怎么记文件位置。
但是,有相当一部分人定位文件的时候依赖对文件位置的记忆。基于这种现实,旧版本的m2w
对于某些小伙伴来说是不友好的,因为它需要用户指定legacy
和new
文件夹,因此用户无法根据自己的喜好将待同步/更新的文件放到任意目录。而且,将新文件“强行转移”至legacy里,这种操作也不太自然。此外,对于有多个站点/帐户的小伙伴来说,旧版本的m2w
也不太方便。
因此,趁着周末休息,我重新设计了m2w
——现在叫m2w 2
了 !m2w 2
有以下特性:
- 与
m2w 1.0
相比,使用 和config/user.json
略微不同的方式维护用户信息。 - 用户可以开心地保留原有的文件结构 (~ ̄▽ ̄)~ 。
- 通过多个
legacy_*.json
同时管理多个网站/帐户。 - 只需要使用1个 python 脚本
myblog.py
而不是两个(m2w 1.0
中的update.py
和upload.py
)。 - 像m2w 1.0 稳定且好用!
- 即时更新,而不像基于Github Page的更新策略一样有一定延时。
项目地址和原来是一样的:
欢迎使用喔!用法比m2w 1.0
要更简单一些。对于m2w v2.2.4
或以上的版本在上传新文件前会对WordPress后台已存在的Post进行检测(基于文件名),所以不会导致重复上传,大家可以放心升级啦!
最后,所有的m2w版本均依赖xmlrcp.php,所以你的WordPress站点不要关闭其API(默认开放)。在WordPress 6.0时代,配合Wordfence,其实不需要太担心安全问题。建议站点有https的情况下再使用m2w,否则可能会造成帐号/密码泄露(如果博客仅有http,建议上https;可参考此教程)。
基本原理
无论是更新文章还是上传文章,不再分开,完全由myblog.py
控制。大致的规则是这样的:
- 如果
legacy*.json
不存在,则所有的文件都是新文件,需要全部上传。 - 如果
legacy*.json
存在,如果某些key不存在,表明为新文件,需要上传这些key对应的md。 - 如果
legacy*.json
存在,如果key存在但value不同,表明为旧文件有新的改动,需要更新这些key对应的md。
我觉得这种逻辑对于普通用户来说是挺友好的,但是对进阶选手来说就不一定了。不过,进阶选手操作能力强,在我的基础上魔改,应该问题不大 (~ ̄▽ ̄)~
判断文件改动的基本原理是md5算法。根据chatGPT的介绍,MD5是一种散列算法,用于确保信息传输完整一致。它通过对数据进行摘要来产生一个结果,该结果称为散列值。MD5被广泛用于生成文件或消息的指纹,以确保它们在传输过程中没有被篡改
。在m2w中,md5算法主要用于快速并敏感地判断某个markdown文件是否有改动。
user.json
新的user.json与旧版本略有不同,具体结构如下:
"web01": {
"domain": "https://domain-01.com",
"username": "username-01",
"password": "password-01",
"path_markdown": [
"E:/Github/m2w/@test/main",
"E:/Github/m2w/@test/main2"
],
"post_metadata": {
"category": ["test"],
"tag": ["test"],
"status": "publish"
},
"path_legacy_json": "/config/legacy"
}
其中web01
可以随便取名,它与legacy_*.json
文件的命名和一些message有关,一但指定后不建议更改。可以添加多个类似于web01
的对象,这对于多网站/帐户的用户来说是挺友好的。post_metadata
指定了默认上传的类、标签和状态,不可以为空值。
值得一提的是,path_legacy_json
表征了legacy_*.json
类文件的位置,它一般不需要调整,保留默认的/config/legacy
取值即可。
目录结构
m2w 2
不会破坏用户的文件结构,它完全是通过legacy*.json
文件来判断是否有文件需要上传/更新。需要提醒的是,尽管m2w 2
将文件的绝对路径当成Key,但你尽量不要对不同的文件使用相同的文件名——如果你这样做,其实也会给看博客文章的人造成疑惑(尽管这不会报错,因为WordPress会自动分配不同的数字ID)。
m2w 2
的目录结构进行了优化。在user.json
文件中,依然由path_markdown
变量控制:
"path_markdown": [
"E:/Github/m2w/@test/main",
"E:/Github/m2w/@test/main2"
],
这里你可以加任意数量的顶级目录。如果该目录里有子文件夹和.md文件,也可以正确识别。由于代码里具有去重机制,所以并不需要担心路径重复 (~ ̄▽ ̄)~
网站/帐户
如下所示:
"domain": "https://domain-01.com",
"username": "username-01",
"password": "password-01"
domain
、username
、password
则和m2w 1.0
是一样的,即分别代表域名、用户名、密码。
项目展示
为了演示多站点/帐号的功能,我使用了重复的站点/帐号。实际操作时你应该使用不同的帐号,否则文章会重复。
上传文章
同。
如下图,一条python myblog.py
命令即可:
其它提示
yaml头
和1.0版本一样,m2w 2
支持在markdown文件添加yaml头。如下所示:
---
category: [docker]
tag: [wordpress, docker]
status: publish
---
其中category
代表分类(一般是1个),tag
代表标签(可有多个),status
代表文章状态(publish发布/draft草稿/private隐私)。
逻辑判断
在myblog.py
中,首先进行网站连接,只有成功连接时才会进行md5 sum判断。该特点对于连接网络不稳定站点是必要的,因为由于q的原因这些站点偶尔可能会无法连接。如果事先进行了md5 sum判断且连接错误/超时,尽管下一次成功连接网站,也无法同步上次更新,因为md5值已经更新过了。该特性在m2w v1.0.7
中也有,但较早的m2w版本里我并未考虑到这种可能性(踩坑成长ing)。
用VSCode来运行myblog.py
的小伙伴建议加个代理。打开VSCode,按F1
可调出设置文件settings.json
。下图示范v2ray的ip和端口:
根据自己本地代理所使用的ip和端口进行更改即可。
信息级别
如果你觉得信息提示内容太“多”、太“杂”,可以在myblog.py
中设置verbose=False
。如下图:
message report一般是对应myblog.py
或up.py
脚本中的print
命令,如果不喜欢,自己注释或删除就行。这没啥好说的,挺简单 (~ ̄▽ ̄)~
小结
好久没有水过这么短的博文了,哈哈!不过可以解决问题就行。大家使用m2w 2
的时候有啥问题可以多多反馈!
扩展阅读
- WordPress XML-RPC
- A Complete Guide on xmlrpc.php in WordPress (What It Is, Security Risks, How to Disable It)
Legacy
无用的代码或教程。
- 选择2(伪进阶选手):将原来的legacy文件夹列为
path_markdown
的元素之一(要保留旧的legacy.json
文件。并将其改名为legacy_*.json
之类的名字。这个*
与websites
中的网站名[比如下面示例中的web01
、web02
]相一致。路径也要与user.json
里所描述的一致)——建立新文件结构——日常上传/维护
对于m2w 1.0
的用户来说,想升级2.0有两种选择方式:
- 选择1(小白选手):(1)删除原博客的文章——(2)本地改回心仪的结构——(3)重新上传——(4)日常上传/维护。
- 选择2(进阶选手):(1)将本地markdown的文件结构搞好——(2)利用
m2w 2
的函数仅生成md5和新的legacy_*.json
文件,但不更新/上传markdown。下图展示的是myblog.py
代码的基本结构(只运行第2步的代码即可,不需要运行第1/3步)——(3)在新legacy_*.json
的前提下,日常上传/维护(此时使用的是myblog.py
的完整版)。这个方案最大的特点是不会影响WordPress站点已经存在的文章,比较推荐。
---------------
完结,撒花!如果您点一下广告,可以养活苯苯😍😍😍
这个我测试了一下,很不错!非常实用!不过我用argon主题测试发现,上传上去之后,图片如果比较小的话(外链),是居左显示的,这个argon主题应该可以通过修改css让文章里的图片全部居中显示的吧,不知道你折腾过没
详见《特效》。具体方法是添加一个额外CSS:
我记得你用的不是halo?
啊哈,我是用halo,昨天正好有时间就折腾了一下你的m2w😝
我个人觉得m2w还不错的,写作和修改博文比较方便 ୧(๑•̀⌄•́๑)૭
请问博主这个错误是为啥 xmlrpc.client.Fault: <Fault 500: ‘项目需要一个名字。’>
啊这,我还没遇到过哎。可以贴一下你的user.json内容吗(请将安全信息隐藏)
我看了一下能自动获取到md文件的名字,但是还是会报错,下面是我的userjson
早上起来debug了一下,发现是tag为空的问题,加上一个tag就可以正常推送了
tag确实不可以是空的。另外,你这markdown的路径是不是也有点问题?这不是我默认的路径嘛,你的应该也不一样
我的markdown路径就是按照博文自己建立的,测试好了之后我再改成自己的,现在发现是可以正常推送和更新的。但是我觉得一篇博文不需要tag也是可以的,所以昨天死活没有找到问题,去对应位置print一下,发现也能出现md的文件名,所以我猜可能是配置的问题,今天早上改了tag就可以了
加tag好一些,这样文章系统会比较有条理。如果没有特别倾向,可以设定默认tag为common、general之类的词。一般我写博文的时候,该博文都会对应某个主题。就算是吐槽,也有一个关于“吐槽”的tag或category ヾ(≧∇≦*)ゝ
你这个user.json文件感觉问题很大😱 可以远程连线看一下。你有telegram的话可以加群: https://t.me/benszhub 。没有就加QQ吧
好的,加油! (๑•̀ㅁ•́ฅ)