Documentación

Bienvenido a la documentación de Hexo. Si encuentras cualquier problema usando Hexo, consulta la guía de solución de problemas, crea una incidencia en GitHub o inicia una conversación en Google Group.

¿Qué es Hexo?

Hexo es un framework de blogs rápido, sencillo y potente. Escribe artículos en Markdown (u otros lenguajes de marcado) y Hexo genera ficheros estáticos con preciosos temas de diseño visuales en segundos.

Instalación

Solo toma unos pocos minutos configurar Hexo. Si encuentras un problema y no encuentras la solución aquí, por favor crea una incidencia en GigHub y te ayudaremos.

Requisitos previos

Instalar Hexo es muy sencillo y solo requiere disponer previamente de:

  • Node.js (Debe ser al menos Node.js 10.13, recomendado 12.0 o superiores)
  • Git

Si tu ordenador ya los tiene, ¡enhorabuena! Puede ir directamente al paso de la instalación de Hexo.

Si no, sigue las instrucciones siguientes para instalar todos los requisitos previos.

Instalar Git

  • Windows: Descarga e instala git.
  • Mac: Instala con Homebrew, MacPorts o el instalador.
  • Linux (Ubuntu, Debian): sudo apt-get install git-core
  • Linux (Fedora, Red Hat, CentOS): sudo yum install git-core
Para usuarios Mac

Puedes encontrar algunos problemas con la compilación. Instala Xcode desde la App Store primero. Después de la instalación de Xcode, abre Xcode y navega hasta Preferences -> Download -> Command Line Tools -> Install para instalar las herramientas de la línea de comandos.

Instalar Node.js

Node.js ofrece un instalador oficial para la mayoría de plataformas.

Métodos de instalación alternativos:

  • Windows: Instala con nvs (recomendado) o nvm.
  • Mac: Instala con Homebrew o MacPorts.
  • Linux (DEB/RPM-based): Instala con NodeSource.
  • Otros: Instala con el gestor de paquetes correspondiente. Consulta esta guía ofrecida por Node.js.

nvs está también recomendado para Mac y Linux para evitar posibles problemas de permisos.

Windows

Si usas el instalador oficial, asegúrate que esté incluido en el PATH y activado (está activado por defecto).

Mac / Linux

Si encuentras el error de permiso EACCES cuando intentas instalar Hexo, sigue esta solución ofrecida por npmjs; ejecutar con root/sudo está altamente desaconsejado.

Linux

Si instalas Node.js con Snap, podrías necesitar ejecutar manualmente npm install en el directorio destino durante la inicialización de un blog.

Instalar Hexo

Una vez que todos los requisitos previos están instalados, puedes instalar Hexo con npm:

$ npm install -g hexo-cli

Instalación avanzada y uso

Los usuarios avanzados pueden preferir instalar y usar el paquete hexo.

$ npm install hexo

Una vez instalado, puedes correr Hexo de dos formas:

  1. npx hexo <command>
  2. Usuarios de Linux pueden establecer la ruta relativa al directorio node_modules/:
echo 'PATH="$PATH:./node_modules/.bin"' >> ~/.profile

y ejecutar hexo usando hexo <command>

Versión requerida de Node.js

Si debes usar una versión antigua de Node.js, puedes considerar instalar una versión pasada de Hexo.

Ten en consideración que no ofrecemos correcciones de errores a versiones pasadas de Hexo.

Recomendamos encarecidamente instalar siempre la última versión de Hexo y la versión recomendada de Node.js, siempre que sea posible.

Versión Hexo Mínima (versión Node.js) Menor que (versión que Node.js)
7.0+ 14.0.0 latest
6.2+ 12.13.0 latest
6.0+ 12.13.0 18.5.0
5.0+ 10.13.0 12.0.0
4.1 - 4.2 8.10 10.0.0
4.0 8.6 8.10.0
3.3 - 3.9 6.9 8.0.0
3.2 - 3.3 0.12 desconocida
3.0 - 3.1 0.10 o iojs desconocida
0.0.1 - 2.8 0.10 desconocida
Siguiente