Documentation

Welcome to the Hexo’s documentation. This documentation will help you get started fast. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub or Google Group.

What’s Hexo?

Hexo is a fast, simple and powerful blog framework. It parses your posts with Markdown or other render engine and generates static files with the beautiful theme. All of these just take seconds.

Installation

It only takes few minutes for you to get Hexo ready. If you encounter any problems on installation and you can’t find the solution here. Please submit an issue and I’ll try to solve your problems.

Requirements

Installing Hexo is quite easy. However, there’re something required before you get started.

If your computer has been installed the requirements above already. Congratulations! Just install Hexo with npm.

$ npm install -g hexo

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

For Mac users

You may encounter some problems when compiling. Please install Xcode from App Store first. After Xcode is installed, open Xcode and go to Preferences -> Download -> Command Line Tools -> Install to install command line tools.

Install Git

  • Windows: Download & install msysgit.
  • Mac: Install it with Homebrew, MacPorts or installer.
  • Linux (Ubuntu, Debian): sudo apt-get install git-core
  • Linux (Fedora, Red Hat, CentOS): sudo yum install git-core

Install Node.js

The best way to install Node.js is installing with nvm.

cURL:

$ curl https://raw.github.com/creationix/nvm/master/install.sh | sh

Wget:

$ wget -qO- https://raw.github.com/creationix/nvm/master/install.sh | sh

Once installed, restart the terminal and run the following command to install Node.js.

$ nvm install 0.10

Or you can download the installer and install it.

Install Hexo

Once all the requirements are installed, you can install Hexo with npm.

$ npm install -g hexo
Next