Boa noite pessoal,
Tenho um pedido de RFR meio estranho a fazer. A um tempo atrás eu assumi
a tarefa de empacotar o dpo-tools do nosso amigo Adriano e como estava
bem lento o processo, a Tassia me arranjou uma ajudante internacional, a
alemã Judit, que tem o objetivo de aprender a empacotar, assim como eu.
Então estamos tentando aprender todo o processo simplesmente fazendo.
Estamos na fase de fazer a documentação que irá com o pacote, as
manpages, e elas serão baseadas no manual que o próprio Adriano escreveu
em seu site. Para continuarmos o processo, até mesmo para que a Judit
entenda como o dpo-tools funciona e como utiliza-lo, precisei traduzir o
manual. Então solicito a vocês que revisem a tradução que fiz, que esta
no arquivo txt em anexo.
Endereço do manual:
https://www.arg.eti.br/blog/pages/software/dpo-tools/manual-do-usuario-do-dpo-tools.html
Desde já agradeço a ajuda e quaisquer dúvidas e sugestões estou a
disposição.
--
Att;
Leandro L. Pereira
Dpo-Tools user manual
The dpo-tools is set of shell scripts that can help you in translation of
podebconf files of Debian.
Visit https://www.arg.eti.br/blog/pages/software/dpo-tools/index.html for
more
information.
Obtaining dpo-tools
To obtain a copy of dpo-tools, visit https://www.arg.eti.br/blog/pages/software
/dpo-tools/index.html and download a copy of the source code. Remember to repla-
ce the number of the version in following examples by the number of the last ver
sion of dpo-tools:
1. Download the source code of dpo-tools:
wget https://www.arg.eti.br/blog/pages/software/dpo-tools/dpo-tools_1.2.tgz
2. Decompress the file:
tar zxvf dpo-tools_1.2.tgz
3. Copy the executable files to some directory of your PATH:
cp dpo-* ~/bin/ or sudo cp dpo-* /usr/local/bin/
Dependencies
The dpo-tools depend on other programs to function correctly. You should have
the following programs installed on your computer:
gettext utilities: msgfmt, msgcat, msgmerge
awk
colordiff
To install them in a Debian or debian-like systems:
sudo aptitude install gettext gawk colordiff
You will want the podebconf-display-po too. To install it in your Debian or
Debian-like system:
sudo aptitude install po-debconf
README
The following content is in the README file distributed with the dpo-tools sour
ce code.
README
The dpo-tools is set of shell scripts that can help you in translation of
Debian
podebconf files. Dpo-tools do not force any rules of how translations
should be done, they only try to use conventions used on the list debian-l10n-po
rtugu...@lists.debian.org.
These are the scripts:
dpo-get-templates: downloads a templates.pot file from podebconf templates
repository.
dpo-init-po: creates and initializes a podebconf file from a templates file.
dpo-apply-templates: updates a debconf file with a new version of your
templates file.
dpo-apply-compendium: updates a podebconf file with strings already
translated from a compendium file
dpo-check: verifies if the podebconf file is well formated
dpo-diff: presents informations in diff format, colorized and paginated
dpo-make-patch: creates a patch file based on two versions of a podebconf
file
dpo-wrap: breaks lines of a podebconf file in 80 column
Instalation
Copy the scripts to some directory in your PATH
Configuration
dpo-init-po.awk: set the variables NAME and EMAIL. If you are using gawk,
the variable YEAR should be adjusted in the beginning of each year. You can
uncomment the line which automatically detects the year, if your interpreter
awk has support for strftime() function.
dpo-init.po: edit the last line of the file to reflect the complete path of
the file dpo-init.po.awk. Example: ~/bin/dpo-init-po.awk
dpo-makepath: set the ID variable with the initials of your name.
dpo-apply-compendium: set the COMPENDIUM variable to reflect the complete
path of compendium file, downloaded from
http://i18n.debian.org/compendia/pt_BR/
Uninstallation
Just remove the scripts
Examples
1. To initiate a new translation: the following sequence of commands does
the download of a podebconf templates file, creates a podebconf file based on
the downloaded templates file, initializes the podebconf file with commonly used
informations, updates the podebconf file with strings from compendium, edits the
podebconf file, breaks the lines of podebconf file in 80 column, verifies if the
podebconf file is well formated and tests the exibition of podebconf file:
$ dpo-get-templates package
$ dpo-init-po package_version_templates.pot
$ dpo-apply-compendium package_pt_BR.po
$ vi package_pt_BR.po
$ dpo-wrap package_pt_BR.po
$ dpo-check package_pt_BR.po
$ podebconf-display-po package_pt_BR.po
$ # send the file package_pt_BR.po to RFR (request for review)
2. To review a translation done by another translator and generate a patch
with suggested changes:
# replace "me" by your initials in the following commands
$ cp package_pt_BR.po package_pt_BR.me.po
$ vi package_pt_BR.me.po
$ dpo-wrap package_pt_BR.me.po
$ dpo-check package_pt_BR.me.po
$ podebconf-display-po package_pt_BR.me.po
$ dpo-make-patch package_pt_BR.po
$ # send the generated patch, answering the RFR (request for review)
3. To apply a new version of templates file to a podebconf file already
translated previously:
$ dpo-get-templates pacote_pt_BR.po
$ dpo-apply-templates pacote_pt_BR.po
Author
Written by Adriano Rafael Gomes (adrian...@arg.eti.br)
Copyright
Copyright (C) 2008,2012 Adriano Rafael Gomes.
GPLv3+ License: GNU GPL version 3 or newer http://gnu.org/licenses/gpl.html.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.