PODEBCONF-REPORT-PO

NOME

SINOPSE

DESCRIÇÃO

O podebconf-report-po também pode ser utilizado para enviar um pedido de traduções para uma mailing list. Neste caso, o ficheiro POT será anexado.

Existem diferentes templates para pedidos de actualização da tradução, pedidos para enviar ficheiros PO actualizados para um relatório de bug (--submit) ou para chamadas para traduções (--call). O template pode também ser fornecido pelo utilizador. Veja a secção TEMPLATES para mais informações acerca dos templates.  

OPÇÕES

--addlanguageteam=LANGUAGE:LIST

Especificar a mailing list para um determinado idioma. Quando for utilizado <--languageteam> esta mailing list será acrescentada ao CC da lista para os ficheiros PO deste idioma, além disso a equipa do idioma especificado no ficheiro PO (se estas mailing lists diferirem).

Isto é útil para manter as equipas especificas informadas, e permitir uma reacção mais rápida quando se sabe que um tradutor está inactivo.

Esta opção pode ser especificada mais do que uma vez. O código do idioma e a mailing list do idioma são separados pelo sinal de dois pontos.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--bts=NUMBER

Após ter sido enviado um relato de bug (manualmente ou com a flag --submit) para seguir as traduções, o podebconf-report-po pode correr novamente, mas desta vez com a flag --bts=NUMBER. É então pedido aos tradutores que respeitem o campo do cabeçalho Reply-To: que é definido para este relato de bug, para que todas as traduções sejam juntas num mesmo local único.

--call[=MAILING_LIST]

Enviar um pedido de traduções. Se o argumento opcional MAILING_LIST não for especificado, o pedido de traduções é enviado para a lista Debian Internationalization (debian-i18n@lists.debian.org).

Os pedidos de traduções são úteis para receber traduções em novos idiomas.

Por pré-definição, os pedidos de traduções são combinados com os pedidos normais de actualização de traduções aos tradutores, para as traduções já existentes. Você pode desabilitar este comportamento pré-definido com a opção --withouttranslators.

--conf=FILE

Especificar o ficheiro de configuração. O ficheiro pré-definido que o podebconf-report-po lê é o $HOME/.podebconf-report-po.conf.

--noconf

Não ler qualquer ficheiro de configuração.

--deadline=DEADLINE

Especificar o prazo para receber as traduções actualizadas (o valor pré-definido é sem prazo).

Isto deve ser uma data, que pode ser precedida por:
 O prazo para receber a tradução actualizada é
 DEADLINE.

Se a string especificada começar com um '+', será interpretada por:
 LC_ALL=C date -R -d DEADLINE

Se não for especificado um prazo (e não for utilizada a opção --nodeadline), será perguntado um prazo ao utilizador, propondo um prazo pré-definido de +10days.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

<--nodeadline

Desactivar a indicação de prazo aos tradutores, e evitar perguntas de prazos.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--default

Não abrir o editor e utilizar o template conforme está.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--nodefault

Abrir um editor antes de enviar o(s) email(s).

-f, --force

Enviar email(s) sem confirmação.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--noforce

Pedir confirmação antes de enviar email(s).

--from=FROM

Especifique o nome e o endereço de email do remetente (o valor por omissão é tirado das variáveis de ambiente DEBEMAIL e DEBFULLNAME, ou da variável de ambiente EMAIL, ou é definido pelo maintainer do pacote se estas variáveis não estiverem definidas).

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--gzip

Comprimir os ficheiros PO em anexo com "gzip".

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--nogzip

Não comprimir os ficheiros PO.

-h, --help

Mostrar a informação de utilização e sair.

--langs=LANGUAGES

Especificar uma lista de idiomas para restringir o envio da notificação apenas para esses idiomas. A lista de idiomas é separada por vírgulas. Os ficheiros PO têm de ter o nome de acordo com esses idiomas, com a extensão .po.

--languageteam

Enviar também o email à Equipa do Idioma como CC.

Está activo por pré-definição.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--nolanguageteam

Não enviar o(s) email(s) às equipas de idioma.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--mutt

Enviar os mails com o mutt. Isto define o argumento --postpone para $HOME/postponed.

--notdebconf

Indicar que não é uma tradução debconf. podebconf-report-po irá utilizar o modelo translator-po, call-po, ou submit-po (se nenhuns outros modelos forem pedidos no ficheiro de configuração ou na linha de comandos). Estes modelos não mencionam debconf no título ou no corpo do email e são mais adequados para traduções não-debconf.

Esta opção também muda o directório po pré-definido utilizado pelo podebconf-report-po (i.e. a opção --podir não é necessária quando a chamada for feita a partir do próprio directório po ou a partir do seu directório pai).

Por pré-definição, é preferido um directório debian/po em vez dum directório po. Com esta opção, apenas será considerado o directório po.

Esta opção normalmente não é necessária. O podebconf-report-po tenta determinar o tipo de tradução baseada no directório actual e a existência dum directório debian/po ou po.

--package=PACKAGE

Especificar o nome do pacote (o valor pré-definido é o nome do pacote source).

--podir=DIR

Especifique onde estão localizados os ficheiros PO. Por pré-definição, o podebconf-report-po verifica se é chamado a partir de um directório po, ou procura por um directório debian/po (isto pode ser desabilitado com a opção --notdebconf), ou por um directório po.

--postpone=MBOX

Não enviar emails, acrescentá-los em MBOX. Este ficheiro pode ser utilizado para ler uma caixa de correio adiada com o mutt -p.

--potfile=POTFILE

Especifique o ficheiro POT a enviar num pedido de traduções (--call). Por omissão, o podebconf-report-po utiliza o ficheiro POT do directório dos ficheiros PO se existir apenas um.

