[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[RFR] manual-do-usuario-do-dpo-tools.html

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
rtuguese@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 (adrianorg@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.
Reply to: