文件 | Hexo 繁體中文

歡迎來到 Hexo 文件。如果您在使用 Hexo 時遇到任何問題，請查看疑難排解指南，在 GitHub 上提出問題，或在 Google Group 上開啟主題。

什麼是 Hexo？

Hexo 是一個快速、簡單且強大的部落格框架。您可以使用 Markdown（或其他標記語言）撰寫文章，Hexo 會在幾秒鐘內產生具有精美主題的靜態檔案。

只需幾分鐘即可設定 Hexo。如果您遇到問題且在這裡找不到解決方案，請提交 GitHub 問題，我們會協助您。

安裝 Hexo 非常容易，只需事先準備以下內容

如果您的電腦已具備這些，恭喜！您可以跳至Hexo 安裝步驟。

如果沒有，請依照以下指示安裝所有需求。

對於 Mac 使用者
您在編譯時可能會遇到一些問題。請先從 App Store 安裝 Xcode。安裝 Xcode 後，開啟 Xcode 並前往 偏好設定 -> 下載 -> 指令行工具 -> 安裝 以安裝指令行工具。

Node.js 為大多數平台提供官方安裝程式。

其他安裝方法

也建議 Mac 和 Linux 使用 nvs，以避免可能的權限問題。

Windows
如果您使用官方安裝程式，請務必勾選 新增至 PATH（預設為勾選）。

Mac / Linux
如果您在嘗試安裝 Hexo 時遇到 EACCES 權限錯誤，請依照 npmjs 提供的解決方法；強烈不建議使用 root/sudo 覆寫。

Linux
如果您使用 Snap 安裝 Node.js，當初始化部落格時，您可能需要在目標資料夾中手動執行 npm install。

安裝所有需求後，您可以使用 npm 安裝 Hexo

$ npm install -g hexo-cli

進階使用者可能偏好安裝和使用 hexo 套件。

$ npm install hexo

安裝完成後，您可以使用兩種方式執行 Hexo

echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

然後使用 hexo <指令> 執行 Hexo

如果您受限於較舊的 Node.js，您可以考慮安裝 Hexo 的過去版本。

請注意，我們不會為 Hexo 的過去版本提供錯誤修復。

我們強烈建議盡可能安裝 Hexo 的最新版本和建議的 Node.js 版本。