一.前言
此工具解決的痛點是在本地編輯的 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