文件

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

什麼是 Hexo？

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

安裝

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

安裝需求

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

  • Node.js (Node.js 版本需不低於8.6，建議使用 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