po4a pod - en to ca translation catalogue (363 entries)

note: type: Attribute 'xml:lang' of: <refentry>
en: en
ca: ca

note: type: =head1
en: DESCRIPTION
ca: DESCRIPCIÓ

note: type: =head1
en: OPTIONS
ca: OPCIONS

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The PO file containing the translations.
ca: un fitxer PO que conté les traduccions a utilitzar.

note: type: =head1
en: SEE ALSO
ca: CONSULTEU TAMBÉ

note: type: =head1
en: NAME
ca: NOM

note: type: textblock
en: po4a - update both the PO files and translated documents in one shot
ca: po4a - actualitza els fitxers PO i els documents traduïts alhora

note: type: =head1
en: SYNOPSIS
ca: SINOPSI

note: type: textblock
en: Show a short help message.
ca: Mostra un breu missatge d'ajuda.

note: type: textblock
en: Charset of the addenda. Note that all the addenda should be in the same charset.
ca: Joc de caràcters dels annexos. Tingueu en compte que tots els annexos han d'estar en el mateix joc de caràcters.

note: type: textblock
en: Display the version of the script and exit.
ca: Mostra la versió dels guions i acaba.

note: type: textblock
en: Increase the verbosity of the program.
ca: Incrementa el nivell d'informació del programa.

note: type: textblock
en: Decrease the verbosity of the program.
ca: Disminueix el nivell d'informació del programa.

note: type: textblock
en: Output some debugging information.
ca: Mostra alguna informació de depuració.

note: type: =head2
en: Specifying the documents to translate
ca: Especificant els documents a traduir

note: type: =head1
en: AUTHORS
ca: AUTORS

note: type: =head1
en: COPYRIGHT AND LICENSE
ca: DRET DE CÒPIA I LLICÈNCIA

note: type: textblock
en: po4a-gettextize - convert an original file (and its translation) to a PO file
ca: po4a-gettextize - converteix un fitxer original (i la seva traducció) en un fitxer PO

