一.前言
此工具解決的痛點是在本地編輯的 Markdown 文件里包含的圖片,在博客園發布時,需要手動一張張的復制到博客園的編輯器中上傳,十分麻煩,此文中有詳細說明:如何高效的編寫與同步博客 (.NET Core 小工具實現)
二.安裝工具
(1)具有 .NET Core/.NET 5 環境可以直接使用命令安裝:
dotnet tool install --global dotnet-cnblog
(2)如果沒有上面的環境,那么可以直接下載二進制文件
下載地址: https://github.com/stulzq/dotnet-cnblogs-tool/releases
因為本工具是開源的,而且使用過程中需要輸入密碼,所以不要相信任何第三方下載,因為它們有可能被植入惡意代碼,僅提供上面兩種方式。
三.使用
第一次運行需要配置博客ID,賬號密碼等,按照提示輸入即可,對密碼采用tea加密算法進行加密存儲。
需要賬號密碼是因為調用 MetaWeblog API 需要此信息
重置配置
使用下面的命令重置配置:
dotnet-cnblog reset
四.上傳圖片
對Markdown文件里的圖片進行解析,上傳到博客園,並且轉換內容保存到新的文件中。
dotnet-cnblog proc -f <markdown文件路徑>
處理過的內容保存在 Markdown 原始文件名-cnblog.md
中,復制粘貼到博客園的編輯器發布即可。
五.其他說明
-
程序未加過多的容錯機制,請勿暴力測試。比如發送一個非MarkDown文件到程序。
-
上傳圖片具有重試機制,重試三次。
-
只有本地路徑的圖片才會上傳,所有http/https遠程圖片都會過濾
-
圖片上傳完畢以后,會自動轉換md內容保存到帶
cnblog
后綴的文件里面 -
密碼錯誤請重置配置
若上傳接口報錯,請到博客園后台設置 https://i.cnblogs.com/settings