From 3fcf1e3cd9214e86a5aa7c11b4fd66b49d2c809f Mon Sep 17 00:00:00 2001 From: Nuninha-GC Date: Tue, 20 Dec 2022 00:42:29 +0200 Subject: [PATCH] Translations to PT (#28435) * Translated CONTRIBUTING.md arquive to PT * Translated NOTICE.md arquive to PT * Translated README.md arquive to PT --- CONTRIBUTING_pt.md | 36 +++++ NOTICE_pt.txt | 46 +++++++ README_pt.md | 334 +++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 416 insertions(+) create mode 100644 CONTRIBUTING_pt.md create mode 100644 NOTICE_pt.txt create mode 100644 README_pt.md diff --git a/CONTRIBUTING_pt.md b/CONTRIBUTING_pt.md new file mode 100644 index 0000000000..63c4c885fb --- /dev/null +++ b/CONTRIBUTING_pt.md @@ -0,0 +1,36 @@ +# Diretrizes de Contribuição + +Vcpkg é um esforço da comunidade para construir um ecossistema produtivo e robusto de bibliotecas nativas - suas contribuições são inestimáveis! + +## Problemas (issues) + +A maneira mais fácil de contribuir é relatando problemas com `vcpkg.exe` ou um pacote existente no [GitHub](https://github.com/Microsoft/vcpkg). Ao relatar um problema com `vcpkg.exe`, certifique-se de indicar claramente: + +- A configuração da máquina: "Estou usando a Atualização de Aniversário do Windows 10. Minha máquina está usando a localidade fr-fr. Executei com sucesso o 'instal boost'." +- As etapas para reproduzir: "I run 'vcpkg list'" +- O resultado esperado: "Eu esperava ver 'boost:x86-windows'" +- O resultado real: "Não recebo nenhuma saída" ou "Recebo uma caixa de diálogo de travamento" + +Ao relatar um problema com um pacote, certifique-se de indicar claramente: + +- A configuração da máquina (como acima) +- Qual pacote e versão você está construindo: "opencv 3.1.0" +- Quaisquer logs de erro relevantes do processo de compilação. + +## Pull Requests + +Estamos felizes em aceitar solicitações de correções, recursos, novos pacotes e atualizações para pacotes existentes. Para evitar desperdício de tempo, recomendamos abrir um tópico para discutir se o PR que você está pensando em fazer será aceitável. Isso é duplamente verdadeiro para recursos e novos pacotes. + +### Diretrizes de novos pacotes + +Estamos felizes por você estar interessado em enviar um novo pacote! Aqui estão algumas diretrizes para ajudá-lo a criar um excelente portfile: + +- Evite patches funcionais. Os patches devem ser considerados um último recurso para implementar a compatibilidade quando não houver outra maneira. +- Quando os patches não puderem ser evitados, não modifique o comportamento padrão. O ciclo de vida ideal de um patch é ser mesclado no upstream e não ser mais necessário. Tente manter esse objetivo em mente ao decidir como corrigir algo. +- Prefira usar as funções `vcpkg_xyz` em vez de chamadas brutas `execute_command`. Isso facilita a manutenção de longo prazo quando novos recursos (como sinalizadores de compilador personalizados ou geradores) são adicionados. + +## Jurídico + +Você precisará preencher um Contrato de Licença de Colaborador (CLA) antes que sua solicitação pull possa ser aceita. Este contrato atesta que você está nos concedendo permissão para usar o código-fonte que está enviando e que este trabalho está sendo enviado sob a licença apropriada para que possamos usá-lo. + +Você pode concluir o CLA seguindo as etapas em . Assim que recebermos o CLA assinado, analisaremos a solicitação. Você só precisará fazer isso uma vez. diff --git a/NOTICE_pt.txt b/NOTICE_pt.txt new file mode 100644 index 0000000000..678ca692ef --- /dev/null +++ b/NOTICE_pt.txt @@ -0,0 +1,46 @@ +vcpkg usa material de terceiros dos projetos listados abaixo. +O aviso de direitos autorais original e a licença sob a qual a Microsoft +recebido tal material de terceiros são descritos abaixo. Microsoft +reserva-se todos os outros direitos não concedidos expressamente, seja por +implicação, preclusão ou de outra forma. + +No caso de falhamos acidentalmente em listar um aviso necessário, por favor +chame nossa atenção postando um problema. + +AVISOS E INFORMAÇÕES DE SOFTWARE DE TERCEIROS +Não traduza ou localize + +vcpkg incorpora material de terceiros dos projetos listados abaixo. +O aviso de direitos autorais original e a licença sob a qual a Microsoft recebeu +tais materiais de terceiros são apresentados abaixo. A Microsoft reservou todos os outros +direitos não concedidos expressamente, seja por implicação, preclusão ou de outra forma. + +1. Catch2 + +%% Catch2 AVISOS, INFORMAÇÕES E LICENÇA COMEÇAM AQUI +=========================================== +Boost Software License - Versão 1.0 - 17 de agosto de 2003 + +A permissão é concedida, gratuitamente, a qualquer pessoa ou organização +obter uma cópia do software e da documentação que o acompanha coberta por +esta licença (o "Software") para usar, reproduzir, exibir, distribuir, +executar e transmitir o Software e preparar trabalhos derivados do +Software, e para permitir que terceiros a quem o Software é fornecido +fazê-lo, tudo sujeito ao seguinte: + +Os avisos de direitos autorais no Software e toda esta declaração, incluindo +a concessão de licença acima, esta restrição e a seguinte isenção de responsabilidade, +devem ser incluídos em todas as cópias do Software, no todo ou em parte, e +todos os trabalhos derivados do Software, a menos que tais cópias ou derivados +as obras são exclusivamente na forma de código de objeto executável por máquina gerado por +um processador de linguagem de origem. + +O SOFTWARE É FORNECIDO "COMO ESTÁ", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU +IMPLÍCITAS, INCLUINDO, SEM LIMITAÇÃO, AS GARANTIAS DE COMERCIALIZAÇÃO, +ADEQUAÇÃO A UM DETERMINADO FIM, TÍTULO E NÃO VIOLAÇÃO. EM NENHUM CASO +OS DETENTORES DOS DIREITOS AUTORAIS OU QUALQUER DISTRIBUIDOR DO SOFTWARE SERÃO RESPONSÁVEIS +POR QUAISQUER DANOS OU OUTRA RESPONSABILIDADE, SEJA EM CONTRATO, ILÍCITO OU DE OUTRA FORMA, +DECORRENTE DE OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRO +NEGÓCIOS NO SOFTWARE. +=========================================== +FIM DOS AVISOS, INFORMAÇÕES E LICENÇA DE Catch2 \ No newline at end of file diff --git a/README_pt.md b/README_pt.md new file mode 100644 index 0000000000..7baad4d458 --- /dev/null +++ b/README_pt.md @@ -0,0 +1,334 @@ +# Vcpkg: visão geral + +[中文总览](README_zh_CN.md) | +[Español](README_es.md) | +[한국어](README_ko_KR.md) | +[Français](README_fr.md) | +[English](README.md) + +Vcpkg ajuda você a gerenciar bibliotecas C e C++ no Windows, Linux e MacOS. +Esta ferramenta e ecossistema estão em constante evolução e sempre agradecemos as contribuições! + +Se você nunca usou o vcpkg antes, ou se está tentando descobrir como usar o vcpkg, +confira nossa seção [Primeiros passos](#getting-started) para saber como começar a usar o vcpkg. + +Para obter uma breve descrição dos comandos disponíveis, depois de instalar o vcpkg, +você pode executar `vcpkg help`, ou `vcpkg help [command]` para obter ajuda específica do comando. + +* GitHub: pacote completo em [https://github.com/microsoft/vcpkg](https://github.com/microsoft/vcpkg), programa em [https://github.com/microsoft/vcpkg-tool](https://github.com/microsoft/vcpkg-tool) +* Slack: [https://cppalliance.org/slack/](https://cppalliance.org/slack/), the #vcpkg channel +* Discord: [\#include \](https://www.includecpp.org), the #🌏vcpkg channel +* Documentos: [Documentation](docs/README.md) + +# Índice + +* [Vcpkg: visão geral](#vcpkg-visão-geral) +* [Índice](#Índice) +* [Primeiros passos](#primeiros-passos) + * [Início rápido: Windows](#início-rápido-windows) + * [Início rápido: Unix](#início-rápido-unix) + * [Instalando ferramentas de desenvolvedor do Linux](#Instalando-ferramentas-de-desenvolvedor-do-Linux) + * [Instalando ferramentas de desenvolvedor do macOS](#instalando-ferramentas-de-desenvolvedor-do-macos) + * [Usando vcpkg com CMake](#usando-vcpkg-com-cmake) + * [Visual Studio Code com CMake Tools](#visual-studio-code-com-ferramentas-cmake) + * [Vcpkg com Projectos Visual Studio CMake](#vcpkg-com-projectos-visual-studio-cmake) + * [Vcpkg com CLion](#vcpkg-com-clion) + * [Vcpkg como um submódulo](#vcpkg-como-um-submódulo) +* [Tab-Completion/Auto-Completion](#tab-completionauto-completion) +* [Exemplos](#exemplos) +* [Contribuindo](#contribuindo) +* [Licença](#licença) +* [Segurança](#segurança) +* [Telemetria](#telemetria) + +# Primeiros passos + +Primeiro, siga o guia de início rápido para +[Windows](#início-rápido-windows) ou [macOS e Linux](#início-rápido-unix), +dependendo do que você está usando. + +Para obter mais informações, consulte [Instalando e usando pacotes] [primeiros passos: usando um pacote]. +Se uma biblioteca que você precisa não estiver presente no catálogo vcpkg, +você pode [abrir um problema no repositório do GitHub][contributing:submit-issue] +onde a equipe e a comunidade do vcpkg possam vê-lo, +e potencialmente adicionar a porta ao vcpkg. + +Depois de ter vcpkg instalado e funcionando, +você pode querer adicionar [tab-completion](#tab-completionauto-completion) ao seu shell. + +Finalmente, se você estiver interessado no futuro do vcpkg, +confira o guia [manifesto][introdução: especificação do manifesto]! +Este é um recurso experimental e provavelmente terá bugs, +então experimente e [abra todos os problemas][contribuir: enviando-problema]! + +## Início rápido: Windows + +Pré-requisitos: +- Windows 7 ou mais recente +- [Git][primeiros passos:git] +- [Visual Studio] [primeiros passos: visual-studio] 2015 Update 3 ou superior com o pacote de idioma inglês + +Primeiro, baixe e inicialize o próprio vcpkg; pode ser instalado em qualquer lugar, +mas geralmente recomendamos usar vcpkg como um submódulo para projetos CMake, +e instalá-lo globalmente para projetos do Visual Studio. +Recomendamos algum lugar como `C:\src\vcpkg` ou `C:\dev\vcpkg`, +caso contrário, você pode ter problemas de caminho para alguns sistemas de compilação de portas. + +```cmd +> git clone https://github.com/microsoft/vcpkg +> .\vcpkg\bootstrap-vcpkg.bat +``` + +Para instalar bibliotecas para os seus projectos, execute: + +```cmd +> .\vcpkg\vcpkg install [nome do pacote por instalar] +``` + +Nota: este comando irá instalar bibliotecas x86 por padrão. Para instalar x64, execute: + +```cmd +> .\vcpkg\vcpkg install [nome do pacote por instalar]:x64-windows +``` + +Ou + +```cmd +> .\vcpkg\vcpkg install [nome do pacote por instalar] --triplet=x64-windows +``` + +Voce pode também procurar pela biblioteca que precisa com o subcomando `search`: + +```cmd +> .\vcpkg\vcpkg search [termo de procura] +``` + +Para usar o vcpkg com o Visual Studio, +execute o seguinte comando (pode exigir autorização do administrador): + +```cmd +> .\vcpkg\vcpkg integrate install +``` + +Depois disso, agora você pode criar um novo projeto sem CMake (ou abrir um já existente). +Todas as bibliotecas instaladas estarão imediatamente prontas para serem `#include`'d e usadas +em seu projeto sem configuração adicional. + +Se você estiver usando o CMake com o Visual Studio, +continue [aqui](#vcpkg-com-projectos-visual-studio-cmake). + +Para usar vcpkg com CMake fora de um IDE, +você pode usar o arquivo toolchain: + +```cmd +> cmake -B [diretorio de trabalho] -S . "-DCMAKE_TOOLCHAIN_FILE=[localizacao do vcpkg]/scripts/buildsystems/vcpkg.cmake" +> cmake --build [diretorio de trabalho] +``` + +Com o CMake, você ainda precisará de `find_package` (localizar os pacotes) e similares para usar as bibliotecas. +Confira a [secção CMake](#usando-vcpkg-com-cmake) para mais informações, +incluindo o uso do CMake com um IDE. + +Para quaisquer outras ferramentas, incluindo o Visual Studio Code, +confira o [guia de integração][primeiros passos: integração]. + +## Início rápido: Unix + +Pré-requisitos para Linux: +- [Git][primeiros passos:git] +- [g++][primeiros passos:linux-gcc] >= 6 + +Pré-requisitos para macOS: +- [Apple Developer Tools][primeiros passos: macos-dev-tools] + +Primeiro, baixe e inicialize o próprio vcpkg; pode ser instalado em qualquer lugar, +mas geralmente recomendamos o uso de vcpkg como um submódulo para projetos CMake. + +```sh +$ git clone https://github.com/microsoft/vcpkg +$ ./vcpkg/bootstrap-vcpkg.sh +``` + +Para instalar as bibliotecas do seu projecto, execute: + +```sh +$ ./vcpkg/vcpkg install [pacote por instalar] +``` + +Voce pode também procurar pela biblioteca que precisa com o subcomando `search`: + +```sh +$ ./vcpkg/vcpkg search [termo de pesquisa] +``` + +Para usar vcpkg com CMake, você pode usar o arquivo toolchain: + +```sh +$ cmake -B [diretorio de trabalho] -S . "-DCMAKE_TOOLCHAIN_FILE=[localizacao do vcpkg]/scripts/buildsystems/vcpkg.cmake" +$ cmake --build [diretorio de trabalho] +``` + +Com o CMake, você ainda precisará `find_package` e similares para usar as bibliotecas. +Confira a [seção CMake](#using-vcpkg-with-cmake) +para obter mais informações sobre a melhor forma de usar vcpkg com CMake, +e ferramentas CMake para VSCode. + +Para quaisquer outras ferramentas, confira o [guia de integração][primeiros passos:integração]. + +## Instalando ferramentas de desenvolvedor do Linux + +Nas diferentes distros do Linux, existem diferentes pacotes que você +precisa instalar: + +- Debian, Ubuntu, popOS e outras distribuições baseadas em Debian: + +```sh +$ sudo apt-get update +$ sudo apt-get install build-essential tar curl zip unzip +``` + +- CentOS + +```sh +$ sudo yum install centos-release-scl +$ sudo yum install devtoolset-7 +$ scl enable devtoolset-7 bash +``` + +Para quaisquer outras distribuições, certifique-se de instalar o g++ 6 ou superior. +Se você deseja adicionar instruções para sua distro específica, [abra um PR][contribuindo:enviar-pr]! + +## Instalação das ferramentas de desenvolvedor do macOS + +No macOS, a única coisa que você precisa fazer é executar o seguinte no seu terminal: + +```sh +$ xcode-select --install +``` + +Em seguida, siga as instruções nas janelas que aparecerem. + +Você poderá inicializar o vcpkg junto com o [guia de início rápido](#quick-start-unix) + +## Usando vcpkg com CMake + +### Visual Studio Code com ferramentas CMake + +Adicionar o seguinte ao seu espaço de trabalho `settings.json` fará CMake Tools usar automaticamente `vcpkg` para bibliotecas: + +```json +{ + "cmake.configureSettings": { + "CMAKE_TOOLCHAIN_FILE": "[vcpkg root]/scripts/buildsystems/vcpkg.cmake" + } +} +``` + +### Vcpkg com Projetos CMake do Visual Studio + +Abra o CMake Settings Editor e, em `CMake toolchain file`, adicione o caminho ao arquivo de cadeia de ferramentas vcpkg: + +``` +[vcpkg root]/scripts/buildsystems/vcpkg.cmake +``` + +### Vcpkg com CLion + +Abra as configurações das cadeias de ferramentas +(Arquivo > Configurações no Windows e Linux, CLion > Preferências no macOS), e vá para as configurações do CMake (Build, Execution, Deployment > CMake). Finalmente, em `CMake options`, adicione a seguinte linha: + +``` +-DCMAKE_TOOLCHAIN_FILE=[vcpkg root]/scripts/buildsystems/vcpkg.cmake +``` + +Você deve adicionar esta linha a cada perfil. + +### Vcpkg como um submódulo + +Ao usar o vcpkg como um submódulo do seu projeto, +você pode adicionar o seguinte ao seu CMakeLists.txt antes da primeira chamada `project()`, em vez de passar `CMAKE_TOOLCHAIN_FILE` para a invocação do cmake. + +```cmake +set(CMAKE_TOOLCHAIN_FILE "${CMAKE_CURRENT_SOURCE_DIR}/vcpkg/scripts/buildsystems/vcpkg.cmake" + CACHE STRING "Vcpkg toolchain file") +``` + +Isso ainda permitirá que as pessoas não usem o vcpkg, passando o `CMAKE_TOOLCHAIN_FILE` diretamente, mas tornará a etapa de configuração-construção um pouco mais fácil. + +[getting-started:using-a-package]: docs/examples/installing-and-using-packages.md +[getting-started:integration]: docs/users/buildsystems/integration.md +[getting-started:git]: https://git-scm.com/downloads +[getting-started:cmake-tools]: https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools +[getting-started:linux-gcc]: #installing-linux-developer-tools +[getting-started:macos-dev-tools]: #installing-macos-developer-tools +[getting-started:macos-brew]: #installing-gcc-on-macos +[getting-started:macos-gcc]: #installing-gcc-on-macos +[getting-started:visual-studio]: https://visualstudio.microsoft.com/ +[getting-started:manifest-spec]: docs/specifications/manifests.md + +# Tab-Completion/Auto-Completion + +`vcpkg` suporta preenchimento automático de comandos, nomes de pacotes, e opções em powershell e bash. Para habilitar o preenchimento de tabulação no shell de sua escolha, execute: + +```pwsh +> .\vcpkg integrate powershell +``` + +Ou: + +```sh +$ ./vcpkg integrate bash # or zsh +``` + +dependendo do shell que você usa, reinicie o console. + +# Exemplos + +Consulte a [documentação](docs/README.md) para orientações específicas, +incluindo [instalando e usando um pacote](docs/examples/installing-and-using-packages.md), +[adicionando um novo pacote de um arquivo zip](docs/examples/packaging-zipfiles.md), +e [adicionando um novo pacote de um repositório GitHub](docs/examples/packaging-github-repos.md). + +Nossos documentos agora também estão disponíveis online em nosso site . Nós realmente apreciamos todo e qualquer feedback! Você pode enviar um problema em . + +Veja um [vídeo de demonstração](https://www.youtube.com/watch?v=y41WFKbQFTw) de 4 minutos. + +# Contribuindo + +Vcpkg é um projeto de código aberto e, portanto, é construído com suas contribuições. +Aqui estão algumas maneiras pelas quais você pode contribuir: + +* [Enviar problemas][contributing:submit-issue] em vcpkg ou pacotes existentes +* [Enviar correções e novos pacotes][contributing:submit-pr] + +Consulte nosso [Guia de contribuição](CONTRIBUTING.md) para obter mais detalhes. + +Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft][contributing:coc]. +Para obter mais informações, consulte as [Perguntas frequentes sobre o Código de Conduta][contributing:coc-faq] +ou e-mail [opencode@microsoft.com](mailto:opencode@microsoft.com) +com quaisquer perguntas ou comentários adicionais. + +[contribuindo:submit-issue]: https://github.com/microsoft/vcpkg/issues/new/choose +[contribuindo:submit-pr]: https://github.com/microsoft/vcpkg/pulls +[contribuindo:coc]: https://opensource.microsoft.com/codeofconduct/ +[contribuindo:coc-faq]: https://opensource.microsoft.com/codeofconduct/ + +# Segurança + +A maioria das portas no vcpkg compila as bibliotecas em questão usando o sistema de compilação original preferido +pelos desenvolvedores originais dessas bibliotecas e baixar o código-fonte e criar ferramentas de seus +locais de distribuição oficiais. Para uso atrás de um firewall, o acesso específico necessário dependerá +em quais portas estão sendo instaladas. Se você precisar instalar em um ambiente "air gap", considere +instalando uma vez em um ambiente sem "air gap", preenchendo um +[cache de ativos](docs/users/assetcaching.md) compartilhado com o ambiente "air gapped". + +# Telemetria + +vcpkg coleta dados de uso para nos ajudar a melhorar sua experiência. +Os dados coletados pela Microsoft são anônimos. +Você pode cancelar a telemetria por +- executando o script bootstrap-vcpkg com -disableMetrics +- passando --disable-metrics para vcpkg na linha de comando +- definir a variável de ambiente VCPKG_DISABLE_METRICS + +Leia mais sobre a telemetria vcpkg em . \ No newline at end of file