
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NAAM

po4a - in één bewerking PO-bestanden en vertaalde documenten bijwerken

=head1 OVERZICHT

B<po4a> [I<opties>] I<configuratie_bestand>

=head1 BESCHRIJVING

po4a (PO for anything - Po voor alles) vergemakkelijkt het onderhoud van de
vertaling van documentatie met het klassieke gettext-gereedschap. Het
belangrijkste kenmerk van po4a is, dat het de vertaling van inhoud
loskoppelt van de structuur van het document.  Raadpleeg pagina L<po4a(7)>
voor een welwillende introductie in dit project.

Bij uitvoering verwerkt B<po4a> alle documentatiebestanden die in zijn
configuratiebestand zijn opgegeven. Het werkt de PO-bestanden (die de
vertaling bevatten) bij om elke wijziging in de documentatie weer te geven,
en produceert een vertaalde documentatie door de vertaling van de inhoud (te
vinden in de PO-bestanden) in te voeren in de structuur van het originele
hoofddocument.

Aanvankelijk bevatten de PO-bestanden alleen de te vertalen tekenreeksen uit
de oorspronkelijke documentatie. Dit bestandsformaat stelt de vertalers in
staat om handmatig een vertaling te leveren voor elke paragraaf die door
B<po4a> is geëxtraheerd. Als de documentatie na de vertaling wordt
gewijzigd, markeert B<po4a> de overeenkomstige vertalingen als "fuzzy"
(vaag) in het PO-bestand om een handmatige controle door de vertalers aan te
vragen. De vertalers kunnen ook een zogenaamd "addendum" leveren. Dat is
extra inhoud waarin bijvoorbeeld staat wie de vertaling heeft gemaakt en hoe
fouten kunnen worden gemeld.

 master documents ---+---->-------->---------+
  (doc authoring)    |                       |
                     V   (po4a executions)   >-----+--> translated
                     |                       |     |     documents
 existing PO files -->--> updated PO files >-+     |
      ^                            |               |
      |                            V               |
      +----------<---------<-------+               ^
       (manual translation process)                |
                                                   |
 addendum -->--------------------------------------+

De werkstroom van B<po4a> is asynchroon, zoals past bij
open-bronprojecten. De documentatieschrijvers schrijven de hoofddocumenten
in hun eigen tempo. De vertalers controleren de vertalingen in de
PO-bestanden en werken deze bij. De beheerders voeren indien nodig B<po4a>
opnieuw uit, om elke verandering in de originele documentatie in de
PO-bestanden weer te geven, en om bijgewerkte documentatievertalingen te
produceren, door de recentste vertaling in de recentste documentstructuur in
te voeren.

Standaard wordt een bepaald vertaald document geproduceerd wanneer ten
minste 80% van de inhoud ervan is vertaald. De onvertaalde tekst blijft in
de oorspronkelijke taal staan. De geproduceerde documentatie vermengt dus
talen als de vertaling niet volledig is. U kunt de drempel van 80% wijzigen
met de hieronder beschreven optie I<--keep>. Merk echter op dat het
verwijderen van vertalingen zodra ze niet 100% zijn, ontmoedigend kan werken
voor vertalers, omdat gebruikers hun werk bijna nooit te zien zullen
krijgen, terwijl het aanbieden van "vertalingen" die te onvolledig zijn,
problematisch kan zijn voor de eindgebruiker.

De vertaalde documentatiebestanden opslaan in het versiebeheersysteem is
waarschijnlijk geen goed idee, omdat ze automatisch worden gegenereerd. De
waardevolle bestanden zijn de PO-bestanden, die het harde werk van uw
collega-vertalers bevatten. Ook vinden sommige mensen het gemakkelijker om
met de vertalers te communiceren via een online platform zoals S<weblate>,
maar dit is natuurlijk volledig optioneel.

=head2 Snel aan de slag - Beknopte handleiding

Laten we aannemen dat u een programma onderhoudt met de naam B<foo> dat een
manpagina F<man/foo.1> heeft, geschreven in het Engels (de werktaal in de
meeste open-bronprojecten, maar B<po4a> kan van of naar elke taal gebruikt
worden). Enige tijd geleden zorgde iemand voor een Duitse vertaling genaamd
F<man/foo.de.1> en verdween. Dit is een probleem omdat u net een bugrapport
hebt gekregen waarin staat dat uw documentatie ernstig misleidende
informatie bevat die in alle talen moet worden verbeterd, maar u spreekt
geen Duits, dus u kunt alleen het origineel aanpassen, niet de vertaling. Nu
wil een andere medewerker ook een bijdrage leveren met een vertaling naar
het Japans, een taal die u evenmin beheerst.

