打造程序員本身的「雲筆記」

由於工做關係常常在臺式機/筆記本，家裏/單位切換來切換去，但願可以有一種不用那麼費神的保持工做連貫性的方式。git 很好，但太繁瑣了，下班走的時候忘記push了，到家就續不上了。固然我指的不是開發的代碼，而是一些文檔性的東西，譬如一些計劃、一些學習心得，在網站上查東西的時候也會有一些隨筆的記錄什麼的，由於太零碎，又隨時但願可以查到，因此以爲也許雲筆記是一個不錯的選擇。

在使用了一年左右的「xx雲筆記」後，感受本身愈來愈難以忍受了，首先的問題是搜索，雲筆記的搜索是 word 式的，須要一個一個搜，不支持內容列表、不支持F3，對於程序員來講徹底是廢物。其次是我曾經在一個 .md 文件中貼了一大段的代碼，結果下次打開的時候足足卡了七、8秒，上下翻頁也是卡的不行。文檔上說md支持不少流程圖、甘特圖...，結果作好的 .md 文件發到 github 上不少都顯示不了，大都是本身的擴展，離開了「xx雲筆記」後就是一堆誰都看不懂的東西。

那麼有沒有更加符合程序員需求的「雲筆記」呢，由於平常開發上常用 vscode 作開發，vscode 不管在編輯仍是搜索上，都徹底符合要求。因而就考慮可否用 vscode 打造一個符合本身的「雲筆記」，咱們都知道 vscode 裏面有大量的插件，並且可訂製化很是強，那麼可否把 vscode 改形成符合本身要求的「雲筆記」呢，抱着這個想法開始了對 vscode 的研究工做。

雲服務器的選擇

若是想作到跨設備同步，一個雲存儲後臺是必需要有的，那麼第一個問題就是選擇什麼樣的雲後臺服務器。這裏我又回到了 git 的懷抱，畢竟 git 服務器是很是成熟的解決方案，並且 vscode 與 git 的配合是天生的。並且即便沒有「雲筆記」的垃圾桶功能也不怕誤刪除文檔，git 用來幹這個事徹底是大才小用。

我能夠選擇 github 或 「碼雲」，反正都是免費的，徹底夠用了，在國內選擇「碼雲」會比 github 快一些。如何去註冊 github 或 「碼雲」的帳戶就不在這裏說明了，不瞭解的朋友能夠自行搜索。

自動化的同步

下一個問題是 git 的操做問題，git 的設計目標是爲了作代碼管理的，但我但願的效果是像雲筆記那樣的徹底無感的自動化同步，若是每次都要記着 push/pull 就還不如用雲筆記了。在插件倉庫裏面各類查找和測試，終於找到一個基本符合須要的插件 -- Auto-Git，這個插件能夠定時自動從倉庫裏面 push/pull 數據，正是我須要的。

這個插件裝完了，會在我當前的文檔工程下創建一個 .autogit 目錄，裏面有一個 autogit.json 文件，這個文件是 Auto-Git 的配置文件，例如個人配置：

{
  "updateInterval": 1800,
  "logging": false,
  "silent": true
}

• updateInterval
  是這個插件同步代碼的時間，我設定爲 1800 秒，也就是半小時，固然你能夠設定的更短一些，但半小時對我來講足夠了，由於我單位的電腦歷來不關機，從單位到家也不止半小時。
• logging
  指是否要在上傳下載的時候生成 log，徹底不須要，我只要結果，不關心過程。
• silent
  靜默模式，固然了，要不我裝你幹嗎。

插件裝好後，你能夠在下面的狀態欄左側看到相似:

Next Auto-Git in... 1265

的顯示，這就是告訴你在 1265 秒後開始自動同步數據。

最後還有一個比較麻煩的問題，我只想在個人文檔項目中使用 Auto-Git，不想在真正的開發項目中作這種自動化的同步，容易把其餘人搞暈。這個問題的解決辦法是給個人文檔工程創建一個工做區，而後全局禁用 Auto-Git，而後再在這個工做區上單獨開啓 Auto-Git，這樣就讓這個插件只在這個工做區開啓了。

像 github 同樣顯示 .md 文檔

首先個人文檔基本都是 .md 格式的，有時候寫好的文檔會上傳到 github 這樣的代碼平臺上。vscode 是自帶 .md 的顯示支持的(Ctrl-K V)，但它默認的顯示效果跟 github 上顯示的 .md 的顯示效果並不同，那麼有沒有辦法可以讓我在 vscode 裏面看到跟 github 上同樣的顯示效果呢？好在並非只有我有這樣的需求，網上已經有人作過了：

https://github.com/raycon/vscode-markdown-style

這個項目 preview 目錄下的 github.css 就是我須要的。把這個文件下載回來，放到文檔項目的 .vscode 目錄下(爲了不干擾正常的文檔文件)，而後打開 .vscode 目錄下的 setting.json 文件，加入：

"markdown.styles": [
    ".vscode/github.css"
]

如今再預覽 .md 文件就跟在 github 上看到的一致了。

像「xx雲筆記」同樣編輯 md 文件

由於用了一年的「xx雲筆記」，已經習慣了綠色的標題、藍色的代碼，在用 vscode 寫 md 後，編輯環境的顏色就各類不習慣，本人又是輕度強迫症患者，必定要把 vscode 的編輯環境也搞得跟「xx雲筆記」同樣才行。
原本覺得有插件能幫我搞定這個事，但測試了一圈各類插件後，發現沒有符合我須要的插件，我不相信 vscode 沒法搞定這個事，在網上搜到一篇《VSCode 修改編輯器配色》的文章後，才豁然開朗，原來 vscode 自己就支持訂製化。

這個就不能在當前工做區的設置裏面改了，必需要改全局的 setting.json，

1. 按 Ctrl+Shift+P打開 vscode 控制檯
2. 輸入 Open Settings(JSON) 打開全局的 setting.json

3. 在後面加入:

   "editor.tokenColorCustomizations" : {
       "textMateRules" : [
           {
               "scope" : "markup.heading.markdown",
               "settings" : {
                   "foreground" : "#8bcc8b",
               }
           },
           {
               "scope" : "markup.fenced_code.block.markdown",
               "settings" : {
                   "foreground" : "#6699cc",
               }
           },
           {
               "scope" : "punctuation.definition.list.begin.markdown",
               "settings" : {
                   "foreground" : "#a0a0a0",
               }
           }
       ]
   }

   如今就能看到熟悉的綠標題，藍代碼了，若是沒看到請重啓 vscode。

結束語

雖然花了很多時間去研究，一旦成功了仍是很是有成就感的。在這裏把本身趟過的坑跟你們分享一下，但願有更多的程序員朋友可以跟我同樣訂製出最符合本身的「雲筆記」，也但願可以跟我一塊兒分享你的訂製心得。