dgit 13.12_dgit-downstream-dsc_7 - en to pt translation catalogue (75 entries)

note: type: =head1
en: NAME
pt: NOME

note: type: =head1
en: CONFIGURATION
pt: CONFIGURAÇÃO

note: type: =head1
en: SEE ALSO
pt: VEJA TAMBÉM

note: type: =head1
en: INTRODUCTION
pt: INTRODUÇÃO

note: type: textblock
en: dgit-downstream-dsc - setting up dgit push for a new distro
pt: dgit-downstream-dsc - definir o dgit push para uma nova distribuição

note: type: textblock
en: This document is aimed at downstreams of Debian.  It explains how you can publish your packages' source code both as traditional Debian source packages, and as git branches, using B<dgit push>.  Your users will be able to get the source with B<dgit clone>, or with traditional tools such as B<apt-get source>.
pt: Este documento destina-se a fluxos abaixo de Debian.  Explica como você pode publicar o código fonte dos seus pacotes ambos como pacotes fonte tradicionais Debian, e como ramos git, usando B<dgit push>.  Os seus utilizadores serão capazes de obter a fonte com B<dgit clone>, ou com ferramentas tradicionais como B<apt-get source>.

note: type: textblock
en: Note that often it is unnecessary to publish traditional source packages.  Debian-format source packages can be complex, idiosyncratic and difficult to work with.  You should avoid them if you can.  If you do not need to publish source packages, you can work as a Debian downstream purely using git branches, (using dgit to get the source from Debian in git form).  You can build binaries directly from git, and push package source code as a git branch to an ordinary git server.  See L<dgit-user(7)>.
pt: Note que geralmente é desnecessário publicar pacotes fonte tradicionais. Os pacotes fonte de formato Debian conseguem ser complexos, idiossincráticos e difíceis de trabalhar com eles.  Você deve evita-los de puder.  Se você não precisar publicar pacotes fonte, você pode trabalhar num fluxo abaixo de Debian usando puramente ramos git, (usando o dgit para obter a fonte de Debian em formato git).  Você pode compilar binários diretamente de git, e enviar o código fonte do pacote como um ramo git para um servidor git normal. Veja L<dgit-user(7)>.

note: type: textblock
en: Not every option is covered here.  L<dgit(1)> has a mostly-complete list of config options, although not always with useful descriptions.
pt: Nem todas as opções são cobertas aqui.  L<dgit(1)> tem uma lista muito completa de opções de configuração, apesar de nem sempre com descrições úteis.

note: type: =head1
en: NAMES
pt: NOMES

note: type: textblock
en: You need to choose some names.
pt: Você precisa de escolher alguns nomes.

note: type: =item
en: I<distro> name
pt: I<distro> nome

note: type: textblock
en: dgit understands each thing it interacts with as a B<distro>.  So in dgit terms, you are setting up a distro.
pt: O dgit compreende tudo o que interage como uma B<distribuição>.  Assim em termos do dgit, você está a configurar uma distribuição.

note: type: textblock
en: You need a name for yourself (ie for your distro).  The name will appear in the git tags made by your tools, and in configuration settings.  It must be globally unique across all people and institutions who use dgit.
pt: Você precisa dum nome para si (isto é, para a sua distribuição).  O nome irá aparecer nas etiquetas git feitas pelas suas ferramentas, e nas definições de configuração.  Tem de ser único globalmente entre todas as pessoas e instituições que usem o dgit,

note: type: textblock
en: You could choose your organisation's domain name, or a part of it if you think that is going to be very unique.
pt: Você pode escolher o nome de domínio da sua organização, ou parte dele se achar que vai ser muito único.

note: type: textblock
en: The distro name may contain ascii alphanumerics and B<. + ->, although B<-> may be confusing and is probably best avoided.  Try to avoid uppercase letters (and underscore): you will be typing this name a lot.
pt: O nome da distribuição pode conter alfanuméricos ascii e B<. + ->, apesar de B<-> poder criar confusão e provavelmente o melhor é evita-lo.  Tente evitar letras maiúsculas (e underscore): você vai teclar este nome muitas vezes.