Dan is het tijd om uw documentatie om te zetten naar B<po4a> om uw
nachtmerries over documentatieonderhoud op te lossen. U wilt de documentatie
bijwerken wanneer dat nodig is, u wilt het werk van uw collega-vertalers
verlichten, en u wilt ervoor zorgen dat uw gebruikers nooit verouderde en
dus misleidende documentatie te zien krijgen.

Deze omzetting omvat twee stappen: het opzetten van de po4a-infrastructuur
en het converteren van de vorige Duitse vertaling om het eerdere werk te
redden. Dit laatste deel wordt als volgt gedaan met
S<po4a-gettextize>. Zoals beschreven in de documentatie van
L<po4a-gettextize(1)>, is dit proces zelden volledig automatisch, maar als
het eenmaal is voltooid, kan het B<de.po>-bestand met de Duitse vertaling
worden geïntegreerd in uw po4a-werkstroom.

  po4a-gettextize --format man --master foo.1 --localized foo.de.1 --po de.po

Laten we nu po4a configureren. Met de juiste bestandsopmaak zou uw
configuratiebestand zo eenvoudig als dit kunnen zijn:

 [po_directory] man/po4a/

 [type: man] man/foo.1 $lang:man/translated/foo.$lang.1

Het geeft aan dat alle PO-bestanden (die het werk van de vertalers bevatten)
in de map F<man/po4a/> staan, en dat u slechts één hoofdbestand hebt,
F<man/foo.1>. Als u meerdere hoofdbestanden had, dan zou u verschillende
regels hebben die lijken op de tweede. Elk van die regels geeft ook aan waar
de corresponderende vertaalbestanden moeten worden geschreven. Hier staat de
Duitse vertaling van F<man/foo.1> in F<man/vertaald/foo.de.1>.

Het laatste dat we nodig hebben om de configuratie van B<po4a> te voltooien,
is een POT-bestand met het sjabloonmateriaal dat moet worden gebruikt om een
nieuwe vertaling te starten. Maak gewoon een leeg bestand met de extensie
S<.pot> in de opgegeven S<po_directory> (bijv. F<man/po4a/foo.pot>), en
B<po4a> vult het met de verwachte inhoud.

Hier volgt een overzicht van de bestanden in deze opstelling:

  ├── man/
  │   ├── foo.1        <- The original man page, in English
  │   ├── po4a/
  │   │   ├── de.po    <- The German PO translation, from gettextization
  │   │   └── foo.pot  <- The POT template of future translations (empty at first)
  │   └── translated/  <- Directory where the translations will be created
  └── po4a.cfg         <- The configuration file

Eenmaal ingesteld, zal het uitvoeren van B<po4a> uw documentatie ontleden,
het POT-sjabloonbestand bijwerken, het gebruiken om de PO-vertaalbestanden
bij te werken, en deze gebruiken om de documentatievertaalbestanden bij te
werken. Alles in één commando:

        po4a --verbose po4a.cfg

Dit is het. B<po4a> is nu volledig geconfigureerd. Zodra u uw fout in
F<man/foo.1> hebt hersteld, zal de gewraakte paragraaf in de Duitse
vertaling worden vervangen door de gecorrigeerde tekst in het Engels. Het
mengen van talen is niet optimaal, maar het is de enige manier om fouten in
vertalingen die u niet eens begrijpt te verwijderen en ervoor te zorgen dat
de aan de gebruikers gepresenteerde inhoud nooit misleidend is. Het
bijwerken van de Duitse vertaling is ook veel gemakkelijker in het
overeenkomstige PO-bestand, zodat de taalvermenging mogelijk niet lang zal
duren. Tenslotte, als een Japanse vertaler wil bijdragen met een nieuwe
vertaling, moet deze de naam S<foo.pot> hernoemen naar S<ja.po> en de
vertaling voltooien. Eens u dat bestand gekregen heeft, plaatst u het gewoon
in F<man/po4a/po/>. Wanneer u B<po4a> opnieuw uitvoert, zal een vertaalde
pagina tevoorschijn komen als F<man/translated/foo.jp.1> (op voorwaarde dat
er voldoende inhoud is vertaald).

=head1 OPTIES

=over 4

=item B<-k>, B<--keep>

