table of contents
other languages
PODEBCONF-REPORT-PO(1) | po-debconf | PODEBCONF-REPORT-PO(1) |
NOME¶
podebconf-report-po - enviar ficheiros PO de debconf, desactualizados, aos últimos tradutoresSINOPSE¶
podebconf-report-po [options]DESCRIÇÃO¶
Este programa lê um directório com ficheiros po para determinar quais os ficheiros que contêm traduções em falta ou marcadas como fuzzy, lança um editor para permitir modificações ao corpo e cabeçalhos do mail, pede confirmação para enviar os mails, e envia-os ao último tradutor pedindo uma actualização. O mail irá conter o ficheiro PO que tem de ser actualizado. O podebconf-report-po pode ser chamado quer a partir do directório de nível de topo, ou nos sub-directórios debian ou debian/po (ou, para traduções não-debconf, a partir do próprio directório po ou do seu directório-pai). 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¶
Podem ser definidas muitas opções num ficheiro de configuração. Veja a secção FICHEIRO DE CONFIGURAÇÃO.- --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¶
Por omissão, o podebconf-report-po lê $HOME/.podebconf-report-po.conf. O ficheiro de configuração pode ser definido com a opção --conf. Pode também ignorar qualquer ficheiro de configuração ao especificar a opção --noconf. As opções da linha de comandos podem ser utilizadas para ultrapassar as definições do 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¶
Os templates especificados com as opções --template, --templatetranslators, --templatesubmit, ou --templatecall podem conter as seguintes tags:- <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).
EXEMPLOS¶
A utilização recomendada é chamar podebconf-report-po a partir do directório po a ser actualizado: 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¶
debconf-updatepo(1)AUTOR¶
Fabio Tranchitella <kobold@kobold.it>
2014-06-22 |