note: type: textblock
en: (I<XX.po> is the output, all others are inputs)
ca: (I<XX.po> és la sortida, tots els altres són l'entrada)

note: type: textblock
en: Format of the documentation you want to handle. Use the B<--help-format> option to see the list of available formats.
ca: Tipus de format de la documentació que vol tractar. Utilitzi l'opció B<--help-format> per veure el llistat de formats disponibles.

note: type: textblock
en: Charset of the file containing the document to translate.
ca: Joc de caracters del fitxer que conté el document a traduir.

note: type: textblock
en: Charset of the file containing the localized document.
ca: Joc de caracters del fitxer que conté el document localitzat.

note: type: textblock
en: File where the message catalog should be written. If not given, the message catalog will be written to the standard output.
ca: Fitxer on s'escriurà el catàleg de missatges. Si no es proporciona, el catàleg de missatges s'escriurà a la sortida estàndard.

note: type: textblock
en: List the documentation formats understood by po4a.
ca: Llista els formats de documentació reconeguts per po4a.

note: type: verbatim
en:     Original         Translation
ca:     Original         Traducció

note: type: verbatim
en:   chapter            chapter
        paragraph          paragraph
        paragraph          paragraph
        paragraph        chapter
      chapter              paragraph
        paragraph          paragraph
ca:   capítol            capítol
        paràgraf           paràgraf
        paràgraf           paràgraf
        paràgraf         capítol
      capítol              paràgraf
        paràgraf           paràgraf

note: type: textblock
en: po4a-normalize - normalize a documentation file by parsing it in po4a, and writing it back
ca: po4a-normalize - normalitza un fitxer de documentació analitzant-lo amb po4a, i tornant-lo a escriure

note: type: textblock
en: B<po4a-normalize> B<-f> I<fmt> I<master.doc>
ca: B<po4a-normalize> B<-f> I<fmt> I<principal.doc>

note: type: textblock
en: The po4a (PO for anything) project goal is to ease translations (and more interestingly, the maintenance of translations) using gettext tools on areas where they were not expected like documentation.
ca: 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ó.

note: type: textblock
en: The B<po4a-normalize> script is a debugging tool used to make sure that po4a don't change the document when it's not supposed to. Only use it if you're developing a new module, or if you doubt the sanity of the tools.
ca: El guió B<po4a-normalize> és una eina de depuració emprada per comprovar que po4a no canvia els documents quan no ha de fer-ho. Tan sols s'utilitza durant el desenvolupament de nous mòduls, o si dubta de la validesa de les eines.

note: type: textblock
en: po4a-translate - convert a PO file back to documentation format
ca: po4a-translate - retorna un fitxer PO al format de documentació

note: type: textblock
en: B<po4a-translate> B<-f> I<fmt> B<-m> I<master.doc> B<-p> I<XX.po> B<-l> I<XX.doc>
ca: B<po4a-translate> B<-f> I<fmt> B<-m> I<principal.doc> B<-p> I<XX.po> B<-l> I<XX.doc>

note: type: textblock
en: (I<XX.doc> is the output, all others are inputs)
ca: (I<XX.doc> és la sortida, tots els altres són l'entrada)

note: type: textblock
en: The B<po4a-translate> script is in charge of converting the translation (which was done in a PO file) back into the documentation format. The provided PO file should be the translation of the POT file which was produced by L<po4a-gettextize(1)>.
ca: El guió B<po4a-translate> està a càrrec de convertir la traducció (que s'ha fet en un fitxer PO) altre cop cap al format de documentació. El fitxer PO proporcionat ha de ser la traducció del fitxer POT que havia produït L<po4a-gettextize(1)>.

note: type: textblock
en: Add a file to the resulting file (to put translator's name or a section "About this translation", for example). The first line of the file to insert should be a PO4A header indicating where it should be added (see section B<HOWTO add extra text to translations> in L<po4a(7)>).
ca: Afegeix un fitxer al fitxer resultant (per posar el nom del traductor o una secció "Sobre aquesta traducció", per exemple). La primera línia del fitxer a insertar ha de ser una capçalera de PO4A indicant on s'ha d'afegir (consulti la secció B<Com afegir text addicional que no és traducció> a L<po4a(7)>).

note: type: textblock
en: File containing the master document to translate.
ca: Fitxer que conté el document principal a traduir.

note: type: textblock
en: File where the localized (translated) document should be written.
ca: Fitxer on s'haurà d'escriure el document localitzat (traduït).

note: type: textblock
en: File from which the message catalog should be read.
ca: Fitxer del quan s'ha de llegir el catàleg de missatges.

note: type: =head1
en: Adding content (beside translations) to generated files
ca: Afegint contingut (a part de la traducció) als fitxers generats

note: type: textblock
en: The first line of the addendum must be a header indicating where to put it in the document (it can be before or after a given part of the document).  The rest of the file will be added verbatim to the resulting file without further processing.
ca: La primera línia de l'apèndix ha de ser una capçalera que indiqui en quin punt del document s'ha d'insertar (pot ser abans o després d'una part indicada del document).  La resta del fitxer s'afegirà al fitxer resultant sense cap mena de processat.

note: type: textblock
en: Note that if po4a-translate fails to add one of the given files, it discards the whole translation (because the missing file could be the one indicating the author, what would prevent the users to contact him to report bugs in the translation).
ca: Tingueu en compte que si po4a-translate no aconsegueix afegir algun dels fitxers donats, descartarà la traducció completa (perquè el fitxer faltant pot ser el que indiqui l'autor, cosa que evitaria que els usuaris poguessin contactar amb ell per informar-lo d'errors en la traducció).

note: type: textblock
en: The header has a pretty rigid syntax. For more information on how to use this feature and how it works, please refer to the L<po4a(7)> man page.
ca: La capçalera té una sintaxi força rígida. Per a més informació sobre com utilitzar aquesta característica i com funciona, consulti la pàgina de manual de L<po4a(7)>.

note: type: textblock
en: po4a-updatepo - update the translation (in PO format) of documentation
ca: po4a-updatepo - actualitza la traducció (en format PO) de la documentació

note: type: textblock
en: (I<XX.po> are the outputs, all others are inputs)
ca: (I<XX.po> són les sortides, tots els altres són l'entrada)

note: type: textblock
en: The B<po4a-updatepo> script is in charge of updating PO files to make them reflect the changes made to the original documentation file. For that, it converts the documentation file to a POT file, and call L<msgmerge(1)> on this new POT and on the provided PO files.
ca: El guió B<po4a-updatepo> està a càrrec d'actualitzar els fitxers PO per què reflecteixin els canvis fets al fitxer de documentació original. Per això, converteix el fitxer de documentació en un fitxer POT, i després crida L<msgmerge(1)> sobre aquest nou POT i els fitxers PO proporcionats.

note: type: textblock
en: It is possible to give more than one PO file (if you want to update several languages at once), and several documentation files (if you want to store the translations of several documents in the same PO file).
ca: És possible proporcionar més d'un fitxer PO (si vol actualitzar més d'un idioma a la vegada), i diversos fitxers de documentació (si vol emmagatzemar les traduccions de diversos documents en els mateixos fitxers PO).

note: type: textblock
en: File(s) containing the master document to translate.
ca: Fitxer(s) que contenen el document principal a traduir.

note: type: textblock
en: Charset of the files containing the document to translate. Note that all files must have the same charset.
ca: Joc de caracters dels fitxers que contenen el document a traduir. Tingui en compte que tots els fitxers han de tenir el mateix joc de caracters.

note: type: textblock
en: PO file(s) to update. If these files do not exist, they are created by B<po4a-updatepo>.
ca: Fitxer(s) PO a actualitzar. Si aquests no existeixen, B<po4a-updatepo> els crearà.

note: type: textblock
en: Copyright 2005 by SPI, inc.
ca: Copyright 2005 per SPI, inc.

note: type: textblock
en: po4a - framework to translate documentation and other materials
ca: po4a - marc de treball per traduir documentació i d'altre material

note: type: =head1
en: Introduction
ca: Introducció

note: type: textblock
en: Please also see the B<FAQ> below in this document for a more complete list of the advantages and disadvantages of this approach.
ca: Si us plau, llegeixi també les B<PMF> més avall en aquest document per a una llista més completa d'avantatges i desavantatges d'aquesta solució.

note: type: =head2
en: Supported formats
ca: Formats suportats

note: type: textblock
en: Currently, this approach has been successfully implemented to several kinds of text formatting formats:
ca: Actualment, s'ha implementat satisfactòriament aquesta aproximació en alguns formats de text:

note: type: =item
en: Unsupported formats
ca: Formats no suportats

note: type: textblock
en: If you want to add something after the following nroff section:
ca: Si voleu afegir quelcom després de la següent secció de nroff:

note: type: verbatim
en:   .SH "AUTHORS"
ca:   .SH "AUTORS"

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=AUTHORS;beginboundary=\.SH
ca:  PO4A-HEADER:mode=after;position=AUTORS;beginboundary=\.SH

note: type: textblock
en: If you want to add something at the end of the document, give a B<position> matching any line of your document (but only one line. Po4a won't proceed if it's not unique), and give an B<endboundary> matching nothing. Don't use simple strings here like B<"EOF">, but prefer those which have less chance to be in your document.
ca: Si voleu afegir quelcom al final del document, utilitzeu una B<position> que encaixi amb qualsevol línia del document (però només una línia. Po4a no seguirà si no és única), i doneu un B<endboundary> que no encaixi amb res. No utilitzeu cadenes simples aquí, com ara B<"EOF">, sinó cadenes que tinguin menys probabilitats de sortir en el vostre document.

note: type: =head3
en: More detailed example
ca: Exemple més detallat

note: type: textblock
en: Original document (POD formatted):
ca: Document original (en format POD):

note: type: =head1
en: How does it work?
ca: Com funciona?

note: type: =head1
en: FAQ
ca: PMF

note: type: =head2
en: What about the other translation tools for documentation using gettext?
ca: Què hi ha de les altres eines de traducció de documentació que utilitzen gettext?

note: type: textblock
en: This is the tool developed by KDE people to handle DocBook XML. AFAIK, it was the first program to extract strings to translate from documentation to PO files, and inject them back after translation.
ca: Aquesta és l'eina desenvolupada per la gent de KDE per tractar DocBook XML. Si no vaig errat, aquest va ser el primer programa que extreia les cadenes a traduir de la documentació i en feia fitxers PO, i després de la traducció les injectava en el document.

note: type: textblock
en: It can only handle XML, and only a particular DTD. I'm quite unhappy with the handling of lists, which end in one big msgid. When the list become big, the chunk becomes harder to swallow.
ca: Tan sols pot tractar XML, i només un DTD particular. M'ha decepcionat una mica la forma que té de tractar les llistes, que acaba amb un msgid molt gran. Quan la llista creix, el bloc esdevé difícil de tractar.

note: type: textblock
en: This program done by Denis Barbier is a sort of precursor of the po4a SGML module, which more or less deprecates it. As the name says, it handles only the DebianDoc DTD, which is more or less a deprecated DTD.
ca: Aquest programa fet per Denis Barbier és com un precursor del mòdul SGML de po4a, que més o menys el deixa obsolet. Com el nom diu, tan sols tracta el DTD de DebianDoc, que és més o menys un DTD obsolet.

note: type: textblock
en: The main advantages of po4a over them are the ease of extra content addition (which is even worse there) and the ability to achieve gettextization.
ca: Els avantatges principals de po4a sobre aquests és la facilitat d'afegir contingut extra (que és encara pitjor allà) i l'habilitat d'aconseguir la gettextització.

note: type: =head2
en: SUMMARY of the advantages of the gettext based approach
ca: RESUM dels avantatges de l'enfoc basat en gettext

note: type: textblock
en: It is based internally on B<gettext> (but B<po4a> offers a very simple interface so that you don't need to understand the internals to use it).  That way, we don't have to re-implement the wheel, and because of their wide use, we can think that these tools are more or less bug free.
ca: Internament està basat en B<gettext> (però B<po4a> ofereix una interfície molt simple per tal que no necessiteu entendre el funcionament intern per tal d'utilitzar-lo).  Així no hem de reinventar la roda, i degut al seu ampli ús, podem pensar que són unes eines més o menys lliures d'errors.

note: type: textblock
en: Nothing changed for the end-user (beside the fact translations will hopefully be better maintained). The resulting documentation file distributed is exactly the same.
ca: Per l'usuari final no canvia res (a part que les traduccions es mantindran millor actualitzades :). El fitxer de documentació resultant distribuït és exactament el mateix.

note: type: textblock
en: No need for translators to learn a new file syntax and their favorite PO file editor (like Emacs' PO mode, Lokalize or Gtranslator) will work just fine.
ca: No cal que els traductors aprenguin una nova sintaxi de fitxer, i podran treballar amb el seu editor de fitxers PO predilecte (com ara el mode PO d'emacs, Lokalize o Gtranslator).

note: type: textblock
en: But everything isn't green, and this approach also has some disadvantages we have to deal with.
ca: Però no tot és bonic, i aquest enfoc també té alguns desavantatges que haureu de tenir en compte.

note: type: textblock
en: You can't adapt the translated text to your preferences, like splitting a paragraph here, and joining two other ones there. But in some sense, if there is an issue with the original, it should be reported as a bug anyway.
ca: No podeu adaptar el text traduït al vostre gust, com ara partint paràgrafs per aquí, o ajuntant-ne dos per allà. Però vist d'una altra manera, si hi ha algun problema amb l'original, s'hauria d'informar com a error.

note: type: textblock
en: Even with an easy interface, it remains a new tool people have to learn.
ca: Encara que tingui una interfície fàcil, segueix sent una nova eina que la gent ha d'aprendre.

note: type: =head1
en: OPTIONS ACCEPTED BY THIS MODULE
ca: OPCIONS QUE ACCEPTA AQUEST MÒDUL

note: type: textblock
en: These are this module's particular options:
ca: Aquestes són les opcions particulars d'aquest mòdul:

note: type: =head1
en: INLINE CUSTOMIZATION
ca: PERSONALITZACIÓ INCRUSTADA

note: type: =head1
en: STATUS OF THIS MODULE
ca: ESTAT D'AQUEST MÒDUL

note: type: textblock
en: Locale::Po4a::BibTeX - convert BibTeX documents from/to PO files
ca: Locale::Po4a::BibTex - Converteix documents BibTeX des de/a fitxers PO

note: type: textblock
en: NONE.
ca: CAP.

note: type: textblock
en: Locale::Po4a::Chooser - manage po4a modules
ca: Locale::Po4a::Chooser - Gestiona els mòduls de po4a

note: type: textblock
en: Now, you just have to call the Locale::Po4a::Chooser::new() function, passing the name of module as argument.
ca: Ara, tan sols heu de cridar la funció Locale::Po4a::Chooser::new(), passant el nom del mòdul com a paràmetre.

note: type: =item
en: About po4a:
ca: Sobre po4a:

note: type: =item
en: About modules:
ca: Sobre els mòduls:

note: type: textblock
en: Locale::Po4a::Common - common parts of the po4a scripts and utils
ca: Locale::Po4a::Common - Parts comunes dels guions de po4a i utilitats

note: type: textblock
en: Locale::Po4a::Common contains common parts of the po4a scripts and some useful functions used along the other modules.
ca: Locale::Po4a::Common conté parts comunes dels guions de po4a i algunes funcions útils utilitzades pels altres mòduls.

note: type: =head1
en: FUNCTIONS
ca: FUNCIONS

note: type: =head2
en: Showing output messages
ca: Mostrant missatges de sortida

note: type: textblock
en: Shows the current version of the script, and a short copyright message. It takes the name of the script as an argument.
ca: Mostra la versió actual del guió, i un missatge curt de copyright. Pren el nom del guió com a paràmetre.

note: type: textblock
en: This function works like wrap_msg(), but it takes a module name as the first argument, and leaves a space at the left of the message.
ca: Aquesta funció treballa com wrap_msg(), però pren un nom de mòdul com a primer paràmetre, i deixa un espai a l'esquerra del missatge.

note: type: textblock
en: This function works like wrap_msg(), but it takes a file:line reference as the first argument, a module name as the second one, and leaves a space at the left of the message.
ca: Aquesta funció treballa com wrap_msg(), però pren una referència a fitxer:línia com a primer paràmetre, un nom de mòdul com a segon, i deixa un espai a l'esquerra del missatge.

note: type: textblock
en: Locale::Po4a::Dia - convert uncompressed Dia diagrams from/to PO files
ca: Locale::Po4a::Dia - Converteix diagrames descomprimits de Dia des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::Dia is a module to help the translation of diagrams in the uncompressed Dia format into other [human] languages.
ca: Locale::Po4a::Dia és un mòdul que ajuda en la traducció de diagrames en el format descomprimit de Dia cap a altres llenguatges [humans].

note: type: verbatim
en: You can get Dia (the graphical editor for these diagrams) from:
      http://www.gnome.org/projects/dia/
ca: Podeu obtenir Dia (l'editor gràfic per aquests diagrames) de:
      http://www.gnome.org/projects/dia/

note: type: =head1
en: TRANSLATING WITH PO4A::DIA
ca: TRADUINT AMB PO4A::DIA

note: type: textblock
en: This module only translates uncompressed Dia diagrams.  You can save your uncompressed diagrams with Dia itself, unchecking the "Compress diagram files" at the "Save Diagram" dialog.
ca: Aquest mòdul tan sols tradueix diagrames de Dia descomprimits.  Podeu desar els vostres diagrames descomprimits directament amb el Dia, desmarcant l'opció "Comprimeix els fitxers del diagrama" al diàleg "Desa el diagrama".

note: type: verbatim
en: Another way is to uncompress the dia files from command line with:
      gunzip < original.dia > uncompressed.dia
ca: Una altra manera és descomprimir els fitxers dia des de la línia de comandes amb:
      gunzip < original.dia > descomprimit.dia

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags (E<lt>dia:stringE<gt>), and filters the internal strings (the content of the E<lt>dia:diagramdataE<gt> tag), not interesting for translation.
ca: Aquest mòdul és completament funcional, ja que es basa en el mòdul L<Locale::Po4a::Xml>. Aquest tan sols defineix els tags traduïbles (E<lt>dia:stringE<gt>), i filtra les cadenes internes (el contingut del tag E<lt>dia:diagramdataE<gt> tag), que no s'ha de traduir.

note: type: textblock
en: Locale::Po4a::Docbook - convert DocBook XML documents from/to PO files
ca: Locale::Po4a::Docbook - Converteix documents DocBook XML des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::Docbook is a module to help the translation of DocBook XML documents into other [human] languages.
ca: Locale::Po4a::Docbook és un mòdul per ajudar en la traducció de documents en el format DocBook XML a altres llenguatges [humans].

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags and attributes.
ca: Aquest mòdul és completament funcional, ja que es basa en el mòdul L<Locale::Po4a::Xml>. Aquest tan sols defineix els tags i els atributs traduïbles.

note: type: textblock
en: The only known issue is that it doesn't handle entities yet, and this includes the file inclusion entities, but you can translate most of those files alone (except the typical entities files), and it's usually better to maintain them separated.
ca: L'únic error conegut és que encara no tracta les entitats, i això inclou les entitats d'inclusió, però podeu traduir la majoria dels fitxers a incloure per separat (a part dels típics fitxers d'entitats), i normalment fins i tot és millor mantenir-los separats.

note: type: textblock
en: Locale::Po4a::Guide - convert Guide XML documents from/to PO files
ca: Locale::Po4a::Guide - Converteix documents Guide XML des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::Guide is a module to help in the translation of the Gentoo Linux documentation in the Guide XML format into other [human] languages.
ca: Locale::Po4a::Guide és un mòdul que ajuda en la traducció de la documentació de Gentoo Linux en el format Guide XML a altres llenguatges [humans].

note: type: textblock
en: This format is documented here: http://www.gentoo.org/doc/en/xml-guide.xml
ca: Aquest format està documentat aquí: http://www.gentoo.org/doc/en/xml-guide.xml

note: type: textblock
en: The only known issue is that it doesn't include files with the <include href="..."> tag, but you can translate all those files alone, and it's usually better to have them separated.
ca: L'únic problema conegut és que no s'inclouen fitxers amb el tag <include href="...">, però podeu traduir tots aquests per separat, i normalment fins i tot és millor mantenir-los separats.

note: type: textblock
en: Locale::Po4a::Halibut - convert Halibut documents and derivates from/to PO files
ca: Locale::Po4a::Halibut - Converteix documents Halibut i derivats des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::KernelHelp - convert kernel configuration help from/to PO files
ca: Locale::Po4a::KernelHelp - Converteix l'ajuda de configuració del kernel des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::KernelHelp is a module to help the translation of documentation for the Linux kernel configuration options into other [human] languages.
ca: Locale::Po4a::KernelHelp és un mòdul que ajuda en la traducció de la documentació de les opcions de configuració del kernel a altres llenguatges [humans].

note: type: textblock
en: This module is just written, and needs more tests. Most of the needed work will concern the tools used to parse this file (and configure the kernel), so that they accept to read the documentation from another (translated)  file.
ca: Aquest mòdul està acabat d'escriure, i necessita més proves. La major part de la feina consisteix en les eines emprades per analitzar aquest fitxer (i configurar el kernel), perquè puguin acceptar llegir la documentació d'un altre fitxer (traduït).

note: type: textblock
en: Locale::Po4a::LaTeX - convert LaTeX documents and derivates from/to PO files
ca: Locale::Po4a::LaTeX - Converteix documents LaTeX i derivats des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::LaTeX is a module to help the translation of LaTeX documents into other [human] languages. It can also be used as a base to build modules for LaTeX-based documents.
ca: Locale::Po4a::LaTeX és un mòdul per ajudar en la traducció de documents LaTeX a altres llenguatges [humans]. També es pot utilitzar com a base per construir mòduls per documents basats en LaTeX.

note: type: textblock
en: This module contains the definitions of common LaTeX commands and environments.
ca: Aquest mòdul conté les definicions de les comandes i els entorns habituals de LaTeX.

note: type: textblock
en: Locale::Po4a::Man - convert manual pages from/to PO files
ca: Locale::Po4a::Man - Converteix pàgines de manual des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::Man is a module to help the translation of documentation in the nroff format (the language of manual pages) into other [human] languages.
ca: Locale::Po4a::Man és un mòdul per ajudar en la traducció de documentació en el format nroff (el llenguatge de les pàgines de manual) a altres llenguatges [humans].

note: type: =head1
en: TRANSLATING WITH PO4A::MAN
ca: TRADUINT AMB PO4A::MAN

note: type: textblock
en: This module tries pretty hard to make translator's life easier. For that, the text presented to translators isn't a verbatim copy of the text found in the man page. Indeed, the cruder parts of the nroff format are hidden, so that translators can't mess up with them.
ca: Aquest mòdul s'esmera per facilitar la vida dels traductors. Per aconseguir-ho, el text presentat als traductors no és una còpia exacta del text que hi ha a les pàgines de manual. De fet, s'oculten les parts més crues del format nroff, de forma que els traductors no s'hi puguin embolicar.

note: type: =head2
en: Text wrapping
ca: Justificat de text

note: type: textblock
en: Anyway, the difference will only be about the position of the extra spaces in wrapped paragraph, and I think it's worth.
ca: De totes maneres, la diferència tan sols serà en la posició dels espais extra del paràgraf justificat, i crec que val la pena.

note: type: =head2
en: Font specification
ca: Especificació de fonts

note: type: textblock
en: The first change is about font change specifications.  In nroff, there are several ways to specify if a given word should be written in small, bold or italics. In the text to translate, there is only one way, borrowed from the POD (Perl online documentation) format:
ca: El primer canvi és sobre l'especificació de canvis de font.  A nroff hi ha diverses maneres d'especificar si una paraula s'ha d'escriure amb lletra petita, en negreta o en cursiva. En el text a traduir només hi ha una forma, copiada del format POD (la documentació en línia de Perl):

note: type: =item
en: IE<lt>textE<gt> -- italic text
ca: IE<lt>textE<gt> -- text en cursiva

note: type: textblock
en: equivalent to \fItext\fP or ".I text"
ca: equival a \fItext\fP o ".I text"

note: type: =item
en: BE<lt>textE<gt> -- bold text
ca: BE<lt>textE<gt> -- text en negreta

note: type: textblock
en: equivalent to \fBtext\fP or ".B text"
ca: equival a \fBtext\fP o ".B text"

note: type: =item
en: RE<lt>textE<gt> -- roman text
ca: RE<lt>textE<gt> -- text normal

note: type: textblock
en: equivalent to \fRtext\fP
ca: equival a \fRtext\fP

note: type: =item
en: CWE<lt>textE<gt> -- constant width text
ca: CWE<lt>textE<gt> -- text d'ample constant

note: type: textblock
en: equivalent to \f(CWtext\fP or ".CW text"
ca: equival a \f(CWtext\fP o ".CW text"

note: type: textblock
en: Remark: The CW face is not available for all groff devices. It is not recommended to use it. It is provided for your convenience.
ca: Nota: La font CW no està disponible per a tots els dispositius de groff. Es recomana no utilitzar-la. Es proporciona només per a la seva comoditat.

note: type: =head2
en: Putting 'E<lt>' and 'E<gt>' in translations
ca: Posant 'E<lt>' i 'E<gt>' a les traduccions

note: type: textblock
en: Since these chars are used to delimit parts under font modification, you can't use them verbatim. Use EE<lt>ltE<gt> and EE<lt>gtE<gt> instead (as in POD, one more time).
ca: Com que aquests caràcters s'utilitzen per delimitar parts de modificació de fonts, no podeu utilitzar-los directament. Utilitzeu EE<lt>ltE<gt> i EE<lt>gtE<gt> en el seu lloc (una vegada més, igual que en POD).

note: type: textblock
en: Activate debugging for some internal mechanisms of this module.  Use the source to see which parts can be debugged.
ca: Activa la depuració d'alguns mecanismes interns d'aquest mòdul.  Mireu el codi per veure quines parts es poden depurar.

note: type: =head1
en: AUTHORING MAN PAGES COMPLIANT WITH PO4A::MAN
ca: ESCRIVINT PÀGINES DE MANUAL COMPATIBLES AMB PO4A::MAN

note: type: textblock
en: This module is still very limited, and will always be, because it's not a real nroff interpreter. It would be possible to do a real nroff interpreter, to allow authors to use all the existing macros, or even to define new ones in their pages, but we didn't want to. It would be too difficult, and we thought it wasn't necessary. We do think that if manpages' authors want to see their productions translated, they may have to adapt to ease the work of translators.
ca: Aquest mòdul encara és molt limitat, i sempre ho serà, ja que no és un intèrpret real de nroff. Seria possible fer un intèrpret real de nroff, i permetre que els autors utilitzin totes les macros existents, o fins i tot que en defineixin de noves a les seves pàgines, però no és el què volem. Això seria massa difícil, i vam pensar que no era necessari. Creiem que si els autors de pàgines de manual volen veure les seves produccions traduïdes, han d'adaptar-se per facilitar la feina dels traductors.

note: type: textblock
en: So, the man parser implemented in po4a have some known limitations we are not really inclined to correct, and which will constitute some pitfalls you'll have to avoid if you want to see translators taking care of your documentation.
ca: Per tant, l'analitzador de man implementat a po4a té algunes limitacions conegudes que no estem predisposats a arreglar, i que constitueixen alguns esvorancs que haureu d'evitar si voleu que els traductors es preocupin de la vostra documentació.

note: type: =head2
en: Don't program in nroff
ca: No programeu en nroff

note: type: textblock
en: nroff is a complete programming language, with macro definition, conditionals and so on. Since this parser isn't a fully featured nroff interpreter, it will fail on pages using these facilities (There are about 200 such pages on my box).
ca: nroff és un llenguatge de programació complet, amb definicions de macros, condicionals i molt més. Com que aquest analitzador no és un intèrpret complet de nroff, fallarà en pàgines que utilitzin aquestes característiques (hi ha unes 200 pàgines d'aquestes a la meva màquina).

note: type: =head2
en: Use the plain macro set
ca: Utilitzeu el joc de macros estàndards

note: type: textblock
en: There are still some macros which are not supported by po4a::man. This is only because I failed to find any documentation about them. Here is the list of unsupported macros used on my box. Note that this list isn't exhaustive since the program fails on the first encountered unsupported macro. If you have any information about some of these macros, I'll happily add support for them. Because of these macros, about 250 pages on my box are inaccessible to po4a::man.
ca: Encara hi ha algunes macros no suportades per po4a::man. Això és perquè no he aconseguit trobar-ne documentació. Aquí hi ha una llista de macros no suportades que hi ha a la meva màquina. Tingueu en compte que això no és una llista exhaustiva, ja que el programa falla en la primera macro no suportada. Si teniu informació sobre algunes d'aquestes macros, intentaré afegir-ne suport. Degut a aquestes macros, hi ha unes 250 pàgines de la meva màquina que són inaccessibles per a po4a::man.

note: type: =head2
en: Conclusion
ca: Conclusió

note: type: textblock
en: To summarise this section, keep simple, and don't try to be clever while authoring your man pages. A lot of things are possible in nroff, and not supported by this parser. For example, don't try to mess with \c to interrupt the text processing (like 40 pages on my box do). Or, be sure to put the macro arguments on the same line that the macro itself. I know that it's valid in nroff, but would complicate too much the parser to be handled.
ca: Per concloure aquesta secció, no us compliqueu, i no intenteu demostrar la vostra inteligència a l'hora d'escriure les vostres pàgines de manual. Es poden fer moltes coses amb nroff, i no estan suportades per aquest analitzador. Per exemple, no us compliqueu amb \c per interrompre el processat de text (com fan 40 pàgines de la meva màquina). O assegureu-vos de posar els paràmetres de les macros a la mateixa línia que la macro. Ja sé que és vàlid a nroff, però si ho volguéssim tractar, es complicaria molt l'analitzador.

note: type: textblock
en: Locale::Po4a::Po - PO file manipulation module
ca: Locale::Po4a::Po - mòdul per a la manipulació de fitxers PO

note: type: verbatim
en:     use Locale::Po4a::Po;
        my $pofile=Locale::Po4a::Po->new();
ca:     use Locale::Po4a::Po;
        my $fitxerpo=Locale::Po4a::Po->new();

note: type: verbatim
en:     # Read PO file
        $pofile->read('file.po');
ca:     # Llegim el fitxer PO
        $fitxerpo->load('fitxer.po');

note: type: verbatim
en:     # Add an entry
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                      'flags' => "wrap", 'reference'=>'file.c:46');
ca:     # Afegim una entrada
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'Hola', 
                        'flags' => "wrap", 'reference'=>'fitxer.c:46');

note: type: verbatim
en:     # Extract a translation
        $pofile->gettext("Hello"); # returns 'bonjour'
ca:     # Extraiem una traducció
        $fitxerpo->gettext("Hello"); # retorna 'Hola'

note: type: verbatim
en:     # Write back to a file
        $pofile->write('otherfile.po');
ca:     # Escrivim el nou fitxer po
        $fitxerpo->write('unaltrefitxer.po');

note: type: textblock
en: Locale::Po4a::Po is a module that allows you to manipulate message catalogs. You can load and write from/to a file (which extension is often I<po>), you can build new entries on the fly or request for the translation of a string.
ca: Locale::Po4a::Po és un mòdul que permet manipular catàlegs de missatges. Podeu carregar i escriure des de/a un fitxer (l'extensió del qual és habitualment I<po>, podeu crear noves entrades sobre la marxa i demanar la traducció de cadenes.

note: type: textblock
en: This module is part of the po4a project, which objective is to use PO files (designed at origin to ease the translation of program messages) to translate everything, including documentation (man page, info manual), package description, debconf templates, and everything which may benefit from this.
ca: Aquest mòdul és part del projecte po4a, que té per objectiu utilitzar fitxers PO (dissenyats originalment per facilitar la traducció de missatges de programa) per traduir de tot, incloent documentació (pàgines de manual, manuals d'info), descripcions de paquets, plantilles de debconf, i qualsevol altra cosa que se'n pugui beneficiar.

note: type: textblock
en: Creates a new message catalog. If an argument is provided, it's the name of a PO file we should load.
ca: Crea un nou catàleg de missatges. Si se li passa un paràmetre, serà el nom del fitxer PO que ha de carregar.

note: type: textblock
en: Reads a PO file (which name is given as argument).  Previously existing entries in self are not removed, the new ones are added to the end of the catalog.
ca: Llegeix un fitxer PO (el nom del qual es passa com a paràmetre).  Les entrades que ja existien al catàleg actual no s'eliminen, les noves s'afegeixen al final del catàleg.

note: type: textblock
en: Writes the current catalog to the given file.
ca: Escriu el catàleg actual al fitxer donat.

note: type: textblock
en: This function extracts a catalog from an existing one. Only the entries having a reference in the given file will be placed in the resulting catalog.
ca: Aquesta funció extreu un catàleg a partir de l'actual. Només desarà al catàleg resultant les entrades que tinguin una referència al fitxer donat.

note: type: textblock
en: This function parses its argument, converts it to a Perl function definition, evals this definition and filters the fields for which this function returns true.
ca: Aquesta funció analitza els seu paràmetre, el converteix a una definició de funció de Perl, avalua aquesta definició i filtra els camps pels que aquesta funció retorna cert.

note: type: textblock
en: I love Perl sometimes ;)
ca: M'encanta Perl a vegades ;)

note: type: =head1
en: Functions to use a message catalog for translations
ca: Funcions per utilitzar el catàleg de missatges per les traduccions

note: type: textblock
en: Request the translation of the string given as argument in the current catalog.  The function returns the original (untranslated) string if the string was not found.
ca: Retorna la traducció de la cadena donada com a paràmetre al catàleg actual.  La funció retorna l'original (sense traduir) si no troba la cadena.

note: type: textblock
en: After the string to translate, you can pass a hash of extra arguments. Here are the valid entries:
ca: Després de la cadena a traduir, podeu passar un hash de paràmetres extra. Aquestes són les entrades vàlides:

note: type: textblock
en: boolean indicating whether we can consider that whitespaces in string are not important. If yes, the function canonizes the string before looking for a translation, and wraps the result.
ca: booleà que indica si podem considerar que els espais de la cadena no són importants. En cas afirmatiu, la funció canonitza la cadena abans de buscar-ne la traducció, i justifica el resultat.

note: type: textblock
en: the column at which we should wrap (default: 76).
ca: La columna a la que s'ha de justificar (per defecte: 76).

note: type: textblock
en: Returns statistics about the hit ratio of gettext since the last time that stats_clear() was called. Please note that it's not the same statistics than the one printed by msgfmt --statistic. Here, it's statistics about recent usage of the PO file, while msgfmt reports the status of the file.  Example of use:
ca: Retorna les estadístiques sobre la quantitat d'encerts de gettext des de la darrera vegada que s'ha cridat stats_clear(). Tingueu en compte que no són les mateixes estadístiques que mostra msgfmt --statistic. Aquestes són sobre l'ús recent del fitxer PO, mentre que msgfmt informa sobre l'estat del fitxer.  Exemple d'ús:

note: type: verbatim
en:     [some use of the PO file to translate stuff]
ca:     [ús del fitxer PO per traduir coses]

note: type: verbatim
en:     ($percent,$hit,$queries) = $pofile->stats_get();
        print "So far, we found translations for $percent\%  ($hit of $queries) of strings.\n";
ca:     ($percentatge,$encerts,$peticions) = $fitxerpo->stats_get();
        print "Fins ara, s'han trobat traduccions per al $percentatge\%  ($encerts de $peticions) de les cadenes.\n";

note: type: textblock
en: Clears the statistics about gettext hits.
ca: Neteja les estadístiques sobre els encerts de gettext.

note: type: =head1
en: Functions to build a message catalog
ca: Funcions per construir un catàleg de missatges

note: type: textblock
en: Push a new entry at the end of the current catalog. The arguments should form a hash table. The valid keys are:
ca: Insereix una nova entrada al final del catàleg actual. Els paràmetres han de formar una taula de hash. Les claus vàlides són :

note: type: textblock
en: the string in original language.
ca: la cadena en l'idioma original.

note: type: textblock
en: the translation.
ca: la traducció.

note: type: textblock
en: an indication of where this string was found. Example: file.c:46 (meaning in 'file.c' at line 46). It can be a space-separated list in case of multiple occurrences.
ca: una indicació d'on s'ha trobat la cadena. Exemple: fitxer.c:46 (significa a la línia 46 del 'fitxer.c'). Pot ser una llista separada per espais en cas de múltiples ocurrències.

note: type: textblock
en: a comment added here manually (by the translators). The format here is free.
ca: un comentari afegir manualment (pels traductors). El format és lliure.

note: type: textblock
en: a comment which was automatically added by the string extraction program. See the B<--add-comments> option of the B<xgettext> program for more information.
ca: un comentari que ha afegit automàticament el programa d'extracció de cadenes. Vegeu l'opció B<--add-comments> del programa B<xgettext> per a més informació.

note: type: textblock
en: space-separated list of all defined flags for this entry.
ca: llista separada per espais dels flags definits per aquesta entrada.

note: type: textblock
en: Valid flags are: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> and B<fuzzy>.
ca: Els flags vàlids són: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> i B<fuzzy>.

note: type: textblock
en: See the gettext documentation for their meaning.
ca: Vegeu la documentació de gettext pels seus significats.

note: type: textblock
en: this is mostly an internal argument: it is used while gettextizing documents. The idea here is to parse both the original and the translation into a PO object, and merge them, using one's msgid as msgid and the other's msgid as msgstr. To make sure that things get ok, each msgid in PO objects are given a type, based on their structure (like "chapt", "sect1", "p" and so on in DocBook). If the types of strings are not the same, that means that both files do not share the same structure, and the process reports an error.
ca: Aquest és més aviat un paràmetre intern: s'utilitza a l'hora de gettextitzar documents. La idea és analitzar el document original i la traducció a objectes PO, i ajuntar-los, utilitzant els msgid d'un com a msgid, i els msgid de l'altre com a msgstr. Per assegurar que les coses van bé, es dóna un tipus a cada msgid dels objectes po, segons la seva estructura (com ara "chapt", "sect1", "p" i així a DocBook). Si els tipus de les cadenes no coincideixen, significa que ambdós documents no comparteixen la mateixa estructura, i el procés acaba amb un error.

note: type: textblock
en: This information is written as automatic comment in the PO file since this gives to translators some context about the strings to translate.
ca: Aquesta informació s'escriu com a comentari automàtic al fitxer PO ja que dóna informació de context sobre les cadenes a traduir als traductors.

note: type: textblock
en: boolean indicating whether whitespaces can be mangled in cosmetic reformattings. If true, the string is canonized before use.
ca: booleà que indica si els espais en blanc es poden tractar en reformatejats cosmètics. En cas afirmatiu, abans d'utilitzar la cadena, aquesta és canonitzada.

note: type: textblock
en: This information is written to the PO file using the B<wrap> or B<no-wrap> flag.
ca: Aquesta informació s'escriu al fitxer PO utilitzant el flag B<wrap> o B<no-wrap>.

note: type: =head1
en: Miscellaneous functions
ca: Funcions diverses

note: type: textblock
en: Returns the number of entries in the catalog (without the header).
ca: Retorna el nombre d'entrades del catàleg (sense la capçalera).

note: type: textblock
en: Returns the msgid of the given number.
ca: Retorna el msgid del nombre donat.

note: type: textblock
en: Locale::Po4a::Pod - convert POD data from/to PO files
ca: Locale::Po4a::Pod - Converteix dades POD des de/a fitxers PO

note: type: verbatim
en:     # Read POD from STDIN and write to STDOUT.
        $parser->parse_from_filehandle;
ca:     # Llegim el POD de l'entrada estàndard i escrivim a la sortida estàndard.
        $analitzador->parse_from_filehandle;

note: type: verbatim
en:     # Read POD from file.pod and write to file.txt.
        $parser->parse_from_file ('file.pod', 'file.txt');
ca:     # Llegim el POD de fitxer.pod i escrivim a fitxer.txt.
        $analitzador->parse_from_file ('fitxer.pod', 'fitxer.txt');

note: type: textblock
en: Locale::Po4a::Pod is a module to help the translation of documentation in the POD format (the preferred language for documenting Perl) into other [human] languages.
ca: Locale::Po4a::Pod és un mòdul per ajudar en la traducció de documents en el format POD (el llenguatge preferit per documentar Perl) a altres llenguatges [humans].

note: type: textblock
en: I think that this module is rock stable, and there is only one known bug with F</usr/lib/perl5/Tk/MainWindow.pod> (and some other pages, see below) which contains:
ca: Tinc un altre problema amb F</usr/lib/perl5/Tk/MainWindow.pod> (i algunes altres pàgines, vegeu més avall) que contenen:

note: type: textblock
en: which is logic since CE<lt>foobarE<gt> is rewritten "foobar".
ca: que és lògic, ja que CE<lt>foobarE<gt> es reescriu com a "foobar".

note: type: =head1
en: INTERNALS
ca: FUNCIONAMENT INTERN

note: type: textblock
en: As a derived class from Pod::Parser, Locale::Po4a::Pod supports the same methods and interfaces.  See L<Pod::Parser> for all the details; briefly, one creates a new parser with C<< Locale::Po4a::Pod->new() >> and then calls either parse_from_filehandle() or parse_from_file().
ca: Com a classe derivada de Pod::Parser, Locale::Po4a::Pod suporta els mateixos mètodes i interfícies.  Consulteu L<Pod::Parser> per tots els detalls; breument, es crea un nou analitzador amb C<< Locale::Po4a::Pod->new() >> i després es crida la funció parse_from_filehandle() o la funció parse_from_file().

note: type: textblock
en: Locale::Po4a::Sgml - convert SGML documents from/to PO files
ca: Locale::Po4a::Sgml - Converteix documents SGML des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::Sgml is a module to help the translation of documentation in the SGML format into other [human] languages.
ca: Locale::Po4a::SgmL és un mòdul per ajudar en la traducció de documents en el format SGML a altres llenguatges [humans].

note: type: textblock
en: Give more information about what's going on.
ca: Dóna més informació sobre què està passant.

note: type: textblock
en: The layout within those tags should not be changed. The paragraph won't get wrapped, and no extra indentation space or new line will be added for cosmetic purpose.
ca: La disposició dins d'aquests tags no s'ha de canviar. El paràgraf no es justificarà, i no s'afegiran espais d'indentació ni noves línies amb propòsits cosmètics.

note: type: textblock
en: Tags not needing to be closed.
ca: Tags que no necessiten tancament.

note: type: textblock
en: It does work only with the DebianDoc and DocBook DTD. Adding support for a new DTD should be very easy. The mechanism is the same for every DTD, you just have to give a list of the existing tags and some of their characteristics.
ca: Només funciona amb els dtds de DebianDoc i DocBook DTD. Hauria de ser molt fàcil afegir suport per a un nou DTD. El mecanisme és el mateix per a tots els DTD, tan sols heu de donar una llista dels tags existents i algunes de les seves característiques.

note: type: textblock
en: I agree, this needs some more documentation, but it is still considered as beta, and I hate to document stuff which may/will change.
ca: Estic d'acord, això s'ha de documentar millor, però encara es considera beta, i odio documentar coses que poden/han de canviar.

note: type: textblock
en: Warning, support for DTDs is quite experimental. I did not read any reference manual to find the definition of every tag. I did add tag definition to the module 'till it works for some documents I found on the net. If your document use more tags than mine, it won't work. But as I said above, fixing that should be quite easy.
ca: Atenció, el suport de DTDs encara és força experimental. No he llegit cap manual de referència per trobar la definició de tots els tags. Només he afegit la definició de tags al mòdul fins que ha funcionat per alguns documents que he trobat a la xarxa. Si el vostre document utilitza més tags que el meu, no funcionarà. Però com he dit abans, hauria de ser molt fàcil d'arreglar.

note: type: textblock
en: I did test DocBook against the SAG (System Administrator Guide) only, but this document is quite big, and should use most of the DocBook specificities.
ca: Només he provat DocBook amb SAG (Guia d'Administrador de Sistemes, System Administrator Guide), però és un document força gran, i hauria d'utilitzar la majoria de característiques de DocBook.

note: type: textblock
en: For DebianDoc, I tested some of the manuals from the DDP, but not all yet.
ca: Per DebianDoc, he provat amb alguns manuals del DDP, però no tots encara.

note: type: textblock
en: In case of file inclusion, string reference of messages in PO files (i.e. lines like C<#: en/titletoc.sgml:9460>) will be wrong.
ca: En cas d'inclusió de fitxers, la cadena de referència del fitxer PO (és a dir, línies com ara C<#: en/titletoc.sgml:9460>) serà errònia.

note: type: textblock
en: The adaptation for po4a was done by:
ca: L'adaptació per po4a ha estat feta per:

note: type: textblock
en: Locale::Po4a::TeX is a module to help the translation of TeX documents into other [human] languages. It can also be used as a base to build modules for TeX-based documents.
ca: Locale::Po4a::TeX és un mòdul per ajudar en la traducció de documents TeX a altres llenguatges [humans]. També es pot utilitzar com a base per construir mòduls per documents basats en TeX.

note: type: =head1
en: TRANSLATING WITH PO4A::TEX
ca: TRADUINT AMB PO4A::TEX

note: type: textblock
en: This module can be used directly to handle generic TeX documents.  This will split your document in smaller blocks (paragraphs, verbatim blocks, or even smaller like titles or indexes).
ca: Aquest mòdul es pot utilitzar directament per tractar documents TeX genèrics.  Aquest partirà el document en blocs més petits (paràgrafs, blocs literals, o fins i tot més petits, com ara títols o índexs).

note: type: textblock
en: Comma-separated list of environments which should not be re-wrapped.
ca: Llista separada per comes dels entorns, els paràmetres dels quals no s'han de justificar.

note: type: textblock
en: Note that there is a difference between verbatim and no_wrap environments.  There is no command and comments analysis in verbatim blocks.
ca: Tingueu en compte que els entorns verbatim i no_wrap són diferents.  En els blocs verbatim no s'analitzen les comandes ni els comentaris.

note: type: textblock
en: Colon-separated list of files that should not be included by \input and \include.
ca: Llista separada per dos punts dels fitxers que no s'han d'incloure amb \input i \include.

note: type: textblock
en: The TeX module can be customized with lines starting by B<% po4a:>.  These lines are interpreted as commands to the parser.  The following commands are recognized:
ca: El mòdul TeX es pot personalitzar amb línies que comencin amb B<% po4a:>. Aquestes línies s'interpreten com a comandes per l'analitzador. Es reconeixen les següents comandes:

note: type: =item
en: B<% po4a: command> I<command1> B<alias> I<command2>
ca: B<% po4a: command> I<comanda1> B<alias> I<comanda2>

note: type: textblock
en: Indicates that the arguments of the I<command1> command should be treated as the arguments of the I<command2> command.
ca: Indica que els paràmetres de la I<comanda1> s'han de tractar com els paràmetres de la I<comanda2>.

note: type: =item
en: B<% po4a: command> I<command1> I<parameters>
ca: B<% po4a: command> I<comanda1> I<funció1>

note: type: =item
en: B<% po4a: environment> I<env> I<parameters>
ca: B<% po4a: environment> I<ent1> I<funció1>

note: type: =item
en: B<% po4a: verbatim environment> I<env>
ca: B<% po4a: verbatim environment> I<ent1>

note: type: =head1
en: WRITING DERIVATE MODULES
ca: ESCRIVINT MÒDULS DERIVATS

note: type: textblock
en: Wrapper around Transtractor's translate, with pre- and post-processing filters.
ca: Crida la funció translate del Transtractor, amb filtres de pre- i post-processat.

note: type: textblock
en: Comments of a paragraph are inserted as a PO comment for the first translated string of this paragraph.
ca: Els comentaris d'un paràgraf s'inserten com a comentaris del PO en la primera cadena traduïble del paràgraf.

note: type: textblock
en: This function returns:
ca: Aquesta funció retorna:

note: type: =item
en: A command name
ca: Un nom de comanda

note: type: =item
en: A variant
ca: Una variant

note: type: =item
en: The remaining buffer
ca: El buffer restant

note: type: textblock
en: The rest of the buffer after the removal of this leading command and its arguments.  If no command is found, the original buffer is not touched and returned in this field.
ca: La resta del buffer, després de l'eliminació de la comanda inicial i els seus paràmetres.  Si no es troba la comanda, no es toca el buffer original i es retorna en aquest camp.

note: type: textblock
en: The same as B<get_leading_command>, but for commands at the end of a buffer.
ca: El mateix que B<get_leading_command>, però per comandes al final del buffer.

note: type: textblock
en: Recursively translate a buffer by separating leading and trailing commands (those which should be translated separately) from the buffer.
ca: Tradueix un buffer recursivament separant del buffer les comandes inicials i finals (aquelles que s'han de traduir per separat).

note: type: textblock
en: Except from the file inclusion part, it is a cut and paste from Transtractor's read.
ca: A part de la part d'inclusió de fitxers, és una còpia del read del Transtractor.

note: type: textblock
en: Subroutine for parsing a file with po4a directives (definitions for new commands).
ca: Subrutina per analitzar un fitxer amb directives po4a (definicions de noves comandes).

note: type: textblock
en: Parse a definition line of the form "% po4a: ".
ca: Analitza una línia de definició de la forma "% po4a: ".

note: type: textblock
en: See the B<INLINE CUSTOMIZATION> section for more details.
ca: Consulteu la secció B<PERSONALITZACIÓ INCRUSTADA> per a més detalls.

note: type: textblock
en: Command and environment functions take the following arguments (in addition to the $self object):
ca: Les funcions de comandes i d'entorns prenen els següents paràmetres (a més de l'objecte $self):

note: type: =item
en: The current environment
ca: L'entorn actual

note: type: textblock
en: Command and environment functions return the translation of the command with its arguments and a new environment.
ca: Les funcions de comandes i d'entorns retornen la traducció de la comanda amb els seus paràmetres i un nou entorn.

note: type: textblock
en: Environment functions are called when a \begin command is found. They are called with the \begin command and its arguments.
ca: Les funcions d'entorn es criden quan es troba una comanda \begin. Es criden amb la comanda \begin i els seus paràmetres.

note: type: textblock
en: This module needs more tests.
ca: Aquest mòdul necessita més proves.

note: type: textblock
en: It was tested on a book and with the Python documentation.
ca: S'ha provat amb un llibre i amb la documentació de Python.

note: type: =head1
en: TODO LIST
ca: LLISTA DE TASQUES PENDENTS

note: type: =item
en: Others
ca: Altres

note: type: textblock
en: Various other points are tagged TODO in the source.
ca: Hi ha altres punts marcats TODO en el codi.

note: type: =head1
en: KNOWN BUGS
ca: BUGS CONEGUTS

note: type: textblock
en: Locale::Po4a::Texinfo - convert Texinfo documents and derivates from/to PO files
ca: Locale::Po4a::TeX - Converteix documents TeX i derivats des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::Texinfo is a module to help the translation of Texinfo documents into other [human] languages.
ca: Locale::Po4a::Texinfo és un mòdul per ajudar en la traducció de documents en el format Texinfo a altres llenguatges [humans].

note: type: textblock
en: This class is the ancestor of every po4a parser used to parse a document, to search translatable strings, to extract them to a PO file and to replace them by their translation in the output document.
ca: 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

note: type: textblock
en: More formally, it takes the following arguments as input:
ca: Més formalment, agafa els següents paràmetres com a entrada:

note: type: textblock
en: a document to translate;
ca: un document a traduir;

note: type: textblock
en: a PO file containing the translations to use.
ca: un fitxer PO que conté les traduccions a utilitzar.

note: type: textblock
en: As output, it produces:
ca: Com a sortida, genera:

note: type: textblock
en: another PO file, resulting of the extraction of translatable strings from the input document;
ca: un altre fitxer PO, resultat de l'extracció de les cadenes traduïbles del document d'entrada;

note: type: textblock
en: a translated document, with the same structure than the one in input, but with all translatable strings replaced with the translations found in the PO file provided in input.
ca: 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.

note: type: textblock
en: Here is a graphical representation of this:
ca: Aquí hi ha una representació gràfica:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \                           /       (translated)
                          +-> parse() function -----+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
ca:    Document d'entrada -\                          /---> Document de sortida
                             \                        /          (traduït)
                              +--> funció parse() --+
                             /                        \
       PO d'entrada --------/                          \---> PO de sortida
                                                                (extret)

note: type: =head1
en: FUNCTIONS YOUR PARSER SHOULD OVERRIDE
ca: FUNCIONS QUE EL VOSTRE ANALITZADOR HA D'IMPLEMENTAR

note: type: textblock
en: This is where all the work takes place: the parsing of input documents, the generation of output, and the extraction of the translatable strings. This is pretty simple using the provided functions presented in the section B<INTERNAL FUNCTIONS> below. See also the B<SYNOPSIS>, which presents an example.
ca: 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ó B<FUNCIONS INTERNES> de més avall. Consulteu també la B<SINOPSI>, que en mostra un exemple.

note: type: textblock
en: This function is called by the process() function below, but if you choose to use the new() function, and to add content manually to your document, you will have to call this function yourself.
ca: 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.

note: type: textblock
en: This function returns the header we should add to the produced document, quoted properly to be a comment in the target language.  See the section B<Educating developers about translations>, from L<po4a(7)|po4a.7>, for what it is good for.
ca: 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ó B<Educant els desenvolupadors sobre les traduccions>, a L<po4a(7)|po4a.7>, per veure perquè serveix.

note: type: verbatim
en:    PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # Not the first time we see <p>.
                   # Reput the current line in input,
                   #  and put the built paragraph to output
                   $self->unshiftline($line,$lref);
ca:    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);

note: type: verbatim
en:                # Now that the document is formed, translate it:
                   #   - Remove the leading tag
                   $paragraph =~ s/^<p>//s;
ca:                # Ara que el document està construït, el traduïm:
                   #   - Eliminem el tag del principi
                   $paragraf =~ s/^<p>//s;

note: type: verbatim
en:                next PARAGRAPH;
               } else {
                   # Append to the paragraph
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }
ca:                next PARAGRAF;
               } else {
                   # L'afegim al paràgraf
                   $paragraf .= $linia;
                   $pararef = $lref unless(length($pararef));
               }

note: type: textblock
en: Once you've implemented the parse function, you can use your document class, using the public interface presented in the next section.
ca: 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ó.

note: type: =head1
en: PUBLIC INTERFACE for scripts using your parser
ca: INTERFÍCIE PÚBLICA per guions que utilitzin el vostre analitzador

note: type: textblock
en: This function can do all you need to do with a po4a document in one invocation. Its arguments must be packed as a hash. ACTIONS:
ca: Aquesta funció pot fer tot el que necessiteu fer amb un document po4a en una única invocació. Els seus paràmetres han d'estar empaquetats com a un hash. ACCIONS:

note: type: textblock
en: Reads all the PO files specified in po_in_name
ca: Llegeix tots els fitxers PO especificats a po_in_name

note: type: textblock
en: Reads all original documents specified in file_in_name
ca: Llegeix tots els documents originals especificats a file_in_name

note: type: textblock
en: Parses the document
ca: Analitza el document

note: type: textblock
en: Reads and applies all the addenda specified
ca: Llegeix i aplica els annexes especificats

note: type: textblock
en: Writes the translated document to file_out_name (if given)
ca: Escriu el document traduït a file_out_name (si es dóna)

note: type: textblock
en: Writes the extracted PO file to po_out_name (if given)
ca: Escriu el fitxer PO extret a po_out_name (si es dóna)

note: type: textblock
en: ARGUMENTS, beside the ones accepted by new() (with expected type):
ca: PARÀMETRES, a part dels acceptats per new() (amb el tipus esperat):

note: type: textblock
en: List of filenames where we should read the input document.
ca: Llista dels noms dels fitxers dels que s'ha de llegir el document d'entrada.

note: type: textblock
en: Filename where we should write the output document.
ca: Nom del fitxer on s'ha d'escriure el document de sortida.

note: type: textblock
en: List of filenames where we should read the input PO files from, containing the translation which will be used to translate the document.
ca: Llistat dels noms dels fitxers dels que llegirem els PO d'entrada, que contindran la traducció que s'utilitzarà per traduir el document.

note: type: textblock
en: Filename where we should write the output PO file, containing the strings extracted from the input document.
ca: Nom del fitxer on s'escriurà el fitxer PO de sortida, que contindrà les cadenes extretes del document d'entrada.

note: type: textblock
en: Charset for the addenda.
ca: Joc de caràcters dels annexes.

note: type: textblock
en: Sets the verbosity.
ca: Ajusta el nivell d'informació extra.

note: type: textblock
en: Sets the debugging.
ca: Activa la depuració.

note: type: =head2
en: Manipulating document files
ca: Manipulant fitxers de documentació

note: type: textblock
en: Please note that it does not parse anything. You should use the parse()  function when you're done with packing input files into the document.
ca: Tingueu en compte que això no analitza res. Haureu de cridar la funció parse() quan hagueu acabat d'empaquetar els fitxers d'entrada en el document.

note: type: textblock
en: Write the translated document to the given filename.
ca: Escriu el document traduït al fitxer amb el nom donat.

note: type: =head2
en: Manipulating PO files
ca: Manupulant fitxers PO

note: type: textblock
en: Add the content of a file (which name is passed as argument) to the existing input PO. The old content is not discarded.
ca: Afegeix el contingut d'un fitxer (el nom del qual s'ha de passar com a paràmetre) al PO d'entrada actual. No es descarta el contingut anterior.

note: type: textblock
en: Write the extracted PO file to the given filename.
ca: Escriu el fitxer PO extret al fitxer amb el nom donat.

note: type: textblock
en: Returns some statistics about the translation done so far. Please note that it's not the same statistics than the one printed by msgfmt --statistic. Here, it's stats about recent usage of the PO file, while msgfmt reports the status of the file. It is a wrapper to the Locale::Po4a::Po::stats_get function applied to the input PO file. Example of use:
ca: Retorna algunes estadístiques de la traducció feta fins al moment. Tingueu en compte que no són les mateixes estadístiques que mostra msgfmt --statistic. Aquestes són estadístiques sobre l'ús recent del fitxer PO, mentre que msgfmt mostra l'estat del fitxer. Simplement crida la funció Locale::Po4a::Po::stats_get sobre el fitxer PO d'entrada. Exemple d'ús:

note: type: verbatim
en:     [normal use of the po4a document...]
ca:     [ús normal del document po4a...]

note: type: verbatim
en:     ($percent,$hit,$queries) = $document->stats();
        print "We found translations for $percent\%  ($hit from $queries) of strings.\n";
ca:     ($percentatge,$encerts,$peticions) = $document->stats();
        print "S'han trobat traduccions per al $percentatge\%  ($encerts de $peticions) de cadenes.\n";

note: type: =head2
en: Manipulating addenda
ca: Manipulant annexes

note: type: textblock
en: Please refer to L<po4a(7)|po4a.7> for more information on what addenda are, and how translators should write them. To apply an addendum to the translated document, simply pass its filename to this function and you are done ;)
ca: Consulteu L<po4a(7)|po4a.7> per més informació sobre què són els annexes, i com els han d'escriure els traductors. Per tal d'aplicar un annex al document traduït, simplement passeu el nom del fitxer a aquesta funció i ja està ;)

note: type: textblock
en: This function returns a non-null integer on error.
ca: Aquesta funció retorna un enter no nul en cas d'error.

note: type: =head2
en: Getting input, providing output
ca: Obtenint entrada, proporcionant sortida

note: type: =head2
en: Marking strings as translatable
ca: Marcant cadenes com a traduïbles

note: type: textblock
en: One function is provided to handle the text which should be translated.
ca: Es proporciona una funció per tractar el text que s'ha de traduir.

note: type: textblock
en: Mandatory arguments:
ca: Paràmetres obligatoris:

note: type: textblock
en: A string to translate
ca: La cadena a traduir

note: type: textblock
en: The reference of this string (i.e. position in inputfile)
ca: La cadena de referència (és a dir, la posició al fitxer d'entrada)

note: type: textblock
en: The type of this string (i.e. the textual description of its structural role; used in Locale::Po4a::Po::gettextization(); see also L<po4a(7)|po4a.7>, section B<Gettextization: how does it work?>)
ca: El tipus de la cadena (és a dir, la descripció textual del seu significat estructural; s'utilitza a Locale::Po4a::Po::gettextization(); consulteu també la secció I<Gettextització: com funciona?> de L<po4a(7)|po4a.7>)

note: type: textblock
en: This function can also take some extra arguments. They must be organized as a hash. For example:
ca: Aquesta funció també pot rebre alguns paràmetres extra. Aquests han d'estar agrupats en un hash. Per exemple:

note: type: verbatim
en:   $self->translate("string","ref","type",
                       'wrap' => 1);
ca:   $self->translate("cadena","ref","tipus",
                       'wrap' => 1);

note: type: textblock
en: boolean indicating whether we can consider that whitespaces in string are not important. If yes, the function canonizes the string before looking for a translation or extracting it, and wraps the translation.
ca: booleà que indica si podem considerar que els espais de la cadena no són importants. Si té valor cert, la funció canonitzarà la cadena abans de buscar-ne la traducció o d'extreure-la, i en justificarà la traducció.

note: type: textblock
en: an extra comment to add to the entry.
ca: Un comentari extra per afegir a l'entrada.

note: type: textblock
en: Actions:
ca: Accions:

note: type: textblock
en: Pushes the string, reference and type to po_out.
ca: Insereix la cadena, la referència i el tipus a po_out.

note: type: textblock
en: Returns the translation of the string (as found in po_in) so that the parser can build the doc_out.
ca: Retorna la traducció de la cadena (trobada a po_in) per tal que l'analitzador pugui construir el doc_out.

note: type: textblock
en: Handles the charsets to recode the strings before sending them to po_out and before returning the translations.
ca: Tracta els jocs de caràcters per recodificar les cadenes abans d'enviar-les a po_out i abans de retornar les traduccions.

note: type: =head2
en: Misc functions
ca: Funcions diverses

note: type: textblock
en: Returns if the verbose option was passed during the creation of the TransTractor.
ca: Retorna el nivell d'informació extra que es va passar durant la creació del TransTractor.

note: type: textblock
en: Returns if the debug option was passed during the creation of the TransTractor.
ca: Retorna si s'ha passat l'opció de depuració durant la creació del TransTractor.

note: type: textblock
en: This function will return the charset that should be used in the output document (usually useful to substitute the input document's detected charset where it has been found).
ca: Aquesta funció retorna el joc de caràcters que s'ha d'utilitzar en el document de sortida (habitualment és útil per substituir el joc de caràcters del document d'entrada en el lloc on s'ha trobat).

note: type: textblock
en: It will use the output charset specified in the command line. If it wasn't specified, it will use the input PO's charset, and if the input PO has the default "CHARSET", it will return the input document's charset, so that no encoding is performed.
ca: Utilitzarà el joc de caràcters especificat a la línia de comandes. Si no s'ha especificat, utilitzarà el joc de caràcters del PO d'entrada, i si el PO d'entrada conté el valor per defecte "CHARSET", retornarà el joc de caràcters del document d'entrada, de forma que no es realitzi recodificació.

note: type: =head1
en: FUTURE DIRECTIONS
ca: DIRECCIONS FUTURES

note: type: textblock
en: One shortcoming of the current TransTractor is that it can't handle translated document containing all languages, like debconf templates, or .desktop files.
ca: 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.

note: type: textblock
en: To address this problem, the only interface changes needed are:
ca: Per resoldre aquest problema, els únics canvis necessaris a la interfície són:

note: type: textblock
en: add an argument to translate to indicate the target language
ca: afegir un paràmetre a translate per indicar l'idioma destí

note: type: verbatim
en:     $self->pushline_all({ "Description[".$langcode."]=".
                              $self->translate($line,$ref,$langcode)
                            });
ca:     $self->pushline_all({ "Description[".$codiidioma."]=".
                              $self->translate($linia,$ref,$codiidioma)
                            });

note: type: textblock
en: Will see if it's enough ;)
ca: Ja veurem si és suficient ;)

note: type: textblock
en: Locale::Po4a::Xhtml - convert XHTML documents from/to PO files
ca: Locale::Po4a::Xhtml - Converteix documents XHTML des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::Xml - convert XML documents and derivates from/to PO files
ca: Locale::Po4a::Xml - Converteix documents XML i derivats des de/a fitxers PO

note: type: textblock
en: Locale::Po4a::Xml is a module to help the translation of XML documents into other [human] languages. It can also be used as a base to build modules for XML-based documents.
ca: Locale::Po4a::XmL és un mòdul per ajudar en la traducció de documents XML a altres llenguatges [humans]. També es pot utilitzar com a base per construir mòduls per documents basats en XML.

note: type: =head1
en: TRANSLATING WITH PO4A::XML
ca: TRADUINT AMB PO4A::XML

note: type: textblock
en: This module can be used directly to handle generic XML documents.  This will extract all tag's content, and no attributes, since it's where the text is written in most XML based documents.
ca: Aquest mòdul es pot utilitzar directament per tractar documents XML genèrics.  Aquest extraurà el contingut de tots els tags, i cap atribut, ja que aquí és on s'escriu el text en la majoria de documents basats en XML.

note: type: textblock
en: There are some options (described in the next section) that can customize this behavior.  If this doesn't fit to your document format you're encouraged to write your own module derived from this, to describe your format's details.  See the section B<WRITING DERIVATE MODULES> below, for the process description.
ca: Hi ha algunes opcions (descrites a la propera secció) que permeten personalitzar aquest comportament.  Si això no acaba d'encaixar amb el vostre format de document, us animo a escriure el vostre propi mòdul derivat d'aquest, per descriure els detalls del vostre format.  Consulteu la secció B<ESCRIVINT MÒDULS DERIVATS> més avall, per la descripció del procés.

note: type: textblock
en: The global debug option causes this module to show the excluded strings, in order to see if it skips something important.
ca: L'opció global de depuració fa que aquest mòdul mostri les cadenes excloses, per tal de comprovar si se salta quelcom important.

note: type: textblock
en: Prevents it to strip the spaces around the extracted strings.
ca: Evita que es netegin els espais al voltant de les cadenes extretes.

note: type: textblock
en: It makes the tags and attributes searching to work in a case insensitive way.  If it's defined, it will treat E<lt>BooKE<gt>laNG and E<lt>BOOKE<gt>Lang as E<lt>bookE<gt>lang.
ca: Fa que la cerca de tags i atributs es faci independentment de majúscules i minúscules.  Si està definit, tractarà els tags E<lt>BooKE<gt>laNG i E<lt>BOOKE<gt>Lang com E<lt>bookE<gt>lang.

note: type: textblock
en: Example: WE<lt>chapterE<gt>E<lt>titleE<gt>
ca: Exemple: WE<lt>chapterE<gt>E<lt>titleE<gt>

note: type: =head2
en: DEFINE WHAT TAGS AND ATTRIBUTES TO TRANSLATE
ca: DEFINIR ELS TAGS I ATRIBUTS A TRADUIR

note: type: textblock
en: The simplest customization is to define which tags and attributes you want the parser to translate.  This should be done in the initialize function.  First you should call the main initialize, to get the command-line options, and then, append your custom definitions to the options hash.  If you want to treat some new options from command line, you should define them before calling the main initialize:
ca: La personalització més simple tracta de definir quins tags i atributs voleu que l'analitzador tradueixi.  Això s'ha de fer en la funció initialize.  Primer haureu de cridar l'initialize principal, per tal d'obtenir les opcions de la línia de comandes, i després afegir les definicions personalitzades al hash d'opcions.  Si voleu tractar algunes opcions noves de la línia de comandes, haureu de definir-les abans de cridar l'initialize principal:

note: type: =head2
en: OVERRIDING THE found_string FUNCTION
ca: REESCRIVINT LA FUNCIÓ found_string

note: type: textblock
en: Another simple step is to override the function "found_string", which receives the extracted strings from the parser, in order to translate them.  There you can control which strings you want to translate, and perform transformations to them before or after the translation itself.
ca: Una altra forma simple és sobreescriure la funció "found_string", que rep les cadenes que extreu l'analitzador, per tal de traduir-les.  Aquí podeu controlar quines cadenes voleu traduir, i aplicar-los transformacions abans i després de la mateixa traducció.

note: type: textblock
en: It receives the extracted text, the reference on where it was, and a hash that contains extra information to control what strings to translate, how to translate them and to generate the comment.
ca: Rep el text extret, la referència d'on s'ha trobat, i un hash que conté informació extra per controlar quines cadenes s'han de traduir, com traduir-les, i com generar el comentari.

note: type: textblock
en: The content of these options depends on the kind of string it is (specified in an entry of this hash):
ca: El contingut d'aquestes opcions depèn del tipus de cadena que sigui (especificat en una entrada d'aquest hash):

note: type: textblock
en: The found string is the content of a translatable tag. The entry "tag_options" contains the option characters in front of the tag hierarchy in the module "tags" option.
ca: La cadena trobada és el contingut d'un tag traduïble. L'entrada "tag_options" conté els caràcters d'opcions de davant la jerarquia de tags de l'opció "tags" del mòdul.

note: type: textblock
en: Means that the found string is the value of a translatable attribute. The entry "attribute" has the name of the attribute.
ca: Significa que la cadena trobada és el valor d'un atribut traduïble. L'entrada "attribute" conté el nom de l'atribut.

note: type: textblock
en: It must return the text that will replace the original in the translated document. Here's a basic example of this function:
ca: Ha de retornar el text que reemplaçarà l'original al document traduït. Aquí hi ha un exemple bàsic d'aquesta funció:

note: type: verbatim
en:   sub found_string {
        my ($self,$text,$ref,$options)=@_;
        $text = $self->translate($text,$ref,"type ".$options->{'type'},
          'wrap'=>$self->{options}{'wrap'});
        return $text;
      }
ca:   sub found_string {
        my ($self,$text,$ref,$opcions)=@_;
        $text = $self->translate($text,$ref,"type ".$opcions->{'type'},
          'wrap'=>$self->{options}{'wrap'});
        return $text;
      }

note: type: textblock
en: There's another simple example in the new Dia module, which only filters some strings.
ca: Podeu trobar un altre exemple simple en el mòdul de Dia, que tan sols filtra algunes cadenes.

note: type: =head2
en: MODIFYING TAG TYPES (TODO)
ca: MODIFICANT ELS TIPUS DE TAGS (PER FER)

note: type: textblock
en: Specifies the beginning of the tag, after the "E<lt>".
ca: Especifica el principi del tag, després de "E<lt>".

note: type: textblock
en: Specifies the end of the tag, before the "E<gt>".
ca: Especifica el final del tag, abans de "E<gt>".

note: type: textblock
en: It says if this is a breaking tag class.  A non-breaking (inline) tag is one that can be taken as part of the content of another tag.  It can take the values false (0), true (1) or undefined.  If you leave this undefined, you'll have to define the f_breaking function that will say whether a concrete tag of this class is a breaking tag or not.
ca: Indica si aquesta classe de tags és trencadora.  Un tag no-trencador (inline) és un que es pot agafar com a part del contingut d'un altre tag.  Pot prendre els valors fals (0), cert (1) o indefinit.  Si el deixeu indefinit, haureu de definir la funció f_breaking que dirà si un tag concret d'aquesta classe és trencador o no.

note: type: textblock
en: It's a function that will tell if the next tag is a breaking one or not.  It should be defined if the B<breaking> option is not.
ca: És una funció que dirà si el següent tag és trencador o no.  S'ha de definir si l'opció B<breaking> no ho està.

note: type: textblock
en: If you leave this key undefined, the generic extraction function will have to extract the tag itself.  It's useful for tags that can have other tags or special structures in them, so that the main parser doesn't get mad.  This function receives a boolean that says if the tag should be removed from the input stream or not.
ca: Si deixeu aquesta funció indefinida, la funció d'extracció genèrica s'encarregarà d'extreure aquests tags.  És útil per tags que poden contenir altres tags o estructures especials a dins, per tal que l'analitzador principal no es torni boig.  Aquesta funció rep un booleà que indica si el tag s'ha d'eliminar de la seqüència d'entrada o no.

note: type: textblock
en: This function receives the tag (in the get_string_until() format) and returns the translated tag (translated attributes or all needed transformations) as a single string.
ca: Aquesta funció rep el tag (en el format de get_string_until()) i retorna el tag traduït (amb els atributs traduïts o totes les transformacions necessàries) com una única cadena.

note: type: =head2
en: WORKING WITH TAGS
ca: TREBALLANT AMB TAGS

note: type: textblock
en: This function returns the path to the current tag from the document's root, in the form E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.
ca: Aquesta funció retorna el camí des de l'arrel del document fins al tag actual, de la forma E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.

note: type: textblock
en: This function returns the index from the tag_types list that fits to the next tag in the input stream, or -1 if it's at the end of the input file.
ca: Aquesta funció retorna l'índex de la llista tag_types que encaixa amb el següent tag de la seqüència d'entrada, o -1 si s'ha arribat al final del document d'entrada.

note: type: textblock
en: This function returns the next tag from the input stream without the beginning and end, in an array form, to maintain the references from the input file.  It has two parameters: the type of the tag (as returned by tag_type) and a boolean, that indicates if it should be removed from the input stream.
ca: Aquesta funció retorna el següent tag de la seqüència d'entrada sense el principi i el final, en forma de vector, per tal de mantenir les referències del fitxer d'entrada.  Té dos paràmetres: el tipus del tag (de la forma retornada per tag_type) i un booleà, que indica si s'ha d'eliminar de la seqüència d'entrada.

note: type: textblock
en: This function returns the name of the tag passed as an argument, in the array form returned by extract_tag.
ca: Aquesta funció retorna el nom del tag passar com a paràmetre, en la forma de vector retornat per extract_tag.

note: type: textblock
en: This function returns a boolean that says if the next tag in the input stream is a breaking tag or not (inline tag).  It leaves the input stream intact.
ca: Aquesta funció retorna un booleà que diu si el següent tag de la seqüència d'entrada és un tag trencador de seqüència o no (tag inline).  Deixa la seqüència d'entrada intacta.

note: type: textblock
en: This function translates the next tag from the input stream.  Using each tag type's custom translation functions.
ca: Aquesta funció tradueix el següent tag de la seqüència d'entrada.  Utilitza les funcions de traducció personalitzades de cada tipus de tag.

note: type: textblock
en: This function returns a string value that says if the first argument (a tag hierarchy) matches any of the tags from the second argument (a list of tags or tag hierarchies). If it doesn't match, it returns 0. Else, it returns the matched tag's options (the characters in front of the tag) or 1 (if that tag doesn't have options).
ca: Aquesta funció retorna una cadena que indica si el primer paràmetre (una jerarquia de tags) encaixa amb algun dels tags del segon paràmetre (una llista de tags o jerarquies de tags). Si no encaixa, retorna 0. En cas contrari, retorna les opcions del tag encaixat (els caràcters davant del tag) o 1 (si el tag no té opcions).

note: type: =head2
en: WORKING WITH ATTRIBUTES
ca: TREBALLANT AMB ATRIBUTS

note: type: =head2
en: WORKING WITH THE MODULE OPTIONS
ca: TREBALLANT AMB LES OPCIONS DELS MÒDULS

note: type: textblock
en: This function fills the internal structures that contain the tags, attributes and inline data with the options of the module (specified in the command-line or in the initialize function).
ca: Aquesta funció omple les estructures internes que contenen els tags, atributs i dades inline amb les opcions del mòdul (especificades a la línia de comandes o a la funció d'inicialització).

note: type: =head2
en: GETTING TEXT FROM THE INPUT DOCUMENT
ca: OBTENINT TEXT DEL DOCUMENT D'ENTRADA

note: type: textblock
en: This function returns an array with the lines (and references) from the input document until it finds the first argument.  The second argument is an options hash. Value 0 means disabled (the default) and 1, enabled.
ca: Aquesta funció retorna un vector amb les línies (i les referències) del document d'entrada fins que troba el primer paràmetre.  El segon paràmetre és un hash d'opcions. El valor 0 significa desactivat (per defecte) i 1, activat.

note: type: textblock
en: The valid options are:
ca: Les opcions vàlides són:

note: type: textblock
en: This makes the returned array to contain the searched text
ca: Fa que la cadena retornada contingui el text buscat

note: type: textblock
en: This removes the returned stream from the input
ca: Elimina de l'entrada la cadena retornada

note: type: textblock
en: This ensures that the searched text is outside any quotes
ca: Assegura que el text buscat no està envoltat de cometes

note: type: textblock
en: This function receives as argument the reference to a paragraph (in the format returned by get_string_until), skips his heading spaces and returns them as a simple string.
ca: Aquesta funció rep com a paràmetre la referència a un paràgraf (en el format retornat per get_string_until), se salta els espais del principi, i els retorna com una cadena simple.

note: type: textblock
en: This function returns a simple string with the text from the argument array (discarding the references).
ca: Aquesta funció retorna una cadena simple amb el text del vector de paràmetre (descartant les referències).

note: type: textblock
en: This module can translate tags and attributes.
ca: Aquest mòdul pot traduir tags i atributs.

note: type: textblock
en: DOCTYPE (ENTITIES)
ca: DOCTYPE (ENTITATS)

note: type: textblock
en: MODIFY TAG TYPES FROM INHERITED MODULES (move the tag_types structure inside the $self hash?)
ca: MODIFICAR ELS TIPUS DE TAGS DES DELS MÒDULS HEREDATS (moure l'estructura tag_types dins del hash $self?)