Minimale drempelwaarde, uitgedrukt in vertaald percentage, om het
resulterende bestand te behouden (d.w.z. neer te schrijven) (standaard:
80). D.w.z. dat bestanden standaard minstens 80% vertaald moeten zijn om
naar schijf geschreven te worden.

=item B<-w>, B<--width>

Kolom waarop we regelafbreking in het resulterende bestand moeten toepassen
als het formaat dit ondersteunt (standaard: 76). Als de opgegeven waarde 0
of negatief is, zal er helemaal geen regelafbreking toegepast worden op het
resulterende bestand. Dit is nuttig voor sommige formaten die bij het
opnieuw uitvoeren van regelafbreking fouten kunnen vertonen.

=item B<-h>, B<--help>

Een korte hulptekst tonen.

=item B<-M>, B<--master-charset>

Tekenset van de bestanden met de te vertalen documenten. Merk op dat alle
hoofddocumenten dezelfde tekenset moeten gebruiken.

=item B<-L>, B<--localized-charset>

Tekenset van de bestanden met de gelokaliseerde documenten. Merk op dat voor
alle vertaalde documenten dezelfde tekenset gebruikt zal worden.

=item B<-A>, B<--addendum-charset>

Tekenset van de addenda. Merk op dat alle addenda dezelfde tekenset moeten
hebben.

=item B<-V>, B<--version>

De versie van het script tonen en afsluiten.

=item B<-v>, B<--verbose>

De breedsprakigheid van het programma verhogen.

=item B<-q>, B<--quiet>

De breedsprakigheid van het programma verminderen.

=item B<-d>, B<--debug>

Enige foutopsporingsinformatie weergeven.

=item B<-o>, B<--option>

Extra optie(s) om door te geven aan de indelingsplug-in. Raadpleeg de
documentatie bij elke plug-in voor meer informatie over de geldige opties en
hun betekenis. U zou bijvoorbeeld '-o tablecells' kunnen doorgeven aan de
ontleder voor AsciiDoc, terwijl de ontleder voor tekst '-o tabs=split' zou
accepteren.

=item B<-f>, B<--force>

Steeds de POT- en PO-bestanden genereren, zelfs indien B<po4a> dit niet
nodig acht.

Het standaardgedrag (indien B<--force> niet opgegeven werd) is als volgt:

=over

Indien het POT-bestand reeds bestaat, wordt het opnieuw gegenereerd indien
een hoofddocument of het configuratiebestand recenter is (tenzij
B<--no-update>  opgegeven werd). Het POT-bestand wordt ook in een tijdelijk
document weggeschreven en B<po4a> gaat na of de wijzigingen echt nodig zijn.

Ook wordt een vertaling enkel opnieuw gegenereerd indien zijn hoofddocument,
het PO-bestand, één van zijn addenda of het configuratiebestand recenter
is. Om te vermijden dat geprobeerd wordt vertalingen opnieuw te genereren
die niet slagen in de drempelwaardetest (zie B<--keep>), kan een bestand met
de extensie F<.po4a-stamp> gecreëerd worden (zie B<--stamp>).

=back

Als in een hoofddocument externe bestanden geïntegreerd worden, moet u de
vlag B<--force> gebruiken, omdat geen rekening gehouden wordt met de
wijzigingsdatum van deze ingesloten bestanden.

De PO-bestanden worden steeds opnieuw gegenereerd op basis van het
POT-bestand met B<msgmerge -U>.

=item B<--stamp>

Geeft aan dat B<po4a> een stempelbestand moet genereren indien er geen
vertaling gegenereerd wordt omdat deze de drempelwaarde niet bereikt. Dit
stempelbestand wordt vernoemd naar het verwachte vertaalde document met de
extensie F<.po4a-stamp>.

Opmerking: Dit activeert enkel het creëren van de
F<.po4a-stamp>-bestanden. Als deze bestaan, worden de stempelbestanden
steeds gebruikt, en zij worden verwijderd met B<--rm-translations> of
wanneer het bestand uiteindelijk vertaald is.

=item B<--no-translations>

De vertaalde documenten niet genereren, enkel de POT- en PO-bestanden
bijwerken.

=item B<--no-update>

De POT- en PO-bestanden niet wijzigen, enkel de vertaling mag bijgewerkt
worden.

=item B<--keep-translations>

