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. Start hacking.
  2. Push the branch:
$ git push origin new_feature
  1. Crie um pull request e descreva as mudanças.

Notice

  • 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. Push the branch.
  2. Crie um pull request e descreva as mudanças.

Traduzindo

Contribute translations

Crowdin

Now we use the Crowdin platform for translation, where anyone can contribute translations and vote for translations without manual git operations.

Add a new language

  1. Submit a new issue to let us know. The members with access to the Crowdin Project add the language in settings.
  2. After adding language in Crowdin, anyone can contribute translations on it.
  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.
Anterior