note: type: textblock
en: For example, if you were the Free Software Foundation Europe (fsfe.org)  you might call your distro fsfe or fsfe.org.  In the rest of this document we will write I<distro> for your distro name.
pt: Por exemplo, se você for a Free Software Foundation Europe (fsfe.org)  você poderá chamar a sua distribuição fsfe ou fsfe.org.  No resto deste documento nós vamos só escrever I<distro> para o seu nome de distribuição.

note: type: =item
en: I<suite> names
pt: I<suite> nomes

note: type: textblock
en: In dgit and Debian archive terminology, a B<suite> is a line of development, and/or a Debian release.  For example, at the time of writing, Debian has suites like B<sid> aka B<unstable>, B<trixie> aka B<testing>, and B<bookworm> aka B<stable>.  There are also ancillary suites like B<bookworm-security>.
pt: Em dgit e terminologia de arquivo Debian, uma B<suite> é uma linha de desenvolvimento e/ou um lançamento Debian.  Por exemplo, à data desta escrita, Debian tem suites como B<sid> aka B<unstable>, B<trixie> aka B<testing>, e B<bookworm> aka B<stable>.  Existem também suites auxiliares como a B<bookworm-security>.

note: type: textblock
en: If your releases align with Debian's releases, then your suites should contain the Debian suite names.  B<Do not> use just the Debian names.  That will cause confusion.  Instead, prepend your organisation's name and a hyphen.  For example, FSFE might end up with suites like fsfe-trixie.
pt: Se os seus lançamentos alinharem com lançamentos de Debian, então as suas suites devem conter os nomes de suites Debian.  B<Não> use apenas os nomes de Debian.  Isso vai criar confusão.  Em vez disso, anteceda com o nome da sua organização e um hífen.  Por exemplo, FSFE poderia ficar com suites como fsfe-trixie.

note: type: textblock
en: Suite names end up in git ref and branch names, and on dgit command lines.  Suite names can contain alphanumerics and C<->.  Other characters may work but are not recommended.
pt: Os nomes de suite acabam em referências git e nomes de ramo, e nas linhas de comando do dgit.  Os nomes de suite pode conter alfanuméricos e C<->.  Outros caracteres podem funcionar mas não são recomendados.

note: type: =head1
en: SERVICES
pt: SERVIÇOS

note: type: textblock
en: You will need to run two parallel services:
pt: Você vai precisar de correr dois serviços paralelos:

note: type: =item
en: git server
pt: servidor git

note: type: textblock
en: This will hold the git branches accessed by dgit.
pt: Isto vai manter os ramos git acedidos pelo dgit.

note: type: textblock
en: Everyone who will use dgit push needs to be able to update B<refs/dgit/>I<suite> (note, not B<refs/heads/dgit/>I<suite>) on that server, and to make tags I<distro>B</>I<version> and B<archive/>I<distro>B</>I<version>.  Normally this would be done over ssh.
pt: Qualquer pessoa que irá usar dgit push precisa de ser capaz de atualizar B<refs/dgit/>I<suite> (nota, não B<refs/heads/dgit/>I<suite>) nesse servidor, e para criar etiquetas I<distro>B</>I<version> e B<archive/>I<distro>B</>I<version>.  Normalmente isto deve ser feito sobre ssh.

note: type: textblock
en: The server may host other branches and tags too.  So this might be your ordinary git server, or an instance of a git hosting system.
pt: O servidor também pode hospedar outros ramos e etiquetas.  Assim este pode ser o seu servidor git normal, ou uma instância de um sistema de hospedagem git.

note: type: textblock
en: Everyone who obtains one of your source packages, or who will run B<dgit clone> and B<dgit fetch>, needs to have at least read access to the git server.  Ideally everything would be published via the git smart https protocol.
pt: Qualquer pessoa que obtenha um dos seus pacotes fonte, ou quem irá correr B<dgit clone> e B<dgit fetch>, precisa de ter pelo menos acesso de leitura ao servidor git.  Idealmente tudo seria publicado via protocolo https inteligente do git.