Behoudt de bestaande vertaalbestanden, zelfs indien de vertaling niet
beantwoordt aan de drempelwaarde die door  B<--keep> gespecificeerd
wordt. Met deze optie worden geen nieuwe vertaalbestanden met weinig inhoud
gecreëerd, maar bestaande vertalingen die verkommeren door wijzigingen aan
de hoofdbestanden, blijven bewaard.

WAARSCHUWING: Met deze vlag wordt het gedrag van po4a op een eerder
drastische wijze veranderd: uw vertaalde bestanden zullen helemaal niet
bijgewerkt worden totdat de vertaling verbetert. Gebruik deze vlag enkel
indien u verkiest om een verouderde vertaalde documentatie te verspreiden
boven een accurate onvertaalde documentatie.

=item B<--rm-translations>

De vertaalde bestanden verwijderen (impliceert B<--no-translations>).

=item B<--no-backups>

Deze vlag heeft sinds versie 0.41 geen effect meer, en ze kan uit latere
releases verwijderd worden.

=item B<--rm-backups>

Deze vlag heeft sinds versie 0.41 geen effect meer, en ze kan uit latere
releases verwijderd worden.

=item B<--translate-only> I<vertaald-bestand>

Enkel het gespecificeerde bestand vertalen. Dit kan nuttig zijn om de
verwerking te versnellen als een configuratiebestand veel bestanden
bevat. Merk op dat met deze optie PO- en POT-bestanden niet bijgewerkt
worden. Deze optie kan meerdere keren gebruikt worden.

=item B<--variable> I<var>B<=>I<waarde>

Een variabele definiëren welke in het configuratiebestand van B<po4a>
vervangen zal worden. Overal waar I<$(var)> voorkomt, zal deze vervangen
worden door  I<waarde>. Deze optie kan meerdere malen gebruikt worden.

=item B<--target-lang> I<TAAL>

Enkel voor de opgegeven taal PO-bestanden bijwerken en vertaalde documenten
genereren. Deze optie kan meerdere keren worden gebruikt.

=item B<--srcdir> I<BRONMAP>

De basismap instellen van alle invoerdocumenten welke in het
configuratiebestand van B<po4a> gespecificeerd worden.

Indien zowel I<destdir> als I<srcdir> vermeld zijn, worden invoerbestanden
in de volgende mappen gezocht in deze volgorde: I<destdir>, de huidige map
en I<srcdir>. Uitvoerbestanden worden weggeschreven in I<destdir> als deze
gespecificeerd is, of in de huidige map.

=item B<--destdir> I<DOELMAP>

De basismap instellen voor al de uitvoerdocumenten, welke in het
configuratiebestand van B<po4a> gespecificeerd zijn (zie B<--srcdir>
hierboven).

=back

=head2 Opties die de POT-header wijzigen

=over 4

=item B<--porefs> I<type>

Het referentieformaat specificeren. Het argument I<type> kan één van de
volgende zijn: B<never> om geen enkele referentie te produceren, B<file> om
enkel het bestand zonder het lijnnummer te specificeren, B<counter> om het
regelnummer te vervangen door een oplopende teller, en B<full> om volledige
referenties op te nemen (standaard: full).

=item B<--wrap-po> B<no>|B<newlines>|I<getal> (standaard: 76)

Specificeren hoe de regelafbreking voor po-bestanden er moet uitzien. Dit
geeft de keuze tussen bestanden met een mooie regelafbreking, die echter
kunnen leiden tot git-conflicten en bestanden die makkelijker automatisch te
behandelen zijn, maar voor mensen moeilijker leesbaar.

Vanouds brak de gettext-suite uit cosmetische overwegingen de regels van
po-bestanden af bij de 77e kolom. Deze optie specificeert het gedrag van
po4a. Indien dit ingesteld wordt op een numerieke waarde, zal po4a de regels
van het po-bestand afbreken na deze kolom en na regeleinden die in de inhoud
voorkomen. Indien dit ingesteld wordt op B<newlines>, zal po4a  de msgid en
msgstr enkel afbreken na regeleinden die in de inhoud voorkomen. Indien dit
ingesteld wordt op B<no>, zal po4a helemaal geen regelafbreking toepassen in
het po-bestand. De regelafbreking in het referentiecommentaar gebeurt steeds
door het gettext-gereedschap dat we intern gebruiken.

Merk op dat deze optie geen impact heeft op de wijze waarop regelafbreking
in msgid en msgstr gebeurt, d.w.z. op hoe einderegels toegevoegd worden aan
de inhoud van deze tekstfragmenten.

=item B<--master-language>

