文件 | Hexo

歡迎使用 Hexo，此文件將幫助您快速開始使用。如果您在使用途中遇到任何問題，您可以在解決問題中找到解答，或者也可以在 GitHub 或 Google Group 上詢問。

什麼是 Hexo？

Hexo 是一個快速、簡單且強大的網誌框架。Hexo 使用 Markdown（或其他標記語言）解析您的文章，並在幾秒鐘內，透過漂亮的主題產生靜態檔案。

讓 Hexo 準備就緒僅需幾分鐘，若您在安裝時遭遇問題而且找不到任何解決方式，請回報問題，我會試著解決您的問題。

安裝 Hexo 相當簡單；然而，在安裝前您必須先檢查下列您的電腦是否已經安裝下列軟體：

若您的電腦已經安裝上述的必備軟體，那麼恭喜您！只需要透過 npm 即可完成 Hexo 的安裝。

$ npm install -g hexo-cli

如果您的電腦尚未安裝必備軟體的話，請根據下列的安裝指示來完成安裝。

Mac 使用者
您在編譯時可能會碰到問題，請先至 App Store 安裝 Xcode，一旦 Xcode 安裝完成後，開啟它並前往 Preferences -> Download -> Command Line Tools -> Install 安裝命令列工具。

Node.js 為大多數平台提供了官方的安裝程序。對於中國大陸地區用戶，可以前往淘寶 Node.js 鏡像下載。

其它的安裝方法：

對於 Mac 和 Linux 同樣建議使用 nvs 或者 nvm，以避免可能會出現的權限問題。

Windows 用戶
使用 Node.js 官方安裝程序時，請確保勾選 Add to PATH 選項（默認已勾選）

For Mac / Linux 用戶
如果在嘗試安裝Hexo 的過程中出現EACCES 權限錯誤，請遵循由npmjs 發布的指導修復該問題。強烈建議不要使用 root、sudo 等方法覆蓋權限

Linux 用戶
若您使用 Snap 安裝 Node.js，您則需要在初始化一個部落格時，於目標資料夾中手動執行 npm install。

一旦所有的必備軟體都安裝完畢後，即可透過 npm 安裝 Hexo：

$ npm install -g hexo-cli

如果您堅持使用較舊版本的 Node.js，你可以考慮安裝過往版本的 Hexo。

請注意我們並不會對於過往版本的 Hexo 進行錯誤修復。

有可能的話，我們強烈建議總是安裝最新版本的 Hexo 以及推薦版本的 Node.js。