NOM¶

Locale::Po4a::TransTractor - generic trans(lator ex)tractor.

DESCRIPCIÓ¶

L'objectiu del projecte po4a (PO per a tot) és facilitar la traducció (i sobretot el manteniment de les traduccions) utilitzant les eines de gettext en àrees on no eren d'esperar, com ara en la documentació.

Aquesta classe és l'antecessor de tots els analitzadors de po4a, utilitzats per analitzar documents buscant-ne les cadenes traduïbles, extraient-les cap a un fitxer PO, i reemplaçant-les per la seva traducció en el document de sortida

Més formalment, agafa els següents paràmetres com a entrada:

• un document a traduir;
• un fitxer PO que conté les traduccions a utilitzar.

Com a sortida, genera:

• un altre fitxer PO, resultat de l'extracció de les cadenes traduïbles del document d'entrada;
• un document traduït, amb la mateixa estructura que el de l'entrada, però amb totes les cadenes traduïbles substituïdes per les traduccions del fitxer PO passat a l'entrada.

Aquí hi ha una representació gràfica:

   Document d'entrada -\                          /---> Document de sortida
                         \                        /          (traduït)
                          +--> funció parse() --+
                         /                        \
   PO d'entrada --------/                          \---> PO de sortida
                                                            (extret)

FUNCIONS QUE EL VOSTRE ANALITZADOR HA D'IMPLEMENTAR¶

parse()

Aquí és on es fa tota la feina: s'analitzen els documents d'entrada, es genera la sortida, i s'extreuen les cadenes traduïbles. És molt simple donades les funcions presentades a la secció FUNCIONS INTERNES de més avall. Consulteu també la SINOPSI, que en mostra un exemple.

Aquesta funció es crida des de la funció process() de més avall, però si escolliu d'utilitzar la funció new(), i afegir els continguts manualment al vostre document, haureu de cridar aquesta funció manualment.

docheader()

Aquesta funció retorna la capçalera que hauriem d'afegir als documents traduïts, tractada adequadament perquè sigui un comentari en el format destí. Vegeu la secció Educant els desenvolupadors sobre les traduccions, a po4a(7), per veure perquè serveix.

SINOPSI¶

The following example parses a list of paragraphs beginning with "<p>". For the sake of simplicity, we assume that the document is well formatted, i.e. that '<p>' tags are the only tags present, and that this tag is at the very beginning of each paragraph.

 sub parse {
   my $self = shift;
   PARAGRAF: while (1) {
       $my ($paragraf,$pararef)=("","","","");
       $my $primera=1;
       my ($linia,$lref)=$self->shiftline();
       while (defined($linia)) {
           if ($linia =~ m/<p>/ && !$primera--; ) {
               # No és la primera vegada que veiem <p>.
               # Tornem a posar la línia actual a l'entrada,
               #  i posem el paràgraf construït a la sortida
               $document->unshiftline($linia,$lref);
               # Ara que el document està construït, el traduïm:
               #   - Eliminem el tag del principi
               $paragraf =~ s/^<p>//s;
               #   - push to output the leading tag (untranslated) and the
               #     rest of the paragraph (translated)
               $self->pushline(  "<p>"
                               . $self->translate($paragraph,$pararef)
                               );
               next PARAGRAF;
           } else {
               # L'afegim al paràgraf
               $paragraf .= $linia;
               $pararef = $lref unless(length($pararef));
           }
           # Reinit the loop
           ($line,$lref)=$self->shiftline();
       }
       # Did not get a defined line? End of input file.
       return;
   }
 }

Un cop hagueu implementat la vostra funció parse, ja podeu utilitzar la vostra classe de documents, a través de la interfície pública presentada a la següent secció.

INTERFÍCIE PÚBLICA per guions que utilitzin el vostre analitzador¶

INTERNAL FUNCTIONS used to write derivative parsers¶

 * Perl shift returns the first array item and drop it from the array.
 * Perl unshift prepends an item to the array as the first array item.
 * Perl pop returns the last array item and drop it from the array.
 * Perl push appends an item to the array as the last array item.

  $self->translate("cadena","ref","tipus",
                   'wrap' => 1);

DIRECCIONS FUTURES¶

Una deficiència del TransTractor actual és que no pot tractar documents traduïts que continguin tots els idiomes, com ara les plantilles de debconf, o els fitxers .desktop.

Per resoldre aquest problema, els únics canvis necessaris a la interfície són:

• take a hash as po_in_name (a list per language)
• afegir un paràmetre a translate per indicar l'idioma destí
• make a pushline_all function, which would make pushline of its content for all languages, using a map-like syntax:

      $self->pushline_all({ "Description[".$codiidioma."]=".
                            $self->translate($linia,$ref,$codiidioma)
                          });
      

Ja veurem si és suficient ;)

AUTORS¶

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)
 Jordi Vilalta <jvprat@gmail.com>

TRADUCCIÓ¶

 Carme Cirera <menxu@hotmail.com>
 Jordi Vilalta <jvprat@gmail.com>