Taal van de bronbestanden die de te vertalen documenten bevatten. Merk op
dat alle hoofddocumenten dezelfde taal moeten gebruiken.

=item B<--msgid-bugs-address> I<email@adres>

Het adres instellen voor het rapporteren van msgid-bugs. Standaard bevatten
de gecreëerde POT-bestanden niet het veld Report-Msgid-Bugs-To.

=item B<--copyright-holder> I<tekenreeks>

Instellen van de copyrighthouder in de POT-header. De standaardwaarde is
"Free Software Foundation, Inc."

=item B<--package-name> I<tekenreeks>

Instellen van de pakketnaam voor de POT-header. Standaard is dat "PACKAGE".

=item B<--package-version> I<tekenreeks>

Instellen van de pakketversie voor de POT-header. Standaard is dat
"VERSION".

=back

=head2 Opties om de PO-bestanden te wijzigen

=over 4

=item B<--msgmerge-opt> I<opties>

Extra opties voor B<msgmerge>(1).

Opmerking: B<$lang> zal vervangen worden door de huidige taal.

=item B<--no-previous>

Deze optie verwijdert B<--previous> uit de opties die doorgegeven worden aan
B<msgmerge>.  Dit is nodig om versies van B<gettext> te ondersteunen, eerder
dan 0.16.

=item B<--previous>

Met deze optie voegt men B<--previous> toe aan de opties die aan B<msgmerge>
doorgegeven worden. De optie heeft versie 0.16 of recenter van B<gettext>
nodig en is standaard geactiveerd.

=back

=head1 CONFIGURATIEBESTAND

po4a verwacht een configuratiebestand als argument. Dit bestand moet de
volgende elementen bevatten:

=over

=item

Het pad naar de PO-bestanden en de lijst van talen die in het project
bestaan;

=item

Facultatief, een aantal globale opties en zogenaamde configuratiealiassen
welke als sjablonen gebruikt worden om individuele hoofdbestanden te
configureren;

=item

De lijst van elk masterbestand dat moet worden vertaald, samen met
specifieke parameters.

=back

Alle regels bevatten een commando tussen rechte haakjes, gevolgd door zijn
parameters. Commentaar begint met het teken '#' en loopt verder tot het
einde van de regel. U kunt met een escapeteken aan het einde van de regel
het commando spreiden over verschillende regels.

Op deze pagina worden enkele volledig uitgewerkte voorbeelden gegeven,
terwijl andere voorbeelden te vinden zijn in de map C<t/cfg> van de
brondistributie.

=head2 De PO- en POT-bestanden vinden

De eenvoudigste manier is om als volgt expliciet het pad op te geven naar
het POT-bestand en de PO-bestanden:

 [po4a_paths] man/po/project.pot de:man/po/de.po fr:man/po/fr.po

Dit specificeert eerst het pad naar het POT-bestand, en daarna de paden naar
de Nederlandse en Franse PO-bestanden.

Dezelfde informatie kan als volgt geschreven worden om het risico op
kopiëren/plakken-fouten te verkleinen:

 [po4a_langs] fr de
 [po4a_paths] man/po/project.pot $lang:man/po/$lang.po

De component C<$lang> wordt automatisch vervangen door gebruik te maken van
de opgegeven taallijst. Dit beperkt het risico op een fout van het type
kopiëren/plakken wanneer een nieuwe taal toegevoegd wordt.

U kunt dezelfde informatie nog compacter maken door als volgt enkel het pad
op te geven naar de map die uw vertaalproject bevat.

 [po_directory] man/po/

De opgegeven map moet een aantal PO-bestanden bevatten, elk met een naam
F<XX.po>, waarbij C<XX> de ISO 639-1-code is van de taal die in dit bestand
wordt gebruikt. De map moet ook één enkel POT-bestand bevatten, met als
bestandsextensie C<.pot>. Voor de eerste doorloop mag dit bestand leeg zijn,
maar het moet wel bestaan (po4a kan de naam die voor de extensie moet worden
gebruikt, niet raden).

Merk op dat u enkel een van beide moet kiezen: C<po_directory> of
C<po4a_paths>. Het eerste (C<po_directory>) is compacter en vermindert nog
meer het risico op kopiëren/plakken-fouten, maar dwingt u de verwachte
projectstructuur en bestandsnamen te gebruiken. Het tweede (C<po4a_paths>)
is explicieter en wellicht makkelijker leesbaar en wordt aanbevolen als u uw
eerste project opzet met po4a.

=head3 Centrale of gesplitste PO-bestanden?

Standaard produceert po4a één enkel PO-bestand per doeltaal. Dit bevat de
volledige inhoud van uw vertaalproject. Als uw project uitgebreider wordt,
kan de omvang van deze bestanden problematisch worden. Indien weblate
gebruikt wordt , is het mogelijk specifieke prioriteiten op te geven voor
elk vertalingssegment (d.w.z. msgid), zodat de belangrijkste eerst vertaald
worden. Nochtans geven sommige vertaalteams er de voorkeur aan de inhoud op
te splitsen in verschillende bestanden.

Om één PO-bestand per hoofdbestand te hebben, moet u gewoon op de volgende
manier de tekenreeks C<$master> gebruiken in de naam van uw PO-bestanden op
de regel C<[po4a_paths]>.

 [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po

Met deze regel zal po4a afzonderlijke POT- en PO-bestanden produceren voor
elk te vertalen document. Bijvoorbeeld, als u 3 documenten en 5 talen heeft,
zal dit resulteren in 3 POT-bestanden en 15 PO-bestanden. Deze bestanden
worden genoemd zoals in het sjabloon C<po4a_paths> gespecificeerd werd,
waarbij C<$master> vervangen wordt door de basisnaam van elk te vertalen
document. In geval van een naamconflict kunt u het te gebruiken POT-bestand
als volgt specificeren met de parameter C<pot=>.

Deze functionaliteit kan ook worden gebruikt om meerdere vertaalde bestanden
te groeperen in hetzelfde POT-bestand. Het volgende voorbeeld levert slechts
2 POT-bestanden op: F<l10n/po/foo.pot> (met het materiaal van
F<foo/gui.xml>) en F<l10n/po/bar.pot> (met het materiaal van zowel
F<bar/gui.xml> als F<bar/cli.xml>).

 [po4a_langs] de fr ja
 [po4a_paths] l10n/po/$master.pot $lang:l10n/po/$master.$lang.po
 [type: xml] foo/gui.xml $lang:foo/gui.$lang.xml pot=foo
 [type: xml] bar/gui.xml $lang:bar/gui.$lang.xml pot=bar
 [type: xml] bar/cli.xml $lang:bar/cli.$lang.xml pot=bar

In gesplitste modus bouwt B<po4a> een tijdelijk compendium op tijdens het
bijwerken van de PO-bestanden, om de vertaling met alle PO-bestanden te
delen. Indien twee PO-bestanden voor hetzelfde tekstfragment verschillende
vertalingen bevatten, zal B<po4a> dit tekstfragment als onnauwkeurig (fuzzy)
markeren en beide vertalingen invoegen in alle PO-bestanden die dat
tekstfragment bevatten. Wanneer de vertaler de vertaling ontwart, zal deze
vertaling automatisch is elk PO-bestand gebruikt worden.

=head2 De te vertalen documenten specificeren

U moet ook de documenten die vertaald moeten worden, vermelden. Voor elk
hoofdbestand moet u de te gebruiken indelingsontleder opgeven, de locatie
van het te produceren vertaalde bestand en facultatief enige
configuratie. Bestandsnamen moeten tussen aanhalingstekens worden geplaatst
als ze spaties bevatten, ofwel moeten deze gemaskeerd worden met een
escape-teken. Hier volgt een voorbeeld:

 [type: sgml] "doc/my stuff.sgml"  "fr:doc/fr/mon truc.sgml"  de:doc/de/mein\ kram.sgml
 [type: man] script fr:doc/fr/script.1 de:doc/de/script.1
 [type: docbook] doc/script.xml fr:doc/fr/script.xml \
             de:doc/de/script.xml

Maar ook hier zijn deze complexe regels moeilijk te lezen en aan te passen,
bijvoorbeeld bij het toevoegen van een nieuwe taal. Het is veel eenvoudiger
om deze zaken als volgt te herorganiseren met behulp van het
C<$lang>-sjabloon:

 [type: sgml]    doc/my_stuff.sgml $lang:doc/$lang/my_stuff.sgml
 [type: man]     script.1          $lang:po/$lang/script.1
 [type: docbook] doc/script.xml    $lang:doc/$lang/script.xml

=head2 Opties specificeren

Er bestaan twee types opties: I<po4a-opties> zijn standaardwaarden voor de
po4a commandoregelopties, terwijl I<opmaakopties> gebruikt worden om het
gedrag van de opmaakontleders te beïnvloeden. U zou bijvoorbeeld in uw
configuratiebestand kunnen specificeren dat de standaardwaarde voor de
commandoregelparameter B<--keep> 50% is in plaats van 80%. I<Opmaakopties>
worden gedocumenteerd op de specifieke pagina van iedere ontleedmodule,
bijv. L<Locale::Po4a::Xml(3pm)>. U zou bijvoorbeeld B<nostrip> kunnen
meegeven aan de XML-ontleder om de spaties rond de geëxtraheerde
tekstfragmenten niet te laten weghalen.

U kunt deze opties meegeven voor een specifiek hoofdbestand, of zelfs voor
een specifieke vertaling van dat bestand met C<opt:> of met C<opt_XX:> voor
de taal C<XX>. In het volgende voorbeeld wordt de optie B<nostrip>
meegegeven aan de XML-ontleder (voor alle talen), terwijl de drempelwaarde
tot 0% teruggebracht wordt voor de Franse vertaling (welke dus steeds
behouden blijft).

 [type:xml] toto.xml $lang:toto.$lang.xml opt:"-o nostrip" opt_fr:"--keep 0"

Deze configuratieonderdelen moeten in ieder geval aan het einde van de regel
staan. Eerst moet de declaratie van bestanden komen, dan het eventuele
addendum (zie hierna) en dan pas de opties. Het groeperen van
configuratieonderdelen is niet erg belangrijk, omdat elementen intern
samengevoegd worden tot tekenreeksen. De volgende voorbeelden zijn allemaal
gelijkwaardig:

  [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20" opt:"-o nostrip" opt_fr:"--keep 0"
  [type:xml] toto.xml $lang:toto.$lang.xml opt:"--keep 20 -o nostrip" opt_fr:"--keep 0"
  [type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_fr:--keep opt_fr:0

Merk op dat taalspecifieke opties niet gebruikt worden bij het bouwen van
het POT-bestand. Het is bijvoorbeeld niet mogelijk om de optie B<nostrip>
mee te geven aan de ontleder wanneer enkel de Franse vertaling wordt
gebouwd, omdat het POT-bestand gebruikt wordt om elke taal te updaten. Dus
zijn de enige opties die taalspecifiek kunnen zijn, die opties welke
gebruikt worden bij het produceren van de vertaling, zoals de optie
C<--keep>.

=head3 Configuratiealiassen

De beste manier om dezelfde optie mee te geven aan verschillende bestanden
is als volgt een alias voor een type te definiëren. In het volgende
voorbeeld wordt de optie C<--keep 0> aan iedere Italiaanse vertaling
meegegeven met dit C<test>-type, welke een uitbreiding is van het
C<man>-type.

  [po4a_alias:test] man opt_it:"--keep 0"
  [type: test] man/page.1 $lang:man/$lang/page.1

U kunt een bestaand type ook uitbreiden door als volgt dezelfde naam te
gebruiken voor de alias. Dit wordt niet geïnterpreteerd als een foutieve
recursieve definitie.

  [po4a_alias:man] man opt_it:"--keep 0"
  [type: man] man/page.1 $lang:man/$lang/page.1

=head3 Globale standaardopties

U kunt ook C<[options]>-regels gebruiken om opties te definiëren welke voor
alle bestanden gebruikt moeten worden, ongeacht hun type.

  [options] --keep 20 --option nostrip

Zoals het geval is voor de commandoregelopties, kunt u de parameters die in
het configuratiebestand meegegeven worden, afkorten:

  [options] -k 20 -o nostrip

=head3 Optieprioriteiten

De opties voor alle bronnen worden samengevoegd, zodat de standaardwaarden
gemakkelijk kunnen worden overschreven door meer specifieke opties. De
volgorde is de volgende:

=over

=item

C<[options]>-regels bieden standaardwaarden die door elke andere bron
overschreven kunnen worden.

=item

Daarna worden aliassen voor types gebruikt. Taalspecifieke instellingen
overschrijven die welke van toepassing zijn op alle talen.

=item

Instellingen welke specifiek zijn voor een bepaald hoofdbestand
overschrijven zowel de standaardinstellingen als die welke afkomstig zijn
van de type-alias. Ook in dit geval overschrijven taalspecifieke
instellingen de globale instellingen.

=item

Tenslotte overschrijven parameters welke opgegeven worden aan de
B<po4a>-commandoregel, eventuele instellingen uit het configuratiebestand.

=back

=head3 Voorbeeld

Hier volgt een voorbeeld dat laat zien hoe u de spaties en aanhalingstekens
moet citeren:

 [po_directory] man/po/
 
 [options] --master-charset UTF-8
 
 [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\""
 [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
            opt:"-k 75" opt_it:"-L UTF-8" opt_fr:--verbose

=head2 Addendum: extra inhoud toevoegen aan de vertaling

Indien u aan de vertaling een extra sectie wilt toevoegen, bijvoorbeeld om
erkenning te geven aan de vertaler, moet u een addendum definiëren bij de
regel welke uw hoofdbestand definieert, Raadpleeg pagina L<po4a(7)> voor
meer informatie over de syntaxis van addendumbestanden.

 [type: pod] script fr:doc/fr/script.1 \
             add_fr:doc/l10n/script.fr.add

U kunt ook als volgt gebruik maken van taalsjablonen:

 [type: pod] script $lang:doc/$lang/script.1 \
             add_$lang:doc/l10n/script.$lang.add

Indien het toepassen van een addendum mislukt, wordt de vertaling
verwijderd.

=head3 Wijzigingselementen voor de addendumdeclaratie

Met addendumwijzigingselementen kan het configuratiebestand vereenvoudigd
worden in het geval er niet voor elke taal een addendum is, of wanneer de
lijst met addenda verschilt naargelang de taal. Het wijzigingselement is één
enkele letter die voor de bestandsnaam staat.

=over 2

=item B<?>

I<pad_naar_addendum> toevoegen indien dit bestand bestaat; in het ander
geval niets doen.

=item B<@>

I<pad_naar_addendum> is geen gewoon addendum, maar een bestand dat een lijst
met addenda bevat, één per regel. Elk addendum kan voorafgegaan worden door
wijzigingselementen.

=item B<!>

I<pad_naar_addendum> wordt weggelaten; het wordt niet geladen en zal niet
geladen worden bij eventuele verdere addendumspecificaties.

=back

Met het volgende wordt voor elke taal een addendum toegevoegd, maar enkel
indien het bestaat. Er wordt geen fout gerapporteerd indien het addendum
niet bestaat.

 [type: pod] script $lang:doc/$lang/script.1  add_$lang:?doc/l10n/script.$lang.add

Met het volgende wordt een lijst met addenda toegevoegd voor elke taal:

 [type: pod] script $lang:doc/$lang/script.1  add_$lang:@doc/l10n/script.$lang.add

=head2 De vertaalde tekstfragmenten filteren

Soms wilt u bepaalde tekstfragmenten voor het vertaalproces verborgen
houden. Met dit doel kunt u een C<pot_in>-parameter opgeven aan uw
hoofdbestand om de naam op te geven van het bij het bouwen van het
POT-bestand te gebruiken bestand in plaats van het echte hoofdbestand. Hier
volgt een voorbeeld:

  [type:docbook] book.xml          \
          pot_in:book-filtered.xml \
          $lang:book.$lang.xml

Met deze instelling zullen de te vertalen tekstfragmenten geëxtraheerd
worden uit het bestand F<boek-gefilterd.xml> (dat aangemaakt moet worden
vooraleer B<po4a> aangeroepen wordt), terwijl de vertaalde bestanden gebouwd
worden vanuit F<boek.xml>. Als gevolg daarvan zullen alle tekstfragmenten
welke in F<boek.xml> voorkomen maar niet in F<boek-gefilterd.xml>, niet
opgenomen worden in de PO-bestanden, waardoor voorkomen wordt dat vertalers
er een vertaling voor geven. Deze tekstfragmenten zullen dus ongewijzigd
blijven bij het aanmaken van de vertaalde documenten. Dit verlaagt
natuurlijk de graad van vertaling, waardoor u mogelijk de optie C<--keep>
zult moeten aanpassen om ervoor te zorgen dat het document desondanks
aangemaakt wordt.

=head1 ZIE OOK

L<po4a-gettextize(1)>, L<po4a(7)>.

=head1 AUTEURS

 Denis Barbier <barbier@linuxfr.org>
 Nicolas François <nicolas.francois@centraliens.net>
 Martin Quinson (mquinson#debian.org)

=head1 COPYRIGHT EN LICENTIE

Copyright 2002-2023 door SPI, inc.

Dit programma is vrije software; u kunt het verder verspreiden en/of
aanpassen onder de bepalingen van de GPL v2.0 of recenter (zie het bestand
COPYING).
