[RFR] wml://www.debian.org/doc/vcs.wml
Olá pessoal,
Favor revisar a tradução do arquivo em anexo.
Abraços,
--
Paulo Henrique de Lima Santana (phls)
Belo Horizonte - Brasil
Debian Developer
Diretor do Instituto para Conservação de Tecnologias Livres
Site: http://phls.com.br
GNU/Linux user: 228719 GPG ID: 0443C450
#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="e6e987deba52309df5b062b1567c8f952d7bd476"
<link href="$(HOME)/font-awesome.css" rel="stylesheet" type="text/css">
<ul class="toc">
<li><a href="#access">Acessando os fontes 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>
<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 fontes do serviço salsa, mas apenas os(as)
membros(as) do DDP têm acesso de escrita e podem atualizar os arquivos.</p>
</aside>
<h2><a id="access">Acessando os fontes no git</a></h2>
<p>
Você pode usar uma interface web para acessar os arquivos individualmente e ver
as alterações de cada projeto em
<url "https://salsa.debian.org/ddp-team/"; />
</p>
<p>
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 as atividades do projeto em geral, por favor visite o
<a href="https://salsa.debian.org/ddp-team/";>repositório do DDP</a>.
</p>
<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 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 anonimamente (modo apenas leitura)</h3>
<p>
Use este comando para baixar todos os arquivos de um projeto:
</p>
<pre>
<code>git clone https://salsa.debian.org/ddp-team/release-notes.git
</pre>
<p>
Faça o mesmo para cada projeto que você 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> para sua área de
transferência.
</p>
<h3>Clonando um repositório git com privilégios de envio (modo leitura e escrita)</h3>
<p>
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>
Com acesso de gravação ao salsa, você pode usar o seguinte comando para
baixar todos os arquivos de um projeto:
</p>
<pre>
git clone git@salsa.debian.org:ddp-team/release-notes.git
</pre>
<p>
Faça o mesmo para todos os projetos que você deseja clonar localmente.
</p>
<h3>Buscando alterações do repositório git remoto</h3>
<p>
Para atualizar sua cópia local com quaisquer alterações feitas por outras
pessoas, entre subdiretório do respectivo manual e execute este comando:
<pre>
git pull
</pre>
<toc-add-entry name="obtaining">Obtendo privilégios de envio</toc-add-entry>
<p>
Os privilégios de envio estão disponíveis para qualquer pessoa que deseja
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>.</li>
<li>Envie um email (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>
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>
<p>
Os arquivos de log gerados pelo processo de atualização podem ser encontrados
em <url "https://www-master.debian.org/build-logs/webwml/"; /> (o script é
denominado <code>7doc</code> e está sendo executado <code>frequentemente</code>
como parte do trabalho do cron).
</p>
# <p>Observe que esse processo gera novamente o diretório
# <code>/doc/manuals/</code>. O conteúdo do diretório <code>/doc/</code> é
# gerado a partir do <a href="/devel/website/desc">webwml</a> ou de outros
# scripts, como os que extraem certos manuais de seus pacotes.</p>
diff --git a/portuguese/doc/vcs.wml b/portuguese/doc/vcs.wml
index d7a373f01d4..148db898b2b 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 fontes 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 fontes 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 fontes 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 as 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 você 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> 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 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 deseja
+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>.</li>
+ <li>Envie um email (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
Reply to: