Contribución

Te damos la bienvenida al desarrollo de Hexo. 🤗

Desarrollo

Te damos la bienvenida al desarrollo de Hexo. Este documento te guiará en el proceso.

Antes de empezar

Por favor, lee antes el código de conducta del pacto de colaboradores.

Por favor, sigue el estilo de codificación:

También, Hexo tiene su propia configuración ESLint, así que, asegúrate que tu contribución haga feliz a ESLint.

Flujo de trabajo

  1. Bifurca hexojs/hexo.
  2. Clona el repositorio en tu ordenador e instala las dependencias.
$ git clone https://github.com/<username>/hexo.git
$ cd hexo
$ npm install
$ git submodule update --init
  1. Crea una rama de funcionalidad.
$ git checkout -b new_feature
  1. Empieza a programar.
  2. Sube la rama:
$ git push origin new_feature
  1. Crea un pull request y describe el cambio.

Advertencia

  • Por favor, no modifiques el número de versión en package.json.
  • Tu pull request soló se fusionará cuando pase los tests. No olvides ejecutar los tests antes de enviar tu código.
$ npm test

Actualización de complementos oficiales

También aceptamos PR o incidencias a complementos oficiales. 🤗

Actualizando la documentación

La documentación de Hexo es de código abierto y puedes encontrar el código fuente en hexojs/site.

Flujo de trabajo

  1. Bifurca hexojs/site
  2. Clona el repositorio e instala las dependencias.
$ npm install hexo-cli -g # If you don't have hexo-cli installed
$ git clone https://github.com/<username>/site.git
$ cd site
$ npm install
  1. Comienza a editar la documentación. Puedes arrancar el servidor visionado previo en vivo.
$ hexo server
  1. Empuja la rama.
  2. Crea un pull request y describe el cambio.

Traducción

Contribución a las traducciones

Crowdin

Usamos la plataforma Crowdin para la traducción, donde cualquiera puede contribuir a las traducciones y votar sin operaciones manuales en git.

Añadir un nuevo idioma

  1. Sube una nueva incidencia para hacérnoslo saber. Los miembros con acceso al proyecto en Crowdin incluirán el idioma en los ajustes.
  2. Después de añadir el idioma en Crowdin, cualquiera puede contribuir a las traducciones a través de la plataforma.
  3. Incluye el nuevo idioma a source/_data/language.yml.
  4. Copia en.yml en themes/navy/languages y renómbralo al nombre del idioma (en minúsculas).

Notificando incidencias

Cuando encuentres problemas usando Hexo, puedes buscar en la solución de problemas o preguntarme en GitHub o Google Group. Si no encuentras la solución, por favor, informa de él en GitHub.

  1. Reproduce el problema en debug mode.
  2. Sigue los pasos de la plantilla de incidencias para incluir un mensaje de depuración y versión cuando notifiques una nueva incidencia en GitHub.
Previo