diff options
author | Paulo Henrique de Lima Santana (phls) <phls@debian.org> | 2022-06-26 11:55:53 -0300 |
---|---|---|
committer | Paulo Henrique de Lima Santana (phls) <phls@debian.org> | 2022-06-26 11:55:53 -0300 |
commit | b65635f25c7094ee43dacc150bb76d96866d2a42 (patch) | |
tree | d7bdc1c17c2721c050fe023f4cff501b76d4fdc3 /portuguese/doc | |
parent | ebeb30addc403063c0bcd8faae64faaf15bd2076 (diff) |
Update portguese translation (thanks to Paulo Santana and Thiago Pezzo)
Diffstat (limited to 'portuguese/doc')
-rw-r--r-- | portuguese/doc/vcs.wml | 151 |
1 files changed, 83 insertions, 68 deletions
diff --git a/portuguese/doc/vcs.wml b/portuguese/doc/vcs.wml index d7a373f01d4..5feabdc0469 100644 --- a/portuguese/doc/vcs.wml +++ b/portuguese/doc/vcs.wml @@ -1,23 +1,24 @@ -#use wml::debian::ddp title="SCV do projeto de documentação do Debian" +#use wml::debian::ddp title="SCV (Sistema de Controle de Versão) do projeto de documentação do Debian" #use wml::debian::toc -#use wml::debian::translation-check translation="bf1a0486dfbf35e11a7ff98a29d9e2e4f2eda3f3" +#use wml::debian::translation-check translation="e6e987deba52309df5b062b1567c8f952d7bd476" -<p> -O projeto de documentação do Debian armazena suas páginas web e grande parte dos -textos dos manuais no serviço salsa do Debian em <strong>salsa.debian.org</strong>, -que é a instância GitLab do Debian. -Por favor leia a <a href="https://wiki.debian.org/Salsa">documentação do salsa</a> -para obter mais informações sobre como este serviço funciona. -</p> +<link href="$(HOME)/font-awesome.css" rel="stylesheet" type="text/css"> -<p> -Todas as pessoas podem baixar os fontes a partir do serviço salsa. Somente -membros(as) do projeto de documentação do Debian podem atualizar os arquivos. -</p> +<ul class="toc"> + <li><a href="#access">Acessando os arquivos-fonte no git</a></li> + <li><a href="#obtaining">Obtendo privilégios de envio</a></li> + <li><a href="#updates">Mecanismo de atualização automática</a></li> +</ul> -<toc-display /> +<aside> +<p><span class="fas fa-caret-right fa-3x"></span> O <a href="ddp">projeto de +documentação Debian</a> armazena suas páginas web e a maioria dos manuais no +<a href ="https://salsa.debian.org">salsa</a>, instância do GitLab do Debian. +Todas as pessoas podem baixar os arquivos-fonte do serviço salsa, mas apenas +os(as) membros(as) do DDP têm acesso de escrita e podem atualizar os arquivos.</p> +</aside> -<toc-add-entry name="access">Acessando os fontes no git</toc-add-entry> +<h2><a id="access">Acessando os arquivos-fonte no git</a></h2> <p> Você pode usar uma interface web para acessar os arquivos individualmente e ver @@ -26,96 +27,110 @@ as alterações de cada projeto em </p> <p> -Para baixar um manual inteiro, geralmente a melhor opção é o -acesso direto ao servidor git. Você precisa ter o pacote -<tt><a href="https://packages.debian.org/git">git</a></tt> na sua própria -máquina. +O projeto de documentação Debian armazena todo o conteúdo no salsa, a instância +GitLab do Debian. Para acessar arquivos individuais, verificar mudanças recentes +e atividades do projeto em geral, por favor visite o +<a href="https://salsa.debian.org/ddp-team/">repositório do DDP</a>. </p> -<h3>Clonando um repositório git anonimamente (modo apenas leitura)</h3> - -<p>Use este comando para baixar todos os arquivos de um projeto:</p> - -<p style="margin-left: 2em"> - <code>git clone https://salsa.debian.org/ddp-team/release-notes.git</code> +<p> +Se deseja baixar manuais inteiros de lá, o acesso direto ao salsa provavelmente +é a melhor opção. As próximas seções explicam como clonar um repositório git +(modo somente leitura e modo leitura-gravação) em sua máquina local e como +atualizar sua cópia local. Antes de começar, instale o pacote +<tt><a href="https://packages.debian.org/git">git</a></tt> na sua máquina. </p> -<p> -Faça o mesmo para todos os projetos que você deseja clonar localmente. +<p style="text-align:center"><button type="button"> +<span class="fas fa-book-open fa-2x"></span> +<a href="https://wiki.debian.org/Salsa">Leia os documentos do salsa</a></button> </p> -<h3>Clonando um repositório git com privilégios de envio (modo leitura e escrita)</h3> +<h3>Clonando um repositório git anonimamente (modo apenas leitura)</h3> <p> -Antes de acessar o servidor git usando esse método, você deve primeiro obter -acesso de escrita. Por favor, leia primeiro como -<a href="#obtaining">solicitar</a> permissão de envio (push). +Use este comando para baixar todos os arquivos de um projeto: </p> -<p>Use este comando para baixar todos os arquivos de um projeto:</p> - -<p style="margin-left: 2em"> - <code>git clone git@salsa.debian.org:ddp-team/release-notes.git</code> -</p> +<pre> + <code>git clone https://salsa.debian.org/ddp-team/release-notes.git +</pre> <p> -Faça o mesmo para todos os projetos que você deseja clonar localmente. +Faça o mesmo para cada projeto que deseja baixar para o seu computador. +<strong>Dica:</strong> para encontrar a URL correta para o comando +<code>git clone</code>, abra o projeto em um navegador web, clique no botão azul +<em>Clone</em> e copie a URL <em>Clone with HTTPS</em> (Clonar com HTTPS) para +sua área de transferência. </p> -<h3>Buscando alterações do repositório git remoto</h3> +<h3>Clonando um repositório git com privilégios de envio (modo leitura e escrita)</h3> <p> -Para atualizar sua cópia local com quaisquer alterações feitas por outras -pessoas, entre no diretório <strong>manuals</strong> e execute o comando: +Antes de poder acessar o servidor git usando esse método, você deve primeiro +obter acesso de escrita no repositório. Por favor consulte +<a href="#obtaining">esta seção</a> para obter mais informações sobre como +solicitar permissão de escrita. </p> -<p style="margin-left: 2em"> - <code>git pull</code> +<p> +Com acesso de gravação ao salsa, você pode usar o seguinte comando para +baixar todos os arquivos de um projeto: </p> -<toc-add-entry name="obtaining">Obtendo privilégios de envio</toc-add-entry> +<pre> +git clone git@salsa.debian.org:ddp-team/release-notes.git +</pre> <p> -Os privilégios de envio (push) estão disponíveis para quem deseja participar -da redação dos manuais. Geralmente solicitamos que você tenha enviado alguns -patches úteis antes. +Faça o mesmo para todos os projetos que você deseja clonar localmente. </p> -<p> -Depois de criar sua conta no <a href="https://salsa.debian.org/">salsa</a>, -por favor solicite os privilégios de envio clicando em <q>Request to join</q> -no grupo ou em qualquer um dos os projetos específicos em -<url "https://salsa.debian.org/ddp-team/" />. -Por favor após fazer isso envie um e-mail para debian-doc@lists.debian.org -mostrando o histórico gravado do seu trabalho no Debian. -</p> +<h3>Buscando alterações do repositório git remoto</h3> <p> -Depois que sua solicitação for aprovada, você fará parte do grupo -<a href="https://salsa.debian.org/ddp-team/"><q>ddp-team</q></a> ou de um dos -seus projetos. -</p> +Para atualizar sua cópia local com quaisquer alterações feitas por outras +pessoas, entre no subdiretório do respectivo manual e execute este comando: -<hr /> +<pre> +git pull +</pre> -<toc-add-entry name="updates">Mecanismo de atualização automática</toc-add-entry> +<toc-add-entry name="obtaining">Obtendo privilégios de envio</toc-add-entry> <p> -As páginas web publicadas do texto do manual são geradas em -www-master.debian.org como parte do processo regular de reconstrução do site, -que acontece a cada quatro horas. -</p> +Os privilégios de envio estão disponíveis para qualquer pessoa que deseje +participar da redação de manuais, FAQs, HOWTOs, etc. Geralmente solicitamos que +você primeiro envie alguns patches úteis. Depois disso, siga estas etapas +para solicitar acesso de gravação: +</p> + +<ol> + <li>Crie uma conta no <a href="https://salsa.debian.org/">salsa</a> se ainda + não o fez.</li> + <li>Vá para o <a href="https://salsa.debian.org/ddp-team/">repositório do DDP</a> + e clique em <em>Request Access</em> (Solicitar acesso).</li> + <li>Envie um e-mail (em inglês) para + <a href="mailto:debian-doc@lists.debian.org">debian-doc@lists.debian.org</a> + e conte-nos como você tem contribuído para o projeto Debian.</li> + <li>Assim que sua solicitação for aprovada, você fará parte da equipe do + DDP.</li> +</ol> + +<h2><a id="updates">Mecanismo de atualização automática</a></h2> <p> -O processo é configurado para baixar as versões mais recentes do pacote do -repositório, reconstruir cada manual e instalar os arquivos no subdiretório +Todos os manuais são publicados como páginas web. Elas são geradas +automaticamente em www-master.debian.org como parte do processo regular de +reconstrução do site web, que acontece a cada quatro horas. Durante esse +processo, as versões mais recentes do pacote são baixadas do repositório, cada +manual é reconstruído e todos os arquivos são transferidos para o subdiretório <code>doc/manuals/</code> do site web. </p> <p> Os arquivos de documentação gerados pelo script de atualização podem ser -encontrados em <a href="manuals/">https://www.debian.org/doc/manuals/</a>. -</p> +encontrados em <a href="manuals/">https://www.debian.org/doc/manuals/</a>.</p> <p> Os arquivos de log gerados pelo processo de atualização podem ser encontrados |