Please sign in to see the alerts.

Overview

Project website po4a.org
Instructions for translators

https://github.com/mquinson/po4a/blob/master/CONTRIBUTING.md#translating Mailing list for translators: <<devel@lists.po4a.org>
Project maintainers User avatar JIBEC User avatar mquinson User avatar paususe
Translation license GNU General Public License v2.0 or later
Translation process
  • Translations can be made directly.
  • Translation suggestions can be made.
  • Any authenticated user can contribute.
  • The translation uses bilingual files.
Source code repository https://github.com/mquinson/po4a.git
Repository branch master
Last remote commit Merge branch 'master' of github.com:mquinson/po4a a1a79008
User avatar mquinson authored 4 days ago
Last commit in Weblate Translated using Weblate (Dutch) 703aa06a
User avatar frans.spiesschaert authored 8 hours ago
Weblate repository https://hosted.weblate.org/git/po4a/po4a/
File mask po/pod/*.po
8 hours ago

String statistics

Strings percent Hosted strings Words percent Hosted words Characters percent Hosted characters
Total 26,960 485,696 3,258,188
Source 1,436 25,904 173,438
Translated 70% 19,094 66% 321,078 66% 2,159,586
Needs editing 3% 897 5% 25,348 5% 180,515
Read-only 5% 1,526 5% 26,300 5% 178,316
Failing checks 3% 849 1% 6,815 2% 71,592
Strings with suggestions 1% 2 1% 140 1% 2,505
Untranslated strings 25% 6,969 28% 139,270 28% 918,087
Last 12 months Previous

Activity in last 12 months

82 changes 0 changes 0 changes 12 changes 852 changes 5 changes 2,165 changes 277 changes 55 changes 0 changes 384 changes 0 changes 45 changes 0 changes 706 changes 0 changes 86 changes 2,820 changes 56 changes 1,816 changes 23 changes 268 changes 27 changes 0 changes
May Jun Jul Aug Sep Oct Nov Dec Jan Feb Mar Apr

Quick numbers

485 k
Hosted words
26,960
Hosted strings
70%
Translated
4
Contributors
and previous 30 days

Trends of last 30 days

−1%
Hosted words
+100%
—
Hosted strings
+100%
−1%
Translated
+71%
−50%
Contributors
+100%
User avatar None

Changes committed

  1. po4a
  2. po4a-doc
  3. Dutch
Changes committed 8 hours ago
User avatar frans.spiesschaert

Translation added

  1. po4a
  2. po4a-doc
  3. Dutch
Contributing to po4a
Meewerken aan po4a
yesterday
User avatar frans.spiesschaert

Translation added

  1. po4a
  2. po4a-doc
  3. Dutch
The L<Locale::Po4a::Po(3pm)|Po> class is in charge of loading and using PO and POT files. Basically, you can read a file, add entries, get translations with the B<gettext()> method, write the PO into a file. More advanced features such as merging a PO file against a POT file or validating a file are delegated to B<msgmerge> and B<msgfmt> respectively.
De klasse L<Locale::Po4a::Po(3pm)|Po> is verantwoordelijk voor het laden en gebruiken van PO- en POT-bestanden. Kortom, u kunt een bestand lezen, vermeldingen toevoegen, vertalingen ophalen met de B<gettext()>-methode,en de PO naar een bestand schrijven. Meer geavanceerde functies, zoals het samenvoegen van een PO-bestand met een POT-bestand of het valideren van een bestand, worden respectievelijk aan B<msgmerge> en B<msgfmt> gedelegeerd.
yesterday
User avatar frans.spiesschaert

Translation added

  1. po4a
  2. po4a-doc
  3. Dutch
Po objects
Po-objecten
yesterday
User avatar frans.spiesschaert

Translation added

  1. po4a
  2. po4a-doc
  3. Dutch
One specific issue arises from file encodings and BOM markers. Simple parsers can forget about this issue, that is handled by C<TransTractor::read()> (used internally to get the lines of an input document), but the modules relying on an external parser must ensure that all files are read with an appropriate PerlIO decoding layer. The easiest is to open the file yourself, and provide an filehandle or directly the full string to your external parser. Check on C<Pod::read()> and C<Pod::parse()> for an example. The content read by the TransTractor is ignored, but a fresh filehandle is passed to the external parser. The important part is the C<< "<:encoding($charset)" >> mode that is passed to the B<open()> perl function.
Een specifiek probleem ontstaat door bestandscoderingen en BOM-markeringen. Eenvoudige ontleders kunnen dit probleem negeren omdat het wordt afgehandeld door C<TransTractor::read()> (intern gebruikt om de regels van een invoerdocument op te halen), maar de modules die afhankelijk zijn van een externe ontleder moeten ervoor zorgen dat alle bestanden worden gelezen met een geschikte PerlIO-decoderingslaag. Het eenvoudigste is om het bestand zelf te openen en een bestandsaanduiding of rechtstreeks de volledige tekenreeks mee te geven aan de externe ontleder. Kijk eens naar C<Pod::read()> en C<Pod::parse()> voor een voorbeeld. De inhoud die wordt gelezen door de TransTractor wordt genegeerd, maar een nieuwe bestandsaanduiding wordt doorgegeven aan de externe ontleder. Het belangrijke onderdeel is de modus C<< "<:encoding($charset)" >> die wordt doorgegeven aan de perl-functie B<open()>.
yesterday
User avatar frans.spiesschaert

Translation added

  1. po4a
  2. po4a-doc
  3. Dutch
Some other parsers are more complex because they rely on an external parser to analyze the input document. The Xml, HTML, SGML and Pod parsers are built on top of SAX parsers. They declare callbacks to events such as "I found a new title which content is the following" to update the output document and output POT files according to the input content using C<TransTractor::translate()> and C<TransTractor::pushline()>. The Yaml parser is similar but different: it serializes a data structure produced by the YAML::Tiny parser. This is why the Yaml module of po4a fails to declare the reference lines: the location of each string in the input file is not kept by the parser, so we can only provide "$filename:1" as a string location. The SAX-oriented parsers use globals and other tricks to save the file name and line numbers of references.
Sommige andere ontleders zijn complexer omdat ze afhankelijk zijn van een externe ontleder om het invoerdocument te analyseren. De Xml-, HTML-, SGML- en Pod-ontleders zijn gebouwd bovenop SAX-ontleders. Ze declareren terugroepfuncties naar gebeurtenissen zoals "Ik heb een nieuwe titel gevonden met de volgende inhoud" om het uitvoerdocument bij te werken en POT-bestanden uit te voeren op basis van de invoerinhoud met behulp van C<TransTractor::translate()> en C<TransTractor::pushline ()>. De Yaml-ontleder is vergelijkbaar maar anders: deze serialiseert een datastructuur geproduceerd door de ontleder YAML::Tiny. Dit is de reden waarom de Yaml-module van po4a de referentieregels niet kan declareren: de locatie van elke tekenreeks in het invoerbestand wordt niet bijgehouden door de ontleder en dus kunnen we alleen "$bestandsnaam:1" opgeven als de locatie van een tekenreeks. De SAX-georiënteerde ontleders gebruiken globale variabelen en andere trucs om de bestandsnaam en regelnummers van referenties op te slaan.
yesterday
User avatar frans.spiesschaert

Translation added

  1. po4a
  2. po4a-doc
  3. Dutch
All po4a format parsers are implemented on top of the TransTractor. Some of them are very simple, such as the Text, Markdown and AsciiDoc ones. They load the lines one by one using C<TransTractor::shiftline()>, accumulate the paragraphs' content or whatever. Once a string is completely parsed, the parser uses C<TransTractor::translate()> to (1) add this string to the output PO file and (2) get the translation from the input PO file. The parser then pushes the result to the output file using C<TransTractor::pushline()>.
Alle po4a-indelingsontleders zijn bovenop de TransTractor geïmplementeerd. Sommige zijn heel eenvoudig, zoals die van Text, Markdown en AsciiDoc. Ze laden de regels één voor één met behulp van C<TransTractor::shiftline()>, verzamelen de inhoud van de alinea's of wat dan ook. Zodra een tekenreeks volledig is ontleed, gebruikt de ontleder C<TransTractor::translate()> om (1) deze tekenreeks toe te voegen aan het uitvoer-PO-bestand en (2) de vertaling op te halen uit het invoer-PO-bestand. De ontleder duwt het resultaat vervolgens naar het uitvoerbestand met behulp van C<TransTractor::pushline()>.
yesterday
User avatar frans.spiesschaert

Translation added

  1. po4a
  2. po4a-doc
  3. Dutch
Format-specific parsers
Indelingsspecifieke ontleders
yesterday
User avatar frans.spiesschaert

Translation added

  1. po4a
  2. po4a-doc
  3. Dutch
B<po4a-gettextize> also uses two TransTractors, but another way: It builds one TransTractor per language, and then build a new PO file using the msgids of the original document as msgids, and the msgids of the translated document as msgstrs. Much care is needed to ensure that the strings matched this way actually match, as described in L<po4a-gettextize(1)>.
B<po4a-gettextize> gebruikt ook twee TransTractors, maar op een andere manier: het bouwt één TransTractor per taal en bouwt vervolgens een nieuw PO-bestand met de msgid's van het originele document als msgid's, en de msgid's van het vertaalde document als msgstr's. Er is veel zorg nodig om te verzekeren dat de tekenreeksen waartussen op deze manier een overeenkomst gevonden wordt ook daadwerkelijk overeenkomen, zoals beschreven in L<po4a-gettextize(1)>.
yesterday
User avatar frans.spiesschaert

Translation changed

  1. po4a
  2. po4a-doc
  3. Dutch
This little bone is the core of all the po4a architecture. If you provide both input and disregard the output PO, you get B<po4a-translate>. If you disregard the output document instead, you get B<po4a-updatepo>. The B<po4a> uses a first TransTractor to get an up-to-date output POT file (disregarding the output documents), calls B<msgmerge -U> to update the translation PO files on disk, and builds a second TransTractor with these updated PO files to update the output documents. In short, B<po4a> provides one-stop solution to update what needs to be, using a single configuration file.
Dit kleine botje vormt de kern van de hele po4a-architectuur. Indien u de invoer-PO en het uitvoerdocument weglaat, krijgt u B<po4a-gettextize>. Indien u de beide invoerdocumenten geeft en de uitvoer-POAls u zowel invoer verstrekt als de uitvoer-PO negeert, krijgt u B<po4a-translate>. Als u in plaats daarvan het uitvoerdocument negeert, krijgt u B<po4a-translupdatepo>. De B<po4a> aanroept tweemaalHet programma B<po4a> gebruikt een eerste TransTractor om een aanroept B<msgmerge -U> tussen deze aanroepen van TransTractor in, om een totaaloplossing te biectueel uitvoer-POT-bestand te verkrijgen (waarbij de uitvoerdocumenten buiten beschouwing worden gelaten), roept B<msgmerge -U> aan om de vertaal-PO-bestanden op schijf bij te werken en bouwt een tweede TransTractor met deze bijgewerkte PO-bestanden om de uitvoerdocumenten bij te werken. Kortom, B<po4a> biedt een totaaloplossing om bij te werken wat bijgewerkt moet worden, met één configuratiebestand. Raadpleeg L<Locale::Po4a::TransTractor(3pm)> voor meer detailsbehulp van één enkel configuratiebestand.
yesterday
Browse all component changes