最近開始使用Atom編輯器寫作。為了預覽帶LaTeX公式的markdown文檔,嘗試安裝插件markdown-preview-plus,但是總是失敗。經過仔細查看錯誤輸出和網上相關問答,發現盡管報錯為Compiler tools not found
,真實原因其實是網絡不通暢(GFW)。由於無法使用代理上網,最后只能手動安裝完成,摸索過程記錄如下。其他插件的手動安裝,也可以參照本文。
簡單摘要:從github下載並手動安裝插件;用nrm測試和切換npm源;用npm-install-missing批量安裝模塊。
安裝插件
首先找到該package的代碼庫。
- https://atom.io/packages/markdown-preview-plus
- https://github.com/atom-community/markdown-preview-plus
下載zip文件,並解壓到 Users\..\.atom\packages\
文件夾中。
在 cmd 下切換到該目錄,執行 apm install markdown-preview-plus
。
此時仍會報錯,並且打開Atom后會出現 Cannot find module fs-plus
錯誤信息,但是已經可以在Packages
菜單下找到該插件。
這是因為手動安裝時,只安裝了這個包,沒有安裝它的若干依賴模塊。
安裝缺失模塊
首先安裝 node.js。
如果想手動安裝fs-plus這一個模塊,可以在上述markdown-preview-plus的目錄下執行 npm install fs-plus
。但是這樣安裝完成之后還會源源不斷地提示缺少其他模塊……由於 markdown-preview-plus 這個包的依賴模塊比較多,不能一個一個手動安裝,最好借助其他工具批量安裝。
為了批量安裝所有依賴模塊,首先安裝 npm-install-missing 工具,即執行 npm install -g npm-install-missing
。
然后在markdown-preview-plus目錄里執行 npm-install-missing
。
這一步再次報錯 Registry returned 404 for GET on....
,同樣是因為牆的緣故。解決方案是切換源。
首先執行 npm install -g nrm
,這是源的管理工具。安裝成功后,便可以用 nrm ls
列出可選源,nrm test
測試連接時間,方便地在不同源之間切換。測試結果顯示,我這里最快的源是 cnpm,於是執行 nrm use cnpm
來切換到它。
最后,再次 npm-install-missing
,這次安裝成功!
現在可以打開 Atom 編輯器,停用默認的 markdown-preview 插件,啟用 markdown-preview-plus,通過快捷鍵 Ctrl+Shift+m
切換源文件和預覽窗口。