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:
- Siga o Guia de Estilo de Código JavaScript do Google.
- Use soft-tabs com um recuo de dois espaços.
- Não coloque vírgulas primeiro.
Also, Hexo has its own ESLint config, so please make sure your contribution will make ESLint happy.
Fluxo de Trabalho
- Faça um fork hexojs/hexo.
- Clone o repositório no seu computador e instale as dependências.
$ git clone https://github.com/<username>/hexo.git |
- Crie um branch para a feature a ser desenvolvida.
$ git checkout -b new_feature |
- Comece a implementação.
- Faça o push da branch para seu repositório remoto:
$ git push origin new_feature |
- 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
- Faça um fork hexojs/site
- 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 |
- Comece a editar a documentação. Você pode iniciar o servidor para a visualização das mudanças em tempo real.
$ hexo server |
- Faça o push da branch para seu repositório remoto:
- Crie um pull request e descreva as mudanças.
Traduzindo
- Adicione um diretório para o novo idioma dentro do repositório
source
. (Todas as letras minúsculas) - Copie os arquivos de template e Markdown que estão no
source
para o diretório do novo idioma. - Adicione o novo idioma a
source/_data/language.yml
. - Copie o arquivo
en.yml
emthemes/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.
- Reproduza o problema em modo de depuração.
- Follow the steps from issue template to provide debug message and version when submitting a new issue at GitHub.