Welcome to the Hexo documentation. If you encounter any problems when using Hexo, have a look at the troubleshooting guide, raise an issue on GitHub or start a topic on the Google Group.
What is Hexo?
Hexo is a fast, simple and powerful blog framework. You write posts in Markdown (or other languages) and Hexo generates static files with a beautiful theme in seconds.
Installation
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 I’ll try to solve it.
Requirements
Installing Hexo is quite easy. However, you do need to have a couple of other things installed first:
If your computer already has these, congratulations! Just install Hexo with npm:
$ npm install -g hexo-cli |
If not, please follow the following instructions to install all the requirements.
For Mac usersYou 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 git.
- 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 with Node Version Manager.
Thankfully the creators of nvm provide a simple script that automatically installs nvm:
cURL:
$ curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash |
Wget:
$ wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash |
Once nvm is installed, restart the terminal and run the following command to install Node.js:
$ nvm install stable |
Alternatively, download and run the installer.
Install Hexo
Once all the requirements are installed, you can install Hexo with npm:
$ npm install -g hexo-cli |