Hexo 概述

歡迎使用 Hexo，本文檔將幫助您快速上手。如果您在使用過(guò)程中遇到問(wèn)題，請(qǐng)查看 問(wèn)題解答 中的解答，或者在 GitHub_blank、Google Group_blank 上提問(wèn)。

什么是 Hexo？

Hexo 是一個(gè)快速、簡(jiǎn)潔且高效的博客框架。Hexo 使用 Markdown_blank（或其他渲染引擎）解析文章，在幾秒內(nèi)，即可利用靚麗的主題生成靜態(tài)網(wǎng)頁(yè)。

?安裝

安裝 Hexo 只需幾分鐘時(shí)間，若您在安裝過(guò)程中遇到問(wèn)題或無(wú)法找到解決方式，請(qǐng)提交問(wèn)題_blank，我們會(huì)盡力解決您的問(wèn)題。

安裝前提

安裝 Hexo 相當(dāng)簡(jiǎn)單，只需要先安裝下列應(yīng)用程序即可：

• Node.js_blank (Node.js 版本需不低于 10.13，建議使用 Node.js 12.0 及以上版本)
• Git_blank

如果您的電腦中已經(jīng)安裝上述必備程序，那么恭喜您！你可以直接前往 安裝 Hexo步驟。

如果您的電腦中尚未安裝所需要的程序，請(qǐng)根據(jù)以下安裝指示完成安裝。

安裝 Git

• Windows：下載并安裝 git_blank.
• Mac：使用 Homebrew, MacPorts_blank 或者下載 安裝程序_blank。
• Linux (Ubuntu, Debian)：sudo apt-get install git-core
• Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core

Mac 用戶如果在編譯時(shí)可能會(huì)遇到問(wèn)題，請(qǐng)先到 App Store 安裝 Xcode，Xcode 完成后，啟動(dòng)并進(jìn)入 Preferences -> Download -> Command Line Tools -> Install 安裝命令行工具。

Windows 用戶對(duì)于中國(guó)大陸地區(qū)用戶，可以前往 淘寶 Git for Windows 鏡像_blank 下載 git 安裝包。

安裝 Node.js

Node.js 為大多數(shù)平臺(tái)提供了官方的 安裝程序_blank。對(duì)于中國(guó)大陸地區(qū)用戶，可以前往 淘寶 Node.js 鏡像_blank 下載。

其它的安裝方法：

• Windows：通過(guò) nvs_blank（推薦）或者nvm_blank 安裝。
• Mac：使用 Homebrew_blank 或 MacPorts_blank 安裝。
• Linux（DEB/RPM-based）：從 NodeSource_blank 安裝。
• 其它：使用相應(yīng)的軟件包管理器進(jìn)行安裝，可以參考由 Node.js 提供的 指導(dǎo)_blank

對(duì)于 Mac 和 Linux 同樣建議使用 nvs 或者 nvm，以避免可能會(huì)出現(xiàn)的權(quán)限問(wèn)題。

Windows 用戶使用 Node.js 官方安裝程序時(shí)，請(qǐng)確保勾選 Add to PATH 選項(xiàng)（默認(rèn)已勾選）

For Mac / Linux 用戶如果在嘗試安裝 Hexo 的過(guò)程中出現(xiàn) EACCES 權(quán)限錯(cuò)誤，請(qǐng)遵循 由 npmjs 發(fā)布的指導(dǎo)_blank 修復(fù)該問(wèn)題。強(qiáng)烈建議 不要 使用 root、sudo 等方法覆蓋權(quán)限

LinuxIf you installed Node.js using Snap, you may need to manually run npm install in the target folder when initializing_blank a blog.

安裝 Hexo

所有必備的應(yīng)用程序安裝完成后，即可使用 npm 安裝 Hexo。

$ npm install -g hexo-cli

進(jìn)階安裝和使用

對(duì)于熟悉 npm 的進(jìn)階用戶，可以僅局部安裝 hexo 包。

$ npm install hexo

安裝以后，可以使用以下兩種方式執(zhí)行 Hexo：

1. npx hexo <command>
2. 將 Hexo 所在的目錄下的 node_modules 添加到環(huán)境變量之中即可直接使用 hexo <command>：echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

Node.js 版本限制

我們強(qiáng)烈建議永遠(yuǎn)安裝最新版本的 Hexo，以及 推薦的 Node.js 版本。