本文會說兩個話題,
1,如何將 Github 上的文檔(如:dotnet-campus/doraemon-pocket: 哆啦A夢的口袋 - 收集效率工具與站點)發布到語雀。
2,如何在本地使用 Markdown 編輯博客,再推送到博客園。
在我使用的方案中,這兩者都使用到了 MWeb 這個 Markdown 編輯器,所以就放在一起啦。
這篇博客就是在本地編輯,然后使用 MWeb 推送到博客園的。
廢話
- 為什么將 Github 上的文檔放在語雀上?
為了更好地閱讀體驗,還可以有評論等互動。不失為一種自由(可以本地編輯 Markdown,不一定要使用在線編輯工具)而且方便(不用搭建靜態博客,如使用 hexo 等。)的文檔/博客發布方式。當然,如何你想搭建個人站點,可以折騰更多的內容,那隨意啦。
- 語雀是什么?
阿里巴巴的一個文檔平台,詳情請點擊:語雀 - 專業的雲端知識庫;一共有四個層級:空間-團隊-知識庫-文檔。
其中空間屬於收費項目,一般是企業使用,個人或小團隊使用,后面三項足夠。
- 為什么是 MWeb?
因為 MWeb 可以推送文章到語雀(這也是在語雀的文檔中發現的),后來發現也可以推送到博客園。但 MWeb 僅限蘋果的平台(macOS + iPadOS + iOS),且收費(¥128)。如果有相應 Windows 平台的軟件,留言告訴我。
MWeb發布到博客園配置 - 狸貓醬 - 博客園
Mac下如何使用MWEB發布博客到博客園 - 佳佳牛 - 博客園
如何操作與注意事項
其實操作很簡單,不過有些小點,新手可能會遇到一點點問題。
- MWeb 的設置
在 MWeb 偏好設置 - 發布服務中,添加語雀和博客園的相關設置即可,博客園的設置,在上方有鏈接。
另外,MWeb 默認是在線文檔庫的形式啟動,如果想加載本地 Markdown 文件,需要打開本地模式,使用 Command + E
可以切換,也可以在 偏好設置 - 通用設置 中,設置在啟動時,默認以本地模式啟動。
- 發布
編輯 Markdown 可以使用任何趁手的工具,當然也可以直接用 MWeb 。
編輯完成之后,點擊右上角的分享/發布按鈕,選擇發布到語雀,設置好標題,需要發布到的知識庫即可。記得現在語雀上新建知識庫,知識庫類似於一個專欄或文件夾,用於給文檔分類的,你可以新建很多知識庫,存放不同類型的文檔。
- 圖片外鏈
如果你的 Github 中使用的圖片(包括其他文件鏈接)使用的就是完整的外鏈,那發布到語雀上,就可以直接打開,如果圖片是相對路徑,在需要先將圖片放到圖床上。
現在 MWeb 上設置好圖床,在發布文檔之前,點擊分享/發布按鈕, 選擇“將本地圖片上傳至圖床...” 。然后復制新的文章,在發布,使用 MWeb 發布文章到博客園時也是如此。
另外,圖片記得先壓縮。
macOS上圖片壓縮軟件 ImageOptim - Mac知道
應該就這些。
參考鏈接: