Contribuindo

We welcome you to join the development of Hexo. 🤗

Desenvolvimento

Nós damos o parabéns a você por se juntar ao desenvolvimento do Hexo. Este documento irá ajudá-lo através do processo.

Antes de Você Começar

Please read Contributor Covenant Code of Conduct first.

Por favor, siga o estilo de codificação:

Also, Hexo has its own ESLint config, so please make sure your contribution will make ESLint happy.

Fluxo de Trabalho

  1. Faça um fork hexojs/hexo.
  2. Clone o repositório no seu computador e instale as dependências.
$ git clone https://github.com/<username>/hexo.git
$ cd hexo
$ npm install
$ git submodule update --init
  1. Crie um branch para a feature a ser desenvolvida.
$ git checkout -b new_feature
  1. Comece a implementação.
  2. Faça o push da branch para seu repositório remoto:
$ git push origin new_feature
  1. Crie um pull request e descreva as mudanças.

Aviso Prévio

  • Não modifique o número da versão no arquivo package.json.
  • Seu pedido de pull request só será aceito quando os testes tiverem passado. Não se esqueça de executar testes antes da submissão.
$ npm test

Updating official-plugins

Also, we welcome PR or issue to official-plugins. 🤗

Atualizando a Documentação

A documentação do Hexo é de código aberto e você pode encontrar o código-fonte em hexojs/site.

Fluxo de trabalho

  1. Faça um fork hexojs/site
  2. Clone o repositório no seu computador e instale as dependências.
$ 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. Comece a editar a documentação. Você pode iniciar o servidor para a visualização das mudanças em tempo real.
$ hexo server
  1. Faça o push da branch para seu repositório remoto:
  2. Crie um pull request e descreva as mudanças.

Traduzindo

  1. Adicione um diretório para o novo idioma dentro do repositório source. (Todas as letras minúsculas)
  2. Copie os arquivos de template e Markdown que estão no source para o diretório do novo idioma.
  3. Adicione o novo idioma a source/_data/language.yml.
  4. Copie o arquivo en.yml em themes/navy/languages e o renomeie para o nome do novo idioma (todas as minúsculas).

Reportando Issues

Quando você encontra alguns problemas ao usar o Hexo, você pode encontrar as soluções em Solução de problemas ou nos perguntar no GitHub ou Google Group. Se você não conseguir encontrar a resposta, abra uma nova issue no GitHub.

  1. Reproduza o problema em modo de depuração.
  2. Follow the steps from issue template to provide debug message and version when submitting a new issue at GitHub.