note: type: textblock
en: The git server name, and public git url structure, should be chosen so they will not need to change in the future.  Best is to give the git server a DNS name of its own.
pt: O nome do servidor git, e a estrutura de url de git público, devem ser escolhidos de modo que não precisem ser alterados no futuro.  O melhor é dar ao servidor git um nome DNS dele próprio.

note: type: textblock
en: Debian's dgit git server has special access control rules, implemented in B<dgit-repos-server> and B<dgit-repos-policy-debian> in the package B<dgit-infrastructure>.  but in most installations this is not needed.  If there is no or little distinction between (i) developers who are entitled to upload (push) and (ii) repository administrators, then it is sufficient to provide a git server with a unix account for each user who will be pushing, perhaps using ssh restricted commands.
pt: O servidor git dgit de Debian tem regras de controlo de acesso especiais, implementadas em B<dgit-repos-server> e B<dgit-repos-policy-debian> no pacote B<dgit-infrastructure>.  Mas na maioria das instalações isto não é necessário.  Se não existir distinção, ou for pequena, entre (i) desenvolvedores que têm direito a enviar (push) e (ii) administradores do repositório, então é suficiente fornecer um servidor git com uma conta unix para cada utilizador que irá enviar, talvez usando comandos restritos de ssh.

note: type: =item
en: Debian-format archive (repository)
pt: Arquivo de formato Debian (repositório)

note: type: textblock
en: This holds the source packages.  You will probably use the same archive to host your binaries, and point your B<apt> at it.
pt: Isto detém os pacotes fonte.  Você irá provavelmente usar o mesmo arquivo para hospedar os seus binários, e apontar o seu B<apt> a ele.

note: type: textblock
en: dgit uses the term B<archive> for this.
pt: O dgit usa o termo B<arquivo> para isto.

note: type: textblock
en: There are a variety of tools for creating and managing a Debian-format archive.  In this document we will assume you are using B<reprepro>.
pt: Existe uma variedade de ferramentas para criar e gerir um arquivo de formato Debian.  Neste documento vamos assumir que você está a usar o B<reprepro>.

note: type: textblock
en: Setting up reprepro is not covered in this tutorial.  Instead, we assume you already have reprepro working.
pt: Configurar o reprepro não está coberto por este tutorial.  Em vez disso, assumimos que você já tem o reprepro a funcionar.

note: type: textblock
en: You should also write appropriate dput configuration, since dgit uses dput to upload packages to the archive.  This will involve choosing a dput host name.  That's probably your distro name, I<distro>.
pt: Você deve também escrever uma configuração apropriada do dput, pois o dgit usa o dput para enviar pacotes para o arquivo.  Isto irá envolver escolher um nome de máquina do dput.  Isso será provavelmente o seu nome de distribuição, I<distro>.

note: type: textblock
en: When you have all of the above set up, you are ready to explain to dgit how to access your systems.
pt: Quando você tiver tudo que foi dito em cima configurado, está pronto para explicar ao dgit como aceder aos seus sistemas.

note: type: textblock
en: dgit is configured via git's configuration system, so this is done with git configuration.  See L<git-config(1)>.
pt: O dgit é configurado via sistema de configuração do git, assim isto é feito com a configuração do git.  Veja L<git-config(1)>.

note: type: textblock
en: Below, each heading is one or more git config keys.  B<bold> is literal text and I<italics> is things that vary.  In the descriptions of the effects of config settings, we refer to the config values C<like this>.
pt: Em baixo, cada título é uma ou mais chaves de configuração do git.  B<negrito> é texto literal e I<itálico> são coisas que variam.  Nas descrições dos efeitos das definições de configuração, nós referimos os valores de configuração C<assim>.

note: type: textblock
en: Specify the publicly accessible git URLs for your dgit git server.  The urls generated are C<git-url>B</>I<package>C<git-url-suffix>
pt: Especifica os URLs git de acesso público para o seu servidor git dgit.  Os urls gerados são C<git-url>B</>I<pacote>C<git-url-sufixo>

