diff --git a/locales/pt/LC_MESSAGES/CONTRIBUTING.po b/locales/pt/LC_MESSAGES/CONTRIBUTING.po index 29863f4de..23fda47e9 100644 --- a/locales/pt/LC_MESSAGES/CONTRIBUTING.po +++ b/locales/pt/LC_MESSAGES/CONTRIBUTING.po @@ -22,19 +22,19 @@ msgstr "" #: ../../CONTRIBUTING.md:4 msgid "Contributing to the Python Packaging Guide" -msgstr "" +msgstr "Contribuindo para o Guia de Empacotamento Python" #: ../../CONTRIBUTING.md:6 msgid "The guide is a community resource." -msgstr "" +msgstr "O guia é um recurso da comunidade." #: ../../CONTRIBUTING.md:8 msgid "TL;DR" -msgstr "" +msgstr "TL;DR" #: ../../CONTRIBUTING.md:10 msgid "We welcome contributions in the form of issues and pull requests:" -msgstr "" +msgstr "Recebemos contribuições na forma de issues e pull requests:" #: ../../CONTRIBUTING.md:12 msgid "" @@ -42,6 +42,9 @@ msgid "" "[please open an issue here](https://github.com/pyOpenSci/python-package-" "guide/issues)." msgstr "" +"Se você tem uma ideia de algo que deveria ser incluído no guia, " +"[por favor abra uma issue aqui](https://github.com/pyOpenSci/python-package-" +"guide/issues)." #: ../../CONTRIBUTING.md:13 msgid "" @@ -50,28 +53,38 @@ msgid "" "modify the text directly. Or, if you are less comfortable with pull " "requests, feel free to open an issue." msgstr "" +"Se você encontrar um erro de digitação, sinta-se à vontade para [enviar um pull " +"request](https://github.com/pyOpenSci/python-package-guide/pulls) para " +"modificar o texto diretamente. Ou, se você não se sentir tão confortável com pull " +"requests, sinta-se à vontade para abrir uma issue." #: ../../CONTRIBUTING.md:14 msgid "" "If you are interested in helping translate the guide into other " "languages, take a look at the [translation guide](./TRANSLATING.md)." msgstr "" +"Se você tem interesse em ajudar a traduzir o guia para outros " +"idiomas, dê uma olhada no [guia de tradução](./TRANSLATING.md)." #: ../../CONTRIBUTING.md:15 msgid "" "If you want to see a larger change to the content of the guide book, " "please submit an issue first!" msgstr "" +"Se você quiser propor uma mudança maior no conteúdo do guia, " +"por favor abra uma issue primeiro!" #: ../../CONTRIBUTING.md:17 msgid "" "If you are unsure about how to contribute or are not familiar with git " "and github, this guide will help you through the process." msgstr "" +"Se você não tem certeza de como contribuir ou não está familiarizado com git " +"e github, este guia vai te ajudar durante todo o processo." #: ../../CONTRIBUTING.md:19 msgid "How the Python Packaging Guide is structured" -msgstr "" +msgstr "Como o Guia de Empacotamento Python é estruturado" #: ../../CONTRIBUTING.md:21 msgid "" @@ -79,18 +92,21 @@ msgid "" "rST) and we use **Sphinx**, a documentation engine built in `Python` to " "build the HTML version you see online." msgstr "" +"O Guia de Empacotamento Python é escrito em myST (uma variante de MarkDown e " +"rST) e usamos o **Sphinx**, um mecanismo de documentação construído em `Python` para " +"gerar a versão em HTML que você vê online." #: ../../CONTRIBUTING.md:23 msgid "We use a tool called Nox to manage the process of building the guide." -msgstr "" +msgstr "Usamos uma ferramenta chamada Nox para gerenciar o processo de construção do guia." #: ../../CONTRIBUTING.md:25 msgid "Two approaches to contributing" -msgstr "" +msgstr "Duas formas de contribuir" #: ../../CONTRIBUTING.md:27 msgid "You can contribute to the guide using two approaches." -msgstr "" +msgstr "Você pode contribuir com o guia usando duas abordagens." #: ../../CONTRIBUTING.md:29 msgid "" @@ -100,6 +116,11 @@ msgid "" "before submitting a pull request. It is the recommended approach for " "larger contribution, like writing a whole new section." msgstr "" +"A primeira abordagem é usar uma cópia local do guia no seu computador. " +"Essa opção exige uma configuração mais elaborada, mas permite que você construa o " +"guia localmente para verificar se sua contribuição não introduziu nenhum bug " +"antes de enviar um pull request. É a abordagem recomendada para " +"contribuições maiores, como escrever uma seção inteiramente nova." #: ../../CONTRIBUTING.md:31 msgid "" @@ -111,10 +132,17 @@ msgid "" "fixing typos, or if this is your first contribution to open source and " "the first approach feels too intimidating." msgstr "" +"A segunda abordagem é fazer sua contribuição diretamente no site do " +"GitHub. Essa opção não exige nenhuma configuração no seu computador e, " +"embora sua contribuição ainda seja testada quando você enviar um PR " +"(integração contínua), vai demorar mais para você receber algum feedback" +" caso haja algum problema. É a melhor forma de fazer pequenas contribuições, como " +"corrigir erros de digitação, ou se essa for sua primeira contribuição para open source e " +"a primeira abordagem parecer intimidadora demais." #: ../../CONTRIBUTING.md:33 msgid "Forking the repository" -msgstr "" +msgstr "Fazendo um fork do repositório" #: ../../CONTRIBUTING.md:35 msgid "" @@ -123,6 +151,10 @@ msgid "" "can do this by clicking the \"Fork\" button in the top right corner of " "the repository page." msgstr "" +"Independentemente da abordagem que você escolher, o primeiro passo é fazer um fork do " +"repositório do Guia de Empacotamento Python para o seu espaço pessoal no GitHub. Você " +"pode fazer isso clicando no botão \"Fork\" no canto superior direito da " +"página do repositório." #: ../../CONTRIBUTING.md:38 msgid "" @@ -130,20 +162,25 @@ msgid "" "Repos](https://datascienceskills.org/lessons/git-github/git-intro/3-fork-" "clone/) is a good resource to learn more about forking." msgstr "" +"[Saiba mais: Fork and Clone GitHub " +"Repos](https://datascienceskills.org/lessons/git-github/git-intro/3-fork-" +"clone/) é um bom recurso para aprender mais sobre fork." #: ../../CONTRIBUTING.md:40 msgid "To fork a repo," -msgstr "" +msgstr "Para fazer um fork de um repositório," #: ../../CONTRIBUTING.md:42 msgid "Make sure you are logged into GitHub." -msgstr "" +msgstr "Certifique-se de que você está logado no GitHub." #: ../../CONTRIBUTING.md:44 msgid "" "Go to the repo you would like to fork, in this case the [Python Packaging" " Guide](https://github.com/pyopensci/python-package-guide) repo." msgstr "" +"Vá até o repositório do qual você gostaria de fazer um fork, nesse caso o [Python Packaging" +" Guide](https://github.com/pyopensci/python-package-guide)." #: ../../CONTRIBUTING.md:46 msgid "" @@ -154,14 +191,20 @@ msgid "" "`https://github.com//python-package-guide`, where `` " "is your GitHub username." msgstr "" +"No canto superior direito da página há um botão 'Fork'. Clique " +"nesse botão. Você será levado a uma nova página onde vai 'Create a " +"new fork'. Sinta-se à vontade para manter todas as opções padrão e clicar em 'Create " +"fork'. Isso vai criar uma cópia do repositório em " +"`https://github.com//python-package-guide`, onde `` " +"é o seu nome de usuário do GitHub." #: ../../CONTRIBUTING.md:51 msgid "Contributing via the GitHub website" -msgstr "" +msgstr "Contribuindo pelo site do GitHub" #: ../../CONTRIBUTING.md:53 msgid "How to edit a MarkDown file" -msgstr "" +msgstr "Como editar um arquivo MarkDown" #: ../../CONTRIBUTING.md:55 msgid "" @@ -170,34 +213,42 @@ msgid "" " the file you want to edit and click the pencil icon in the top right " "corner of the file." msgstr "" +"O Guia de Empacotamento Python é escrito em myST, uma variante de MarkDown. Você" +" pode editar os arquivos diretamente no site do GitHub. Para fazer isso, navegue até" +" o arquivo que deseja editar e clique no ícone de lápis no canto superior " +"direito do arquivo." #: ../../CONTRIBUTING.md:58 msgid "Edit button in GitHub" -msgstr "" +msgstr "Botão de editar no GitHub' #: ../../CONTRIBUTING.md:64 msgid "" "An image showing how to edit a file in GitHub. The pencil icon is " "highlighted with a red rectangle." msgstr "" +"Uma imagem mostrando como editar um arquivo no GitHub. O ícone de lápis está " +"destacado com um retângulo vermelho." #: ../../CONTRIBUTING.md:66 msgid "Edit file in GitHub" -msgstr "" +msgstr "Editar arquivo no GitHub" #: ../../CONTRIBUTING.md:72 msgid "" "An image showing when a file is being edited in GitHub. The file content " "is displayed in a text editor." msgstr "" +"Uma imagem mostrando um arquivo sendo editado no GitHub. O conteúdo do arquivo " +"é exibido em um editor de texto." #: ../../CONTRIBUTING.md:75 msgid "To preview your changes, click the \"Preview changes\" tab." -msgstr "" +msgstr "Para pré-visualizar suas alterações, clique na aba \"Preview changes\"." #: ../../CONTRIBUTING.md:77 msgid "Preview changes in GitHub" -msgstr "" +msgstr "Pré-visualizar alterações no GitHub" #: ../../CONTRIBUTING.md:83 msgid "" @@ -205,10 +256,13 @@ msgid "" "displayed in a text editor. The preview changes tab is highlighted with a" " red rectangle." msgstr "" +"Uma imagem mostrando como pré-visualizar alterações no GitHub. O conteúdo do " +"arquivo é exibido em um editor de texto. A aba de preview changes está " +"destacada com um retângulo vermelho." #: ../../CONTRIBUTING.md:86 msgid "How to commit your changes" -msgstr "" +msgstr "Como fazer commit das suas alterações" #: ../../CONTRIBUTING.md:88 msgid "" @@ -217,10 +271,14 @@ msgid "" "write a title and a description for your changes. Make sure to write a " "clear and concise title that describes the changes you made." msgstr "" +"Quando você terminar de editar o arquivo, role a página até o final. " +"Você vai ver uma seção chamada \"Commit changes\". Aqui você pode " +"escrever um título e uma descrição para as suas alterações. Certifique-se de escrever um " +"título claro e conciso que descreva as alterações que você fez." #: ../../CONTRIBUTING.md:91 msgid "Commit changes in GitHub" -msgstr "" +msgstr "Fazer commit das alterações no GitHub" #: ../../CONTRIBUTING.md:97 msgid "" @@ -228,20 +286,25 @@ msgid "" "displayed in a text editor. The commit changes section is highlighted " "with a red rectangle." msgstr "" +"Uma imagem mostrando como fazer commit de alterações no GitHub. A mensagem de commit " +"é exibida em um editor de texto. A seção de commit changes está destacada " +"com um retângulo vermelho." #: ../../CONTRIBUTING.md:100 msgid "" "After writing your commit message, click the \"Commit changes\" button to" " save your changes." msgstr "" +"Depois de escrever sua mensagem de commit, clique no botão \"Commit changes\" para" +" salvar suas alterações." #: ../../CONTRIBUTING.md:102 msgid "Contributing locally on your computer" -msgstr "" +msgstr "Contribuindo localmente no seu computador" #: ../../CONTRIBUTING.md:104 msgid "Clone your forked repository" -msgstr "" +msgstr "Clone o seu repositório com fork" #: ../../CONTRIBUTING.md:106 msgid "" @@ -249,16 +312,21 @@ msgid "" "URL of your forked repository and run the following command in your " "terminal:" msgstr "" +"Para clonar o seu repositório com fork no seu computador, você precisa copiar a " +"URL do seu repositório com fork e executar o seguinte comando no seu " +"terminal:" #: ../../CONTRIBUTING.md:111 msgid "" "Replace `` with the URL of your forked repository. You can find the " "URL by clicking the green \"Code\" button on your forked repository page." msgstr "" +"Substitua `` pela URL do seu repositório com fork. Você pode encontrar a " +"URL clicando no botão verde \"Code\" na página do seu repositório com fork." #: ../../CONTRIBUTING.md:113 msgid "Clone repository in GitHub" -msgstr "" +msgstr "Clonar repositório no GitHub" #: ../../CONTRIBUTING.md:119 msgid "" @@ -266,10 +334,13 @@ msgid "" "repository is displayed in a text editor. The code button is highlighted " "with a red rectangle." msgstr "" +"Uma imagem mostrando como clonar um repositório no GitHub. A URL do " +"repositório é exibida em um editor de texto. O botão code está destacado " +"com um retângulo vermelho." #: ../../CONTRIBUTING.md:122 msgid "Create a new branch" -msgstr "" +msgstr "Crie uma nova branch" #: ../../CONTRIBUTING.md:124 msgid "" @@ -277,14 +348,17 @@ msgid "" "This will help keep your changes separate from the main branch and make " "it easier to submit a pull request." msgstr "" +"Antes de fazer qualquer alteração, você deve criar uma nova branch para trabalhar. " +"Isso vai ajudar a manter suas alterações separadas da branch principal e vai " +"facilitar o envio de um pull request." #: ../../CONTRIBUTING.md:126 msgid "To create a new branch, run the following command in your terminal:" -msgstr "" +msgstr "Para criar uma nova branch, execute o seguinte comando no seu terminal:" #: ../../CONTRIBUTING.md:132 msgid "Create a virtual environment" -msgstr "" +msgstr "Crie um ambiente virtual" #: ../../CONTRIBUTING.md:134 msgid "" @@ -292,56 +366,65 @@ msgid "" "install the dependencies. You can do this by running the following " "commands in your terminal:" msgstr "" +"Para construir o guia localmente, você precisa criar um ambiente virtual e " +"instalar as dependências. Você pode fazer isso executando os seguintes " +"comandos no seu terminal:" #: ../../CONTRIBUTING.md:136 msgid "**On Windows**:" -msgstr "" +msgstr "**No Windows**:" #: ../../CONTRIBUTING.md:142 msgid "**On MacOS and Linux**:" -msgstr "" +msgstr "**No MacOS e Linux**:" #: ../../CONTRIBUTING.md:148 msgid "Install the development dependencies" -msgstr "" +msgstr "Instale as dependências de desenvolvimento" #: ../../CONTRIBUTING.md:150 msgid "" "To install the development dependencies, run the following command in " "your terminal:" msgstr "" +"Para instalar as dependências de desenvolvimento, execute o seguinte comando no " +"seu terminal:" #: ../../CONTRIBUTING.md:156 msgid "Commit your changes" -msgstr "" +msgstr "Faça commit das suas alterações" #: ../../CONTRIBUTING.md:158 msgid "" "After making your changes, you need to commit them to your local " "repository. To do this, run the following commands in your terminal:" msgstr "" +"Depois de fazer suas alterações, você precisa fazer commit delas no seu " +"repositório local. Para fazer isso, execute os seguintes comandos no seu terminal:" #: ../../CONTRIBUTING.md:160 msgid "To see the changes you made:" -msgstr "" +msgstr "Para ver as alterações que você fez:" #: ../../CONTRIBUTING.md:164 msgid "To add the changes to the staging area:" -msgstr "" +msgstr "Para adicionar as alterações à staging area:" #: ../../CONTRIBUTING.md:168 msgid "To commit the changes:" -msgstr "" +msgstr "Para fazer commit das alterações:" #: ../../CONTRIBUTING.md:172 msgid "" "Replace `\"Your commit message here\"` with a clear and concise message " "that describes the changes you made." msgstr "" +"Substitua `\"Your commit message here\"` por uma mensagem clara e concisa " +"que descreva as alterações que você fez." #: ../../CONTRIBUTING.md:174 msgid "How to build the guide locally" -msgstr "" +msgstr "Como construir o guia localmente" #: ../../CONTRIBUTING.md:176 msgid "" @@ -349,12 +432,17 @@ msgid "" "the default `nox` session, which builds the guide and opens it in your " "browser." msgstr "" +"Para construir o guia localmente, você pode usar o comando `nox`. Isso vai executar " +"a sessão padrão do `nox`, que constrói o guia e abre ele no seu " +"navegador." #: ../../CONTRIBUTING.md:178 msgid "" "To see the different sessions available, you can run the following " "command in your terminal:" msgstr "" +"Para ver as diferentes sessões disponíveis, você pode executar o seguinte " +"comando no seu terminal:" #: ../../CONTRIBUTING.md:183 msgid "" @@ -362,58 +450,73 @@ msgid "" " `docs-test`, `docs-live`. You can run them by specifying the session " "name after the `nox` command." msgstr "" +"Existem diferentes sessões no nox relacionadas à construção dos docs: `docs`," +" `docs-test`, `docs-live`. Você pode executá-las especificando o nome da " +"sessão depois do comando `nox`." #: ../../CONTRIBUTING.md:185 msgid "`docs`: this session builds the guide and opens it in your browser." -msgstr "" +msgstr "`docs`: essa sessão constrói o guia e abre ele no seu navegador." #: ../../CONTRIBUTING.md:189 msgid "" "To see the guide built locally, open the file `_build/html/index.html` in" " your browser." msgstr "" +"Para ver o guia construído localmente, abra o arquivo `_build/html/index.html` no" +" seu navegador." #: ../../CONTRIBUTING.md:191 msgid "`docs-linkcheck`: this session checks that links in documentation work" -msgstr "" +msgstr "`docs-linkcheck`: essa sessão verifica se os links na documentação funcionam" #: ../../CONTRIBUTING.md:195 msgid "" "If the tests fail, you will see logs in the terminal and in " "`_build/linkcheck_output/output.txt`." msgstr "" +"Se os testes falharem, você vai ver logs no terminal e em " +"`_build/linkcheck_output/output.txt`." #: ../../CONTRIBUTING.md:197 msgid "`docs-test`: this session runs the tests for the guide." -msgstr "" +msgstr "`docs-test`: essa sessão executa os testes do guia." #: ../../CONTRIBUTING.md:201 msgid "" "If the tests fail, you will see an error message in your terminal. You " "need to fix the errors before submitting your pull request." msgstr "" +"Se os testes falharem, você vai ver uma mensagem de erro no seu terminal. Você " +"precisa corrigir os erros antes de enviar o seu pull request." #: ../../CONTRIBUTING.md:203 msgid "" "`docs-live`: this session builds the guide and opens it in your browser " "with live reloading." msgstr "" +"`docs-live`: essa sessão constrói o guia e abre ele no seu navegador " +"com live reloading." #: ../../CONTRIBUTING.md:207 msgid "" "open the local version of the guide in your browser at ``localhost`` " "shown in the terminal." msgstr "" +"abra a versão local do guia no seu navegador em ``localhost`` " +"mostrado no terminal." #: ../../CONTRIBUTING.md:209 msgid "Before you submit your pull request" -msgstr "" +msgstr "Antes de enviar o seu pull request" #: ../../CONTRIBUTING.md:211 msgid "" "Before submitting your pull request, make sure to run the tests and check" " the formatting of your code." msgstr "" +"Antes de enviar o seu pull request, certifique-se de executar os testes e verificar" +" a formatação do seu código." #: ../../CONTRIBUTING.md:216 msgid "" @@ -422,54 +525,66 @@ msgid "" "sure to check the formatting of your documentation by building the docs " "locally and checking that your changes look correct." msgstr "" +"Se os testes falharem, você vai ver uma mensagem de erro no seu terminal. Você " +"precisa corrigir os erros antes de enviar o seu pull request. Certifique-se também " +"de verificar a formatação da sua documentação construindo os docs " +"localmente e conferindo se as suas alterações estão corretas." #: ../../CONTRIBUTING.md:220 msgid "Submitting a pull request with your contribution" -msgstr "" +msgstr "Enviando um pull request com a sua contribuição" #: ../../CONTRIBUTING.md:222 msgid "How to make a pull request" -msgstr "" +msgstr "Como fazer um pull request" #: ../../CONTRIBUTING.md:224 msgid "" "To open a pull request on GitHub, navigate to the main page of your " "forked repository and click on the \"Pull requests\" tab." msgstr "" +"Para abrir um pull request no GitHub, navegue até a página principal do seu " +"repositório com fork e clique na aba \"Pull requests\"." #: ../../CONTRIBUTING.md:226 msgid "Pull requests tab in GitHub" -msgstr "" +msgstr "Aba de pull requests no GitHub" #: ../../CONTRIBUTING.md:232 msgid "" "An image showing how to navigate to the pull requests tab in GitHub. The " "pull requests tab is highlighted with a red rectangle." msgstr "" +"Uma imagem mostrando como navegar até a aba de pull requests no GitHub. A " +"aba de pull requests está destacada com um retângulo vermelho." #: ../../CONTRIBUTING.md:235 msgid "Click on the \"New pull request\" button." -msgstr "" +msgstr "Clique no botão \"New pull request\"." #: ../../CONTRIBUTING.md:237 msgid "New pull request button in GitHub" -msgstr "" +msgstr "Botão de novo pull request no GitHub" #: ../../CONTRIBUTING.md:243 msgid "" "An image showing how to create a new pull request in GitHub. The new pull" " request button is highlighted with a red rectangle." msgstr "" +"Uma imagem mostrando como criar um novo pull request no GitHub. O botão de novo" +" pull request está destacado com um retângulo vermelho." #: ../../CONTRIBUTING.md:246 msgid "" "Write a clear and concise title and description for your pull request. " "Make sure to describe the changes you made and why they are necessary." msgstr "" +"Escreva um título e uma descrição claros e concisos para o seu pull request. " +"Certifique-se de descrever as alterações que você fez e por que elas são necessárias." #: ../../CONTRIBUTING.md:248 msgid "What happens when you submit a pull request (CI/CD)" -msgstr "" +msgstr "O que acontece quando você envia um pull request (CI/CD)" #: ../../CONTRIBUTING.md:250 msgid "" @@ -477,22 +592,29 @@ msgid "" "that your changes do not introduce any bugs or errors. These checks " "include:" msgstr "" +"Assim que você envia um pull request, uma série de verificações vai ser executada para garantir " +"que as suas alterações não introduzam nenhum bug ou erro. Essas verificações " +"incluem:" #: ../../CONTRIBUTING.md:252 msgid "" "**Code formatting and styles**: checks that your code is formatted " "correctly, by `pre-commit.ci - pr check`." msgstr "" +"**Formatação e estilo do código**: verifica se o seu código está formatado " +"corretamente, por meio do `pre-commit.ci - pr check`." #: ../../CONTRIBUTING.md:253 msgid "" "**docs build**: checks that the documentation builds correctly, using " "`circleci`." msgstr "" +"**docs build**: verifica se a documentação é construída corretamente, usando " +"`circleci`." #: ../../CONTRIBUTING.md:255 msgid "You will see the status of these checks in your pull request." -msgstr "" +msgstr "Você vai ver o status dessas verificações no seu pull request." #: ../../CONTRIBUTING.md:257 msgid "Pull request checks in GitHub" @@ -504,16 +626,21 @@ msgid "" "The checks are displayed in a table with a status icon next to each " "check. The checks are highlighted with a red rectangle." msgstr "" +"Uma imagem mostrando o status das verificações em um pull request no GitHub. " +"As verificações são exibidas em uma tabela com um ícone de status ao lado de cada " +"verificação. As verificações estão destacadas com um retângulo vermelho." #: ../../CONTRIBUTING.md:265 msgid "" "If any of these checks fail, you will see an error message in your pull " "request. You need to fix the errors before your changes can be merged." msgstr "" +"Se alguma dessas verificações falhar, você vai ver uma mensagem de erro no seu pull " +"request. Você precisa corrigir os erros antes que as suas alterações possam ser mescladas." #: ../../CONTRIBUTING.md:267 msgid "Pull request checks failed in GitHub" -msgstr "" +msgstr "Verificações de pull request com falha no GitHub" #: ../../CONTRIBUTING.md:273 msgid "" @@ -522,40 +649,54 @@ msgid "" "check. The checks that failed and the details link are highlighted with a" " red rectangle." msgstr "" +"Uma imagem mostrando o status das verificações em um pull request no GitHub. " +"As verificações são exibidas em uma tabela com um ícone de status ao lado de cada " +"verificação. As verificações que falharam e o link de detalhes estão destacados com" +" um retângulo vermelho." #: ../../CONTRIBUTING.md:276 msgid "" "To get more information about the errors, you can click on the " "\"Details\" link next to the failed check." msgstr "" +"Para obter mais informações sobre os erros, você pode clicar no " +"link \"Details\" ao lado da verificação que falhou." #: ../../CONTRIBUTING.md:278 msgid "What to expect from the review process" -msgstr "" +msgstr "O que esperar do processo de revisão" #: ../../CONTRIBUTING.md:280 msgid "" "Once you submit a pull request, a maintainer of the repository will " "review your changes and provide feedback. The review process may involve:" msgstr "" +"Assim que você envia um pull request, um mantenedor do repositório vai " +"revisar as suas alterações e dar um feedback. O processo de revisão pode envolver:" #: ../../CONTRIBUTING.md:282 msgid "" "**Comments**: the reviewer may leave comments on your pull request to ask" " questions or provide feedback." msgstr "" +"**Comentários**: quem está revisando pode deixar comentários no seu pull request para fazer" +" perguntas ou dar feedback." #: ../../CONTRIBUTING.md:283 msgid "" "**Suggestions**: the reviewer may suggest changes to your code or " "documentation." msgstr "" +"**Sugestões**: quem está revisando pode sugerir alterações no seu código ou " +"na sua documentação." #: ../../CONTRIBUTING.md:284 msgid "" "**Approvals**: once the reviewer is satisfied with your changes, they " "will approve the pull request." msgstr "" +"**Aprovações**: assim que quem está revisando estiver satisfeito com as suas alterações, ele " +"vai aprovar o pull request." #: ../../CONTRIBUTING.md:286 msgid "" @@ -563,20 +704,25 @@ msgid "" "branch. The pull request will be updated automatically with your new " "changes." msgstr "" +"Você pode fazer alterações no seu pull request enviando novos commits para a " +"branch. O pull request vai ser atualizado automaticamente com as suas novas " +"alterações." #: ../../CONTRIBUTING.md:288 msgid "" "Once your pull request is approved, it will be merged into the main " "branch and your changes will be included in the guide." msgstr "" +"Assim que o seu pull request for aprovado, ele vai ser mesclado na branch " +"principal e as suas alterações vão ser incluídas no guia." #: ../../CONTRIBUTING.md:290 msgid "Additional help" -msgstr "" +msgstr "Ajuda adicional" #: ../../CONTRIBUTING.md:292 msgid "How to get help" -msgstr "" +msgstr "Como conseguir ajuda" #: ../../CONTRIBUTING.md:294 msgid "" @@ -584,24 +730,29 @@ msgid "" " in case beginner contributors need more help (e.g., create an issue, " "post in a forum, etc).*" msgstr "" +"*__TODO__: Essa seção deve descrever as opções para encontrar mais ajuda" +" caso contribuidores iniciantes precisem de mais suporte (por exemplo, criar uma issue, " +"postar em um fórum, etc).*" #: ../../CONTRIBUTING.md:296 msgid "Additional resources" -msgstr "" +msgstr "Recursos adicionais" #: ../../CONTRIBUTING.md:298 msgid "" "*__TODO__: It should also include links to beginner documentation, like " "the GitHub docs.*" msgstr "" +"*__TODO__: Também deve incluir links para documentação para iniciantes, como " +"os docs do GitHub.*" #: ../../CONTRIBUTING.md:300 msgid "Annex" -msgstr "" +msgstr "Anexo" #: ../../CONTRIBUTING.md:302 msgid "Code examples" -msgstr "" +msgstr "Exemplos de código" #: ../../CONTRIBUTING.md:304 msgid "" @@ -610,10 +761,14 @@ msgid "" "literalinclude) whenever possible to keep code and prose separate. Code " "for use in the documentation is kept in the `examples/` folder." msgstr "" +"Este guia usa a [diretiva literalinclude do Sphinx](https://www.sphinx-" +"doc.org/en/master/usage/restructuredtext/directives.html#directive-" +"literalinclude) sempre que possível para manter o código e o texto separados. O código " +"usado na documentação fica na pasta `examples/`." #: ../../CONTRIBUTING.md:308 msgid "Referencing code in documentation" -msgstr "" +msgstr "Referenciando código na documentação" #: ../../CONTRIBUTING.md:310 msgid "" @@ -621,6 +776,9 @@ msgid "" "use, you can copy the `literalinclude` directive verbatim and the " "examples will stay in sync." msgstr "" +"Se já existe um exemplo em outro lugar da documentação que você queira " +"usar, você pode copiar a diretiva `literalinclude` exatamente como está e os " +"exemplos vão se manter sincronizados." #: ../../CONTRIBUTING.md:313 msgid "" @@ -631,6 +789,12 @@ msgid "" "`:language:` and `:lines:`. The former makes code examples prettier, and " "the later can protect your example from future modifications to the code." msgstr "" +"Se você já vê código na pasta examples que pode usar para uma nova " +"documentação, um novo `literalinclude` pode ser criado para extraí-lo para o " +"site. Basta um caminho relativo para o código para um `literalinclude` " +"funcionar, mas você deveria, em quase todos os casos, também fornecer um " +"`:language:` e `:lines:`. O primeiro deixa os exemplos de código mais bonitos, e " +"o segundo pode proteger o seu exemplo de futuras modificações no código." #: ../../CONTRIBUTING.md:318 msgid "" @@ -639,16 +803,22 @@ msgid "" " example code is Python, `:pyobject:` can be an even more future-proof " "way to keep the same documentation content even through code refactors." msgstr "" +"**Dica**: como alternativa a `:lines:`, existem também as opções `:start-" +"after:`, `:start-at:`, `:end-before:` e `:end-at:`. E se o " +"código de exemplo for Python, `:pyobject:` pode ser uma forma ainda mais durável " +"de manter o mesmo conteúdo de documentação mesmo depois de refatorações no código." #: ../../CONTRIBUTING.md:322 msgid "" "If you need example code that doesn't yet exist in `examples/` see " "[creating code for documentation](#creating-code-for-documentation)." msgstr "" +"Se você precisar de um código de exemplo que ainda não existe em `examples/`, veja " +"[criando código para documentação](#creating-code-for-documentation)." #: ../../CONTRIBUTING.md:325 msgid "Creating code for documentation" -msgstr "" +msgstr "Criando código para documentação" #: ../../CONTRIBUTING.md:327 msgid "" @@ -658,6 +828,11 @@ msgid "" "already exist; [see referencing code in documentation ](#referencing-" "code-in-documentation)." msgstr "" +"Sempre que você encontrar um lugar que poderia se beneficiar de um bloco de código, " +"em vez de escrevê-lo em linha com um code fence (bloco de texto `` ``` ``) " +"você pode escrevê-lo como um arquivo no seu próprio formato. Seu exemplo pode até " +"já existir; [veja referenciando código na documentação](#referencing-" +"code-in-documentation)." #: ../../CONTRIBUTING.md:331 msgid "" @@ -667,6 +842,11 @@ msgid "" "one of the existing example projects please add it there; otherwise " "create a new folder in the `examples` directory." msgstr "" +"Se você quiser adicionar um novo exemplo que não se encaixa em nenhum dos " +"arquivos de exemplo existentes, você pode criar um novo arquivo e referenciá-lo em um " +"bloco `literalinclude`. Se fizer sentido esse arquivo ficar dentro de " +"um dos projetos de exemplo existentes, por favor adicione ele lá; caso contrário, " +"crie uma nova pasta no diretório `examples`." #: ../../CONTRIBUTING.md:335 msgid "" @@ -676,6 +856,11 @@ msgid "" " that rewrite it. So for instance, add new functions to the end of the " "file, new methods after all existing ones in a class." msgstr "" +"Se um exemplo existente estiver incompleto ou fizer sentido adicionar um novo exemplo " +"a um arquivo já existente, vá em frente e adicione, mas tome cuidado para não " +"quebrar o resto do guia. Sempre que possível, estenda o exemplo em vez" +" de reescrevê-lo. Por exemplo, adicione novas funções no final do " +"arquivo, novos métodos depois de todos os já existentes em uma classe." #: ../../CONTRIBUTING.md:339 msgid "" @@ -683,6 +868,9 @@ msgid "" "require adding additional tests for coverage, and will require fixing any" " failing tests." msgstr "" +"O código de exemplo é verificado quanto à correção, então adicionar um novo exemplo pode " +"exigir a adição de testes extras para cobertura, e vai exigir a correção de qualquer" +" teste que falhar." #: ../../CONTRIBUTING.md:342 msgid "" @@ -694,18 +882,25 @@ msgid "" " you find yourself modifying existing examples try running this command " "and then checking those pages in a new build." msgstr "" +"***⚠️ AVISO***: um cuidado especial deve ser tomado ao modificar código de " +"exemplo já existente, principalmente qualquer modificação além de adicionar ao final " +"do arquivo. Todos os exemplos de código são (potencialmente) exemplos compartilhados. Isso torna" +" os exemplos no guia mais consistentes, mas pode gerar efeitos " +"à distância ao modificar os exemplos para um caso de uso específico. Se" +" você se pegar modificando exemplos existentes, tente executar este comando " +"e depois conferir essas páginas em um novo build." #: ../../CONTRIBUTING.md:350 msgid "Example:" -msgstr "" +msgstr "Exemplo" #: ../../CONTRIBUTING.md:352 msgid "Instead of writing example code in markdown like this" -msgstr "" +msgstr "Em vez de escrever o código de exemplo em markdown assim" #: ../../CONTRIBUTING.md:363 msgid "The python can be extracted into a `.py` file" -msgstr "" +msgstr "O python pode ser extraído para um arquivo `.py`" #: ../../CONTRIBUTING.md:377 msgid "" @@ -713,11 +908,14 @@ msgid "" "we already have complete project definitions, you need only to find the " "relevant part." msgstr "" +"Como outro exemplo, se você só precisa mostrar parte de um `pyproject.toml`, " +"já temos definições completas de projeto, você só precisa encontrar a " +"parte relevante." #: ../../CONTRIBUTING.md:380 msgid "Instead of writing this" -msgstr "" +msgstr "Em vez de escrever isso" #: ../../CONTRIBUTING.md:391 msgid "an example could be extracted from an existing toml file" -msgstr "" +msgstr "um exemplo poderia ser extraído de um arquivo toml já existente"