--- using_git.wml 2022-02-24 12:28:41.880402289 -0300 +++ using_git.tico.wml 2022-02-24 14:51:03.860771071 -0300 @@ -15,7 +15,7 @@ usuário(a) pode manter uma cópia local de um repositório main. As cópias locais podem estar na mesma máquina ou em todo o mundo. Os(As) desenvolvedores(as) podem então modificar a cópia local e fazer o commit -suas alterações de volta no repositório principal quando estiverem prontos.

 +de suas alterações de volta no repositório principal quando estiverem prontos.



Trabalhando no repositório Git

@@ -25,7 +25,7 @@ do repositório main, como manter esse repositório atualizado e como enviar seu trabalho. Também explicaremos como trabalhar nas traduções. -

 +



Obtenha uma cópia local

@@ -66,7 +66,7 @@

Dica: clonar todo o repositório webwml requer o download de aproximadamente 1,3 GB de dados, o que pode ser bastante se você -estiver em uma conexão de internet lenta ou instável. Portanto, é possível +estiver em uma conexão de Internet lenta ou instável. Portanto, é possível definir uma profundidade mínima para um download inicial menor:

@@ -90,7 +90,7 @@
  • git config core.sparseCheckout true
  • Crie o arquivo .git/info/sparse-checkout dentro do diretório webwml para definir o conteúdo que você deseja obter. Por - exemplo, se você deseja recuperar apenas os arquivos base, traduções do + exemplo, se deseja recuperar apenas os arquivos base, traduções do inglês, catalão e espanhol, o arquivo será dessa forma:
           /*
    @@ -99,7 +99,7 @@
           /catalan/
           /spanish/
         
  • -
  • Então, você poderá obter o repo: git checkout --
  •  +
  • A seguir, poderá obter o repo: git checkout --
  • 

    Envie as mudanças locais

    @@ -118,7 +118,7 @@

    É altamente recomendável manter seu diretório de trabalho Git local limpo antes de executar git pull e começar a editar alguns arquivos. -Se você tiver alterações que não foram feitos commit ou commits locais que não +Se você tiver alterações que não foram feitos commit, ou commits locais que não estão presentes no repositório remoto no branch atual, executar git pull criará automaticamente merge commits ou até mesmo falhará devido a conflitos. Por favor, considere manter seu trabalho inacabado em @@ -138,7 +138,7 @@ Estamos assumindo que você obteve uma cópia local do repositório usando git clone. Seus próximos passos são: -

     +

    
    1. git pull
    2. @@ -146,17 +146,17 @@
    3. Quando terminar, faça o commit de suas alterações em seu repositório local:
      -    git add caminho/para/o(s)/arquivo(s)
      +    git add caminho/para/os/arquivos
           git commit -m "Sua mensagem de commit"
           
    4. Se você tiver acesso ilimitado de escrita no - repositório remoto webwml, agora você pode enviar suas alterações + repositório remoto webwml, poderá enviar suas alterações diretamente para o repositório no Salsa: git push
    5. -
    6. Se você não tiver acesso direto de escrita ao repositório +
    7. Se não tiver acesso direto de escrita ao repositório webwml, envie suas alterações com um merge request ou entre em contato com outros(as) desenvolvedores(as) para obter ajuda.
    8. -
     +

    @@ -171,15 +171,15 @@

    Links com HTTP/HTTPS

    -

    Muitos sites web do Debian suportam SSL/TLS, então por favor use links com +

    Muitos sites web do Debian suportam SSL/TLS, por favor use links com HTTPS sempre que possível e sensato. No entanto, alguns sites web Debian/DebConf/SPI/etc não têm suporte a HTTPS ou usam apenas o CA SPI (e não um CA SSL confiável para todos os navegadores). Para evitar causar -mensagens de erro para usuários(as) não-Debian, por favor, não crie links para +mensagens de erro para usuários(as) não Debian, por favor não crie links para esses sites usando HTTPS.

    -

    O repositório Git irá rejeitar commits contendo links HTTP simples para sites -web do Debian que suportam HTTPS ou contendo links HTTPS para sites web +

    O repositório Git rejeitará commits contendo links HTTP simples para sites +web do Debian que suportam HTTPS, ou contendo links HTTPS para sites web Debian/DebConf/SPI que são conhecidos por não suportarem HTTPS ou usarem certificados assinados apenas pela SPI.

    @@ -194,7 +194,7 @@ hash com o seguinte comando:

    -  git log path/to/english/file
    +  git log caminho/para/arquivo/em/inglês
     

    Se você fizer uma nova tradução de um arquivo, por favor use o script @@ -210,12 +210,12 @@

    Veja como usar smart_change.pl e como atualizar os cabeçalhos -translation-check quando você estiver trabalhando em arquivos +translation-check quando estiver trabalhando em arquivos manualmente:

      -
    1. Faça as alterações no(s) arquivo(s) original(is) e faça o commit das suas +
    2. Faça as alterações nos arquivos originais e faça o commit das suas alterações.
    3. Atualize as traduções.
    4. Execute smart_change.pl -c COMMIT_HASH (use o hash do commit @@ -224,17 +224,17 @@ traduzidos.
    5. Revise as alterações (por exemplo, com git diff).
    6. Faça o commit das alterações de tradução.
    7. -
     +

    Como alternativa, você pode trabalhar com expressões regulares para fazer várias alterações nos arquivos em uma única passagem: -

     +

    
    1. Execute smart_change.pl -s s/FOO/BAR/ origfile1 origfile2 ...
    2. Revise as alterações (por exemplo, com git diff).
    3. -
    4. Faça o commit do(s) arquivo(s) original(is).
    5.  +
    6. Faça o commit dos arquivos originais.
    7. 
    8. Execute smart_change.pl origfile1 origfile2 (ou seja, sem o regexp desta vez). Ele agora apenas atualizará os cabeçalhos dos arquivos traduzidos.
    9. @@ -243,7 +243,7 @@

      É certo que isso requer um pouco mais de esforço do que o primeiro exemplo, -pois envolve dois commits, mas inevitável devido à maneira como os hashes do +pois envolve dois commits, mas é inevitável devido à maneira como os hashes do Git funcionam.

      @@ -252,9 +252,9 @@

      O código-fonte do site web do Debian é gerenciado com o Git e localizado em . -Por padrão, os convidados não têm permissão para enviar os commits para o +Por padrão, convidados(as) não têm permissão para enviar os commits para o repositório de código-fonte. -Se você deseja contribuir com o site web do Debian, você precisa de algum tipo +Se você deseja contribuir com o site web do Debian, precisa de algum tipo de permissão para obter acesso de escrita no repositório.

      @@ -262,7 +262,7 @@

      Se você precisa de acesso ilimitado de escrita no repositório, por exemplo, se -você está prestes a se tornar um(a) contribuidor(a) frequente, por favor, +está prestes a se tornar um(a) contribuidor(a) frequente, por favor, solicite o acesso de escrita através da interface web após fazer login na plataforma do Salsa do Debian. @@ -270,18 +270,18 @@

      Se você é novo(a) no desenvolvimento do site web do Debian e não tem -experiência anterior, por favor envie um email para +experiência anterior, por favor envie um e-mail para debian-www@lists.debian.org e -se apresente antes de solicitar acesso ilimitado de escrita. Você poderia ser -tão gentil e nos contar mais sobre você, por exemplo, em qual parte do site web -você planeja trabalhar, quais idiomas você fala, e também se há outro(a) +se apresente antes de solicitar acesso ilimitado de escrita. Seja gentil +e nos conte mais sobre você, por exemplo, em qual parte do site web +planeja trabalhar, quais idiomas fala, e também se há outro(a) membro(a) da equipe do Debian que pode atestar por você.

      Merge Requests

      -Não é necessário obter acesso ilimitado de escrito no repositório — você sempre +Não é necessário obter acesso ilimitado de escrita no repositório — você sempre pode enviar um merge request e permitir que outros(as) desenvolvedores(as) revisem e aceitem seu trabalho. Por favor, siga o procedimento padrão para solicitações de merge requests fornecido pela plataforma Salsa GitLab por meio @@ -295,9 +295,9 @@

      Por favor observe que os merge requests não são monitoradas por todos(as) os(as) -desenvolvedores(as) do site web. Portanto, pode levar algum tempo até que você -receba algum feedback. Se você quer saber se sua contribuição será aceita ou -não, por favor envie um email para a lista de discussão +desenvolvedores(as) do site web. Portanto, pode levar algum tempo até que +receba algum feedback. Se quer saber se sua contribuição será aceita ou +não, por favor envie um e-mail para a lista de discussão debian-www e peça uma revisão.

      @@ -305,9 +305,9 @@

      Obtendo notificações

      -Se você está trabalhando no site web do Debian, você provavelmente quer saber o +Se você está trabalhando no site web do Debian, provavelmente quer saber o que está acontecendo no repositório webwml. Há duas maneiras de se -manter atualizado: notificações de commit e notificações de merge request. +manter atualizado(a): notificações de commit e notificações de merge request.

      Recebendo notificações de commit

      @@ -316,14 +316,14 @@ sejam mostrados no canal IRC #debian-www.

      -Se você deseja receber notificações sobre commits no repo webwml -por e-mail, assine o pseudo pacote www.debian.org via -tracker.debian.org e ative a palavra-chave vcs lá, seguindo estes +Se deseja receber notificações sobre commits no repo webwml +por e-mail, assine o pseudopacote www.debian.org via +tracker.debian.org e ative a palavra-chave vcs, seguindo estes passos (apenas uma vez):

      1. Abra um navegador web e vá para .
      2. -
      3. Assine o pseudo pacote www.debian.org. (você pode autenticar +
      4. Assine o pseudopacote www.debian.org (você pode autenticar via SSO ou registrar um e-mail e senha, se ainda não estiver usando o tracker.debian.org para outros propósitos).
      5. Vá para , depois @@ -331,14 +331,14 @@ marcado) e salve.
      6. A partir de agora, você receberá e-mails quando alguém fizer commit no repositório webwml.
      7. -
       +
    

    Recebendo notificações de Merge Request

    -Se você deseja receber e-mails de notificação sempre que houver novos merge -requests enviados para o repositório webwml no Salsa, você pode -configurar suas opções de notificação na interface web, seguindo estas etapas: +Se deseja receber e-mails de notificação sempre que houver novos merge +requests enviadas para o repositório webwml no Salsa, você pode +configurar suas opções de notificação na interface web seguindo estas etapas: