Merge pull request #7437 from fplucas/master
📝 Translation of CONTRIBUTING.md to pt-br [ci skip]
This commit is contained in:
Kevin Sawicki
GitHub
commit
bb04069e83
4 changed files with 81 additions and 49 deletions
|
|
@ -1,6 +1,6 @@
|
||||||
# Contributing to Electron
|
# Contributing to Electron
|
||||||
|
|
||||||
:memo: Available Translations: [Korean](https://github.com/electron/electron/tree/master/docs-translations/ko-KR/project/CONTRIBUTING.md) | [Simplified Chinese](https://github.com/electron/electron/tree/master/docs-translations/zh-CN/project/CONTRIBUTING.md)
|
:memo: Available Translations: [Korean](https://github.com/electron/electron/tree/master/docs-translations/ko-KR/project/CONTRIBUTING.md) | [Simplified Chinese](https://github.com/electron/electron/tree/master/docs-translations/zh-CN/project/CONTRIBUTING.md) | [Brazilian Portuguese](https://github.com/electron/electron/tree/master/docs-translations/pt-BR/project/CONTRIBUTING.md)
|
||||||
|
|
||||||
:+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
|
:+1::tada: First off, thanks for taking the time to contribute! :tada::+1:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -40,7 +40,7 @@ Existem muitas perguntas comuns que são feitas, verifique antes de criar uma is
|
||||||
|
|
||||||
### Elementos DOM Personalizados:
|
### Elementos DOM Personalizados:
|
||||||
|
|
||||||
* [Objeto `File`](../../docs/api/file-object.md)
|
* [Objeto `File`](../../docs-translations/pt-BR/api/file-object.md)
|
||||||
* [Tag `<webview>`](../../docs/api/web-view-tag.md)
|
* [Tag `<webview>`](../../docs/api/web-view-tag.md)
|
||||||
* [Função `window.open`](../../docs/api/window-open.md)
|
* [Função `window.open`](../../docs/api/window-open.md)
|
||||||
|
|
||||||
|
|
|
||||||
31
docs-translations/pt-BR/api/file-object.md
Normal file
31
docs-translations/pt-BR/api/file-object.md
Normal file
|
|
@ -0,0 +1,31 @@
|
||||||
|
# `File` Object
|
||||||
|
|
||||||
|
> Use a API `File` do HTML5 para funcionar nativamente com os arquivos do sistema.
|
||||||
|
|
||||||
|
|
||||||
|
A interface dos arquivos DOM promovem uma abstração dos arquivos nativos, permitindo que os usuários trabalhem em arquivos nativos diretamente com a API file do HTML5. O Electron adicionou um atributo `path` à interface `File` que exibe o caminho do arquivo no sistema.
|
||||||
|
|
||||||
|
Exemplo de como obter o caminho de um arquivo arrastado para a aplicação:
|
||||||
|
|
||||||
|
```html
|
||||||
|
<div id="holder">
|
||||||
|
Arraste e solte seu arquivo aqui
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<script>
|
||||||
|
const holder = document.getElementById('holder')
|
||||||
|
holder.ondragover = () => {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
holder.ondragleave = holder.ondragend = () => {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
holder.ondrop = (e) => {
|
||||||
|
e.preventDefault()
|
||||||
|
for (let f of e.dataTransfer.files) {
|
||||||
|
console.log('Arquivo(s) arrastados: ', f.path)
|
||||||
|
}
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
</script>
|
||||||
|
```
|
||||||
|
|
@ -1,73 +1,74 @@
|
||||||
# Contribuindo para Electron
|
# Contribuindo com Electron
|
||||||
|
|
||||||
:memo: Traduções Disponíveis: [Korean](https://github.com/electron/electron/tree/master/docs-translations/ko-KR/project/CONTRIBUTING.md) | [Simplified Chinese](https://github.com/electron/electron/tree/master/docs-translations/zh-CN/project/CONTRIBUTING.md) | [Português do Brasil](https://github.com/electron/electron/tree/master/docs-translations/pt-BR/project/CONTRIBUTING.md)
|
:memo: Traduções disponíveis: [Inglês](https://github.com/electron/electron/tree/master/CONTRIBUTING.md) | [Coreano](https://github.com/electron/electron/tree/master/docs-translations/ko-KR/project/CONTRIBUTING.md) | [Chinês Simplificado](https://github.com/electron/electron/tree/master/docs-translations/zh-CN/project/CONTRIBUTING.md)
|
||||||
|
|
||||||
:+1::tada: Em primeiro lugar, obrigado pelo seu tempo para contribuir! :tada::+1:
|
:+1::tada: Primeiramente, obrigado por utilizar seu tempo contribuindo! :tada::+1:
|
||||||
|
|
||||||
Este projeto obedece ao Pacto do Colaborador [código de conduta](CODE_OF_CONDUCT.md).
|
Esse projeto segue um [código de conduta](CODE_OF_CONDUCT.md).
|
||||||
Ao participar, é esperado que você mantenha este código. Por favor, reporte o comportamento inesperado para atom@github.com.
|
Ao participar, é esperado que o código seja seguido. Favor reportar comportamentos inaceitáveis para atom@github.com.
|
||||||
|
|
||||||
A seguir um conjunto de diretrizes para contribuir para Electron. Estas são apenas diretrizes, não são regras, use-as com bom senso e sinta-se livre para propor alterações a este documento através de um pull request.
|
O texto a seguir é um conjunto de diretrizes para a contribuir com o Electron.
|
||||||
|
Estas são apenas diretrizes e não regras, use o seu bom senso e sinta-se livre para propor alterações nesse documento em um pull request.
|
||||||
|
|
||||||
## Reportando Issues
|
## Reportando Issues
|
||||||
|
|
||||||
* Você pode criar uma issue [aqui](https://github.com/electron/electron/issues/new),
|
* Você pode criar uma issue [aqui](https://github.com/electron/electron/issues/new),
|
||||||
mas antes de fazer, por favor leia as notas abaixo e inclua o maior número de detalhes possíveis do problema. Se puder, por favor inclua:
|
mas antes disso, por favor, leia as notas abaixo e inclua o máximo de detalhes possíveis em seu relato. Se puder, favor informar:
|
||||||
* A versão do Electron que estiver usando
|
* A versão do Electron utilizada
|
||||||
* O sistema operacional que estiver usando
|
* O sistema operacional utilizado
|
||||||
* Se possível, o que estava fazendo quando ocorreu o problema e o que esperava que acontecesse
|
* Se possível, o que estava fazendo quando o problema ocorreu e o que era esperado que acontecesse
|
||||||
* Outras coisas que poderão ajudar a resolver o problema:
|
* Alguns outros meios que irão ajudar a resolver a issue:
|
||||||
* Captura de telas e GIFs animados
|
* Capturas de tela e GIFs animados
|
||||||
* O erro que aparece no terminal, ferramentas de desenvolvimento ou alertas lançados
|
* Saída de erro que aparece no terminal, dev tools ou algum em algum alerta
|
||||||
* Realizar uma [pesquisa rápida](https://github.com/electron/electron/issues?utf8=✓&q=is%3Aissue+)
|
* Faça uma [pesquisa rápida](https://github.com/electron/electron/issues?utf8=✓&q=is%3Aissue+)
|
||||||
para ver se um problema semelhante já não foi reportado
|
para verificar se já não existe uma issue similar já aberta
|
||||||
|
|
||||||
## Submetendo Pull Requests
|
## Submetendo Pull Requests
|
||||||
|
|
||||||
* Incluir captura de telas e GIFs animados no pull request sempre que possível.
|
* Inclua capturas de tela e GIFs animados em seu pull request sempre que possível.
|
||||||
* Seguir o [estilo de código definido na documento](/docs-translations/pt-BR/development/coding-style.md) do JavaScript, C++, and Python.
|
* Siga os [padrões de código definidos nos documentos](/docs/development/coding-style.md) para JavaScript, C++, e Python.
|
||||||
* Escrever a documentação em [Markdown](https://daringfireball.net/projects/markdown).
|
* Escreva a documentação em [Markdown](https://daringfireball.net/projects/markdown).
|
||||||
Veja o [guia de estilo da documentação](/docs-translations/pt-BR/styleguide.md).
|
Veja o [Guia de estilo de documentação](/docs/styleguide.md).
|
||||||
* Escreva mensagens curtas e no tempo presente para o commit. Veja [guia de estilo para mensagens de commit](#git-commit-messages).
|
* Use mensagens curtas e com a conjugação verbal no tempo presente. Veja em [Guia de estilo de mensagens de commit](#git-commit-messages).
|
||||||
|
|
||||||
## Guias de Estilo
|
## Guias de estilo
|
||||||
|
|
||||||
### Código Geral
|
### Código Geral
|
||||||
|
|
||||||
* Terminar arquivos com uma nova linha.
|
* Terminar arquivos com uma nova linha.
|
||||||
* Coloque na seguinte sequência:
|
* A organização deve estar na seguinte ordem:
|
||||||
* Construa um módulos nó (como `path`)
|
* Módulos embutidos do Node (como o `path`)
|
||||||
* Construa um módulos Electron (como `ipc`, `app`)
|
* Módulos embutidos do Electron (como `ipc`, `app`)
|
||||||
* Módulos locais (use caminhos relativos)
|
* Módulos locais (usando caminhos relativos)
|
||||||
* Coloque propriedades da classe na seguinte sequência:
|
* Defina as propriedades da classe na seguinte ordem:
|
||||||
* Métodos e propriedades da classe (métodos começando com um `@`)
|
* Métodos e propriedades da classe (métodos iniciam com `@`)
|
||||||
* Métodos e propriedades de instância
|
* Métodos e propriedades de instância
|
||||||
* Evite código dependente de plataforma:
|
* Evite o uso de códigos dependentes da plataforma:
|
||||||
* Use `path.join()` para concatenar nomes de arquivos.
|
* Use `path.join()` para concatenar nomes de arquivos.
|
||||||
* Use `os.tmpdir()` ao inves de `/tmp` quando precisar fazer referência ao diretório temporário.
|
* Use `os.tmpdir()` ao invés de `/tmp` quando precisar referenciar o diretório temporário.
|
||||||
* Use um simples `return` explicitamente no final de uma função com retorno.
|
* Use um simples `return` para retornar explícitamente o fim de uma função.
|
||||||
* Nao `return null`, `return undefined`, `null`, ou `undefined`
|
* Não usar `return null`, `return undefined`, `null`, ou `undefined`
|
||||||
|
|
||||||
### Mensagens Git Commit
|
### Mensagens de Commit do Git
|
||||||
|
|
||||||
* Use o tempo presente("Add feature" não "Added feature")
|
* Use o tempo presente ("Adicionando função" não "Adicionada função")
|
||||||
* Use o modo imperativo ("Move cursor to..." não "Moves cursor to...")
|
* Use o modo imperativo ("Mova o cursor para..." não "O cursor deve ser movido...")
|
||||||
* Limitar a primeira linha para 72 caracteres ou menos
|
* Limite a primeira linha para 72 caracteres ou menos
|
||||||
* Referênciar issues e pull requests liberalmente
|
* Referencie issues e pull requests livremente
|
||||||
* Quando apenas a documentação mudar, inclua `[ci skip]` na descrição do commit
|
* Quando alterar somente a documentação. inclua `[ci skip]` na descrição do commit
|
||||||
* Considere começar a mensagem do commit aplicando um emoji:
|
* Considerando iniciar a mensagem do commit com um emoji:
|
||||||
* :art: `:art:` quando melhorar o formato/estrutura do código
|
* :art: `:art:` quando aperfeiçoar o formato/estrutura do código
|
||||||
* :racehorse: `:racehorse:` quando melhorar o desempenho
|
* :racehorse: `:racehorse:` quando aperfeiçoar a performance
|
||||||
* :non-potable_water: `:non-potable_water:` quando acabar com vazamento de memória
|
* :non-potable_water: `:non-potable_water:` quando previnir vazamento de memória
|
||||||
* :memo: `:memo:` quando escrever documentação
|
* :memo: `:memo:` quando escrever documentação
|
||||||
* :penguin: `:penguin:` quando corrigir algo no Linux
|
* :penguin: `:penguin:` quando corrigir algo no Linux
|
||||||
* :apple: `:apple:` quando corrigir algo no macOS
|
* :apple: `:apple:` quando corrigir algo no OSX
|
||||||
* :checkered_flag: `:checkered_flag:` quando corrigir algo no Windows
|
* :checkered_flag: `:checkered_flag:` quando corrigir algo no Windows
|
||||||
* :bug: `:bug:` quando corrigir um bug
|
* :bug: `:bug:` quando corrigir um bug
|
||||||
* :fire: `:fire:` quando remover código ou arquivos
|
* :fire: `:fire:` quando remover código ou arquivos
|
||||||
* :green_heart: `:green_heart:` quando corrigir a compilação CI
|
* :green_heart: `:green_heart:` quando corrigir o build do CI
|
||||||
* :white_check_mark: `:white_check_mark:` quando adicionar testes
|
* :white_check_mark: `:white_check_mark:` quando adicionar testes
|
||||||
* :lock: `:lock:` quando se trata de segurança
|
* :lock: `:lock:` quando estiver lidando com segurança
|
||||||
* :arrow_up: `:arrow_up:` quando upgrading dependências
|
* :arrow_up: `:arrow_up:` quando atualizar dependências
|
||||||
* :arrow_down: `:arrow_down:` quando downgrading dependências
|
* :arrow_down: `:arrow_down:` quando abaixar as dependências
|
||||||
* :shirt: `:shirt:` quando remover advertências linter
|
* :shirt: `:shirt:` quando remover avisos do linter
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue