文件

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

什麼是 Hexo?

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

安裝

It only takes a few minutes to set up Hexo. If you encounter a problem and can’t find the solution here, please submit a GitHub issue and we’ll help.

安裝需求

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

  • Node.js (Node.js 版本需不低於8.10,建議使用 Node.js 10.0 及以上版本)
  • Git

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

If not, please follow the following instructions to install all the requirements.

安裝 Git

  • Windows:下載並安裝 git.
  • Mac:使用 Homebrew, MacPorts安裝程式 安裝。
  • Linux (Ubuntu, Debian):sudo apt-get install git-core
  • Linux (Fedora, Red Hat, CentOS):sudo yum install git-core
Mac 使用者

You may encounter some problems when compiling. Please install Xcode from App Store first. 您在編譯時可能會碰到問題,請先至 App Store 安裝 Xcode,一旦 Xcode 安裝完成後,開啟它並前往 Preferences -> Download -> Command Line Tools -> Install 安裝命令列工具。

安裝 Node.js

Node.js 為大多數平台提供了官方的 安裝程序

其它的安裝方法:

  • Windows:通過 nvs(推薦)或者nvm 安裝。
  • Mac:使用 HomebrewMacPorts 安裝。
  • Linux(DEB/RPM-based):從 NodeSource 安裝。
  • Others: Install it through respective package manager. 其它:使用相應的軟件包管理器進行安裝,可以參考由 Node.js 提供的 指導

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

Windows

使用 Node.js 官方安裝程序時,請確保勾選 Add to PATH 選項(默認已勾選)

Mac / Linux

如果在嘗試安裝Hexo 的過程中出現EACCES 權限錯誤,請遵循由npmjs 發布的指導 修復該問題。

Linux

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

安裝 Hexo

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

$ npm install -g hexo-cli

Advanced installation and usage

Advanced users may prefer to install and use hexo package instead.

$ npm install hexo

Once installed, you can run Hexo in two ways:

  1. npx hexo <command>
  2. Linux users can set relative path of node_modules/ folder:
echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

then run Hexo using hexo <command>

必要的 Node.js 版本

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

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

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

Hexo 版本 最小可行 (Node.js 版本) 小於 (Node.js 版本)
7.0+ 14.0.0 latest
6.2+ 12.13.0 latest
6.0+ 12.13.0 18.5.0
5.0+ 10.13.0 12.0.0
4.1 - 4.2 8.10 10.0.0
4.0 8.6 8.10.0
3.3 - 3.9 6.9 8.0.0
3.2 - 3.3 0.12 unknown
3.0 - 3.1 0.10 or iojs unknown
0.0.1 - 2.8 0.10 unknown