note: type: textblock
en: The url should be stable, and publicly accessible, because its name is published in .dsc files.  (Note that if you make modified versions of packages from Debian, the copyleft licences used for Free Software often require you to permit your users, employees, and downstreams to further distribute your modified source code.)
pt: O url deve ser estável, e acessível publicamente, porque o seu nome é publicado em ficheiros .dsc.  (Note que você fez versões modificadas dos pacotes a partir de Debian, as licenças de cópia usadas para Software Livre geralmente requerem que você permita aos seus utilizadores, empregados, e outros fluxos abaixo do seu, que continuem a distribuir o seu código fonte modificado.)

note: type: textblock
en: The domain name of your git server's ssh interface.
pt: O nome de domínio da sua interface ssh do servidor git.

note: type: textblock
en: Some git hosting systems expect everyone to connect over ssh as the same user, often B<git>.  If this is the case, set C<git-user-force> to that user.
pt: Alguns sistemas de hospedagem git esperam que todos se liguem por ssh como o mesmo utilizador, geralmente B<git>.  Se este for o caso, defina C<git-user-force> para esse utilizador.

note: type: textblock
en: If you have a normal git over ssh arrangement, where people ssh as themselves, leave C<git-user-force> unset.  If a user wishes to override the username (for example, if their local username is not the same as on the server)  they can set C<username>.
pt: Se você tiver um acordo de git sobre ssh normal, onde as pessoas usam ssh como elas próprias, deixe C<git-user-force> por definir.  Se um utilizador desejar sobrepor o nome de utilizador (por exemplo, se o seu nome de utilizador local não for o mesmo que no servidor) ele pode definir C<username>.

note: type: textblock
en: Set this to the empty string.  This will arrange that push accesses to the ssh server will use C</push.git-host>, etc.
pt: Defina isto para string vazia.  Isto vai fazer com que os acessos de envio (push) ao servidor ssh irão usar C</push.git-host>, etc.

note: type: textblock
en: The path to your repositories.  dgit push will try to push to C<git-proto>[C<git-user-force>|C<username>B<@>]C<git-path>B</>I<package>B<.git>
pt: O caminho para os seus repositórios.  O dgit push irá tentar enviar para C<git-proto>[C<git-user-force>|C<nome-utilizador>B<@>]C<caminho-git>B</>I<pacote>B<.git>

note: type: textblock
en: dgit clone needs to be able to tell whether there is yet a git repository for a particular package.
pt: O dgit clone precisa de ser capaz de perceber se ainda existe um repositório git para um pacote particular.

note: type: textblock
en: If you always have a git repository for every package in your archive, perhaps because you never use dput/dupload, and always dgit push, set C<git-check> to B<true>.
pt: Se você tiver sempre um repositório git para cada pacote no seu arquivo, talvez porque nunca usou o dput/dupload, e sempre o dgit push, defina C<git-check> para B<true>.

note: type: textblock
en: Otherwise, set C<git-check> to a url prefix - ideally, https.  dgit clone will try to fetch C<git-check>B</>I<package>C<git-check-suffix> and expect to get either some successful fetch (it doesn't matter what)  or a file not found error (http 404 status code).  Other outcomes are fatal errors.
pt: Caso contrário, defina C<git-check> para um prefixo de url - idealmente, https.  O dgit clone irá tentar obter C<git-check>B</>I<pacote>C<git-check-suffix> e esperar obter ou algum sucesso na obtenção (não interessa qual) ou um erro de ficheiro não encontrado (código de estado 404 do http).  Os outros resultados são erros fatais.

note: type: textblock
en: If your git server runs cgit, then you can set C<git-check> to the same as C<git-url>, and C<git-check-suffix> to B</info/refs>.
pt: Se o seu servidor git correr cgit, então você pode definir C<git-check> para o mesmo que C<git-url>, e C<git-check-suffix> para B</info/refs>.

note: type: textblock
en: dgit push also needs to be able to check whether the repo exists.
pt: O dgit push também precisa de ser capaz de verificar se o repositório existe.

note: type: textblock
en: You can set both of these to B<ssh-cmd>, which will use an ssh shell command to test repository existence.  Or leave them unset, and dgit push will use the readonly details.  If repositories are created automatically on push, somehow, you can set C<git-create> to B<true>.
pt: Você pode definir ambos estes para B<ssh-cmd>, o que irá usar um comando shell ssh para testar a existência do repositório.  Ou deixa-los por definir, e o dgit push irá usar os detalhes de apenas-leitura.  Se os repositórios forem, de alguma forma, criados automaticamente no envio, você pode definir C<git-create> para B<true>.

note: type: textblock
en: What I<host> value to pass to dput, to upload.
pt: Que valor de I<host> passar ao dput, para o envio.

note: type: textblock
en: This is a nickname, not the real host name.  You need to provide everyone who will push with an appropriate dput configuration.  See L<dput.cf(5)>.
pt: Isto é um nome alcunha, não o nome de máquina real. Você precisa de fornecer a todos os que vão enviar uma configuração dput apropriada.  Veja L<dput.cf(5)>.

note: type: textblock
en: A good nickname for your upload host is your distro name I<distro>.
pt: Um bom nome alcunha para a sua máquina de envio é o seu nome de distribuição I<distro>.

note: type: =item
en: B<dgit-distro.>I<distro>B<.mirror>
pt: B<dgit-distro.>I<distro>B<.espelho>

note: type: textblock
en: Set this to the url of your source package archive.  This is the same string as appears in the 2nd field of each B<sources.list> entry.
pt: Defina isto para o url do seu arquivo de pacote fonte.  Esta é a mesma string como aparece no 2º campo de cada entrada do B<sources.list>.

note: type: textblock
en: If you have a smallish distro, set C<archive-query> to B<aptget:> (with a colon).
pt: Se você tem uma distribuição pequenina, defina C<archive-query> para B<aptget:> (com os dois-pontos).

note: type: textblock
en: If your distro is large (eg, if it contains a substantial fraction of Debian)  then this will not be very efficient: with this setting, dgit often needs to download and update Sources files.
pt: Se a sua distribuição é grande (ex, se conter uma fração substancial de Debian)  então isto não vai ser muito eficiente: com esta definição, o dgit precisa muitas vezes de descarregar e atualizar os ficheiros Sources.

note: type: textblock
en: For large distros, it is better to implement the Debian archive ftpmaster API.  See L<https://api.ftp-master.debian.org/>, and set C<archive-query> to B<ftpmasterapi:> (with a colon)  and C<archive-query-url> to your API base URL.  dgit uses these queries: B<suites>, B<dsc_in_suite/>I<isuite>B</>I<package> and B<file_in_archive/>I<pat> (so you need not implement anything else).
pt: Para distribuições grandes, é melhor implementar a API ftpmaster do arquivo Debian.  Veja L<https://api.ftp-master.debian.org/>, e defina C<archive-query> para B<ftpmasterapi:> (com o :)  e C<archive-query-url> para o seu URL base da API.  O dgit usa estas consultas: B<suites>, B<dsc_in_suite/>I<isuite>B</>I<pacote> e B<file_in_archive/>I<pat> (assim não precisa de implementar mais nada).

note: type: textblock
en: Alternatively, if your system supports the rmadison protocol, you can set C<archive-query> to B<madison:>[I<madison-distro>].  dgit will invoke B<rmadison> -uI<madison-distro>.
pt: Em alternativa, se o seu sistema suportar o protocolo rmadison, você pode definir C<archive-query> para B<madison:>[I<madison-distro>].  O dgit irá invocar B<rmadison> -uI<madison-distro>.

note: type: textblock
en: Set this for every one of your suites.  You will have to update this when new suites are created.  If you forget, your users can explicitly specify B<-d> I<distro> to dgit.
pt: Defina isto para cada uma das suas suites.  Você terá de atualizar isto quando forem criadas novas suites.  Se você se esquecer, os seus utilizadores podem especificar explicitamente B<-d> I<distro> ao dgit.

note: type: =head1
en: TEMPLATE GIT REPOSITORY
pt: REPOSITÓRIO GIT DE MODELOS

note: type: textblock
en: When dgit push is used for I<package> for the first time, it must create a git repository on the git server.
pt: Quando o dgit push é usado para I<pacote> na primeira vez, tem de criar um repositório git no servidor git.

note: type: textblock
en: If C<git-create> is set to B<ssh-cmd>, dgit will use the user's shell access to the server to B<cp -a _template.git> I<package>B<.git>.  So you should create B<_template.git> with suitable contents.
pt: Se C<git-create> for definido para B<ssh-cmd>, o dgit irá usar o acesso de shell do utilizador ao servidor para B<cp -a _template.git> I<pacote>B<.git>.  Assim você deve criar B<_template.git> com conteúdo apropriado.

note: type: textblock
en: Note that the ssh rune invoked by dgit does not do any locking.  So if two people dgit push the same package at the same time, there will be lossage.  Either don't do that, or set up B<dgit-repos-server>.
pt: Note que a runa ssh invocada pelo dgit não faz nenhuma tranca.  Assim se duas pessoas usarem dgit push no mesmo pacote ao mesmo tempo, vai haver perdas.  Ou nunca façam isso, ou configure B<dgit-repos-server>.

note: type: =head1
en: SSH COMMANDS
pt: COMANDOS SSH

note: type: textblock
en: When a user who can push runs dgit, dgit uses ssh to access the git server.
pt: Quando um utilizador que pode enviar usa o dgit, o dgit usa ssh para aceder ao servidor git.

note: type: textblock
en: To make use of ssh restricted command easier, and for the benefit of dgit-repos-server, dgit's ssh commands each start with a parseable commentish rune.
pt: Para facilitar o uso de comandos restritos do ssh, e para o beneficio de dgit-repos-server, cada comando ssh do dgit começa com uma runa de comentários analisáveis.

note: type: textblock
en: The ssh commands used by dgit are these:
pt: Os comandos ssh usados pelo dgit são estes:

note: type: =item
en: B<: dgit> I<distro> B<git-check> I<package> B<;>...
pt: B<: dgit> I<distro> B<git-check> I<pacote> B<;>...

note: type: textblock
en: Test whether I<package> has a git repo on the server already.  Should print B<0> or B<1> and a newline, and exit status zero in either case.  The rest of the command, after B<;>, is a shell implementation of this test.  Used when C<git-check> is set to B<ssh-cmd>.
pt: Testa se o I<pacote> já tem um repositório git no servidor.  Deve escrever B<0> ou B<1> e uma nova linha, e termina com estado zero em qualquer caso.  O resto do comando, após B<;>, é uma implementação de shell para este teste.  Usado quando C<git-check> é definido para B<ssh-cmd>.

note: type: =item
en: B<: dgit> I<distro> B<git-create> I<package> B<;>...
pt: B<: dgit> I<distro> B<git-create> I<pacote> B<;>...

note: type: textblock
en: Create the git repository for I<package> on the server.  See L</TEMPLATE GIT REPOSITORY>, above.  The rest of the command is an appropriate invocation of cd and cp.  Used when C<git-create> is set to B<ssh-cmd>.
pt: Cria o repositório git para o I<pacote> no servidor.  Veja L</REPOSITÓRIO GIT DE MODELOS>, em cima.  O resto do comando é uma invocação apropriada de cd e cp.  Usado quando C<git-create> é definido para B<ssh-cmd>.

note: type: textblock
en: dgit invokes git to access the repository; git then runs these commands.  Note that dgit push will first do a git fetch over ssh, so you must provide upload-pack as well as receive-pack.
pt: O dgit invoca git para aceder ao repositório; o git depois corre estes comandos.  Note que o dgit push irá primeiro fazer uma busca git sobre ssh, assim você tem de fornecer upload-pack assim como receive-pack.

note: type: textblock
en: (There are also other ssh commands which are historical or obscure.)
pt: (Existem também outros comandos ssh que são históricos ou obscuros.)
