Documentação

Bem-vindo à documentação do Hexo. Se você encontrar algum problema ao usar o Hexo, dê uma olhada no guia de solução de problemas, abra uma issue no GitHub ou inicie um tópico no Google Group.

O que é o Hexo?

O Hexo é uma ferramenta simples, rápida e poderosa para criação blog. Você escreve postagens em Markdown (ou outras linguagens) e o Hexo gera arquivos estáticos com um lindo tema em segundos.

Instalação

Demora apenas alguns minutos para configurar o Hexo. Se você encontrar um problema e não conseguir encontrar a solução aqui, por favor abra uma issue no GitHub e vamos tentar resolvê-lo.

Requerimentos

Instalar o Hexo é bastante fácil. No entanto, você precisa ter algumas outras coisas instaladas primeiro:

  • Node.js (Should be at least Node.js 8.6, recommends 10.0 or higher)
  • Git

Se o seu computador já possui estes, parabéns! Basta instalar o Hexo com o npm:

$ npm install -g hexo-cli

Caso contrário, siga as instruções a seguir para instalar todos os requisitos.

Para usuários Mac

Você pode encontrar alguns problemas ao compilar. Instale o Xcode da App Store primeiro. Depois que o Xcode estiver instalado, abra o Xcode e vá para Preferences -> Download -> Command Line Tools -> Install para instalar as ferramentas de linhas de comandos.

Instalando o Git

  • Windows: Download e instalação do Git.
  • Mac: Intalação com o Homebrew, MacPorts ou installer.
  • Linux (Ubuntu, Debian): sudo apt-get install git-core
  • Linux (Fedora, Red Hat, CentOS): sudo yum install git-core

Instalando o Node.js

A melhor maneira de instalar o Node.js é com o Node Version Manager.
Felizmente, os criadores do nvm fornecem um script simples que instala automaticamente o 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

Uma vez que o nvm esteja instalado, reinicie o terminal e execute o seguinte comando para instalar o Node.js:

$ nvm install node
For Windows users

We recommend to use Node Version Switcher as an alternative to nvm on Windows, which has similar command-line syntax with nvm and can be installed through provided Windows Installer (MSI) package.

Alternativamente, é possível baixar e executar o instalador do Node.js.

Instalando Hexo

Uma vez que todos os requisitos estão instalados, você pode instalar o Hexo com npm:

$ npm install -g hexo-cli
Próximo