文件

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

什麼是 Hexo?

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

安裝

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

安裝需求

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

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

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

$ npm install -g hexo-cli

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

Mac 使用者

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

安裝 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

安裝 Node.js

安裝 Node.js 的最佳方式是透過 Node Version Manager。感謝 nvm 的開發者提供簡易自動安裝的腳本指令:

cURL:

$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash

Wget:

$ wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash

一旦安裝完成,重啟終端機並執行下列指令以安裝 Node.js。

$ nvm install node
Windows 用户

對於 Windows 用戶我們推薦使用 Node Version Switcher,其具有和 nvm 相似的命令行語法,並且可以通過 Windows Installer (MSI) 安裝包進行安裝。

或者您也可以下載 安裝程式 來安裝。

安裝 Hexo

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

$ npm install -g hexo-cli

Minimum required Node.js version

If you are stuck with older Node.js, you can consider installing a past version of Hexo.

Please note we do not provide bugfixes to past versions of Hexo.

We highly recommend to always install the latest version of Hexo and the recommended version of Node.js, whenever possible.

Hexo version Minimum Node.js version
5.0+ 10.13.0
4.1 - 4.2 8.10
4.0 8.6
3.3 - 3.9 6.9
3.2 - 3.3 0.12
3.0 - 3.1 0.10 or iojs
0.0.1 - 2.8 0.10