Este ficheiro também é utilizado para procurar o nome e versão do pacote, caso não tenha sido especificado nenhum com uma opção, e não tiver sido encontrado o ficheiro debian/changelog.

--sendmessage

Enviar apenas uma mensagem, sem anexos. Isto pode ser útil quando os tradutores tiverem permissões para 'commit' no repositório de pacotes.

--smtp=SERVER

Especificar o servidor SMTP para o envio (o valor pré-definido é "localhost").

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--submit

Em vez de enviar mails aos tradutores, lançar um relatório de bug contra este pacote para pedir traduções. Isto é útil e.g. quando se preparam uploads de não-maintainers (NMUs) para ter a certeza que as traduções não se perdem.

--summary

Enviar um relatório de estado ao maintainer com a lista de emails enviados aos tradutores.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--nosummary

Não enviar qualquer relatório de estado ao maintainer.

--utf8

Enviar o email em UTF-8. Isto permite caracteres não-ascii no corpo e cabeçalho do mail. O editor tem de suportar UTF-8.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--noutf8

Enviar o(s) email(s) em us-ascii. Os caracteres não-ascii são substituídos por um ponto de interrogação.

--version

Mostrar a informação da versão e sair.

-v, --verbose

Mostrar informação adicional enquanto está a correr.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--noverbose

Não utilizar o modo detalhado.

--templatecall=TEMPLATE

Especificar o ficheiro a utilizar como template para o(s) email(s) da chamada de traduções. O template pré-definido é /usr/share/po-debconf/templates/call.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--templatesubmit=TEMPLATE

Especificar um ficheiro para utilizar como template para o(s) email(s) a enviar aos tradutores quando for utilizada a opção --submit. O template pré-definido é /usr/share/po-debconf/templates/submit.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--templatetranslators=TEMPLATE

Especificar um ficheiro a utilizar como template para o(s) email(s) a serem enviados aos tradutores. O template pré-definido é /usr/share/po-debconf/templates/translators.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--template=TEMPLATE

Especifique o ficheiro a utilizar como template para o(s) email(s). Se for especificado um template com esta opção, este template será utilizado em vez de um template especificado com qualquer das opções --templatetranslators, --templatesubmit, ou --templatecall.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--notemplate

Utilizar o template pré-definido.

--withtranslators

Enviar aos tradutores pedidos de actualização após ter sido enviado o pedido de traduções.

Esta opção é ignorada quando não é especificada a opção --call. Está habilitada por pré-definição.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

--withouttranslators

Não enviar, aos tradutores, pedidos de actualização de traduções após o pedido de traduções.

Esta opção pode ser especificada no ficheiro de configuração para definir o comportamento pré-definido de podebconf-report-po. Veja, abaixo, a secção CONFIGURATION FILE.

FICHEIRO DE CONFIGURAÇÃO

Os ficheiros de configuração aceitam a maioria das opções de linha de comandos, sem o -- no começo: deadline, nodeadline, smtp, from, verbose, force, templatetranslators, templatesubmit, templatecall, template, default, gzip, languageteam, nolanguageteam, addlanguageteam, summary, utf8, withtranslators, withtranslators.

As linhas que comecem por um símbolo cardinal (possivelmente precedidos de espaços) são comentários e são ignorados.

Aqui está um exemplo:
 # Isto é um comentário
 smtp smtp.meudominio
 from = Eu Próprio <eu@meudominio>
 utf8  

TEMPLATES

<from>, <subject>, <reply-to>

Substituído pelos cabeçalhos correspondentes do(s) email(s).

<filelist>

No modo pré-definido, é substituído por comentários que mostram a lista de tradutores com traduções desactualizadas.

No modo --submit, é substituído pela lista de ficheiros PO com traduções desactualizadas.

E no modo --call, é substituído pela lista de ficheiros PO encontrados no directório PO.

<reply>

Substituído por uma 'string' que indica como os tradutores têm de responder (e.g. seguido do tag Reply-To ou enviar o PO para um dado relatório de bug).

<deadline>

Substituído pela mensagem que indica o prazo para a tradução (veja --deadline).

<package>

Substituído pelo nome do pacote (se foi detectado).

<statistics>

Substituído pelas estatísticas dos ficheiros PO encontrados no directório PO (apenas no modo --call).

O directório /usr/share/po-debconf/templates contém os templates pré-definidos.  

EXEMPLOS

podebconf-report-po --call

Isto irá enviar um pedido de novas traduções para a mailing list <debian-i18n@lists.debian.org> e irá pedir aos tradutores anteriores actualizações das traduções. As equipas de idiomas também serão notificadas e deverão reagir se for conhecido que o tradutor alocado esteja 'MIA' (desaparecido).

Uma questão irá pedir um prazo ao utilizador (o pré-definido é pedir traduções e actualizações dentro de 10 dias).

Depois um editor irá mostrar a mensagem a ser enviada para a mailing list. Quando este editor terminar, o podebconf-report-po irá pedir uma confirmação para enviar o email para a mailing list.

Se for confirmado, outro editor irá mostrar a mensagem a ser enviada aos tradutores e equipas de tradução. O podebconf-report-po irá pedir outra confirmação para enviar emails aos tradutores e equipas de tradução.

Deve fazer um novo lançamento com as traduções recebidas após o prazo.  

VEJA TAMBÉM

AUTOR

  Fabio Tranchitella <kobold@kobold.it>

Index

NOME

SINOPSE

DESCRIÇÃO

OPÇÕES

FICHEIRO DE CONFIGURAÇÃO

TEMPLATES

EXEMPLOS

VEJA TAMBÉM

AUTOR