
        *****************************************************
        *           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

Locale::Po4a::TeX - TeX-documenten en afgeleiden van/naar PO-bestanden
converteren

=head1 BESCHRIJVING

Het doel van het project po4a (PO voor alles) is om de vertaalwerkzaamheden
(en interessanter nog, het onderhoud van vertalingen) te vergemakkelijken
met behulp van gettext-hulpmiddelen in domeinen waarin deze niet meteen
verwacht worden, zoals documentatie.

Locale::Po4a::TeX is een module ter ondersteuning van de vertaling van
TeX-documenten naar andere [menselijke] talen. Ze kan ook gebruikt worden
als basis voor het bouwen van modules voor op TeX gebaseerde documenten.

Gebruikers moeten waarschijnlijk eerder de LaTeX-module gebruiken, die
voortbouwt op de TeX-module en de definities van veelvoorkomende
LaTeX-commando's bevat.

=head1 VERTALEN MET PO4A::TEX

Deze module kan rechtstreeks gebruikt worden voor het verwerken van
generieke TeX-documenten. Zij splitst uw document op in kleinere blokken
(paragrafen, woordelijke blokken, of zelfs kleinere blokken, zoals titels en
indexen).

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 derivative module from this, to describe your
format's details.  See the section B<WRITING DERIVATE MODULES> below, for
the process description.

Deze module kan ook aangepast worden door regels in het TeX-bestand zelf,
die beginnen met "% po4a:". Dit proces wordt beschreven in het gedeelte
B<INBOUWAANPASSINGEN>.

=head1 MOGELIJKE OPTIES BIJ DEZE MODULE

De volgende opties zijn specifiek voor deze module:

=over 4

=item B<debug>

Debuggen activeren voor sommige interne mechanismen van deze module. Gebruik
de broncode om na te gaan voor welke delen debuggen mogelijk is.

=item B<no_wrap>

Door komma's gescheiden lijst met omgevingen, waarin de regelafbreking niet
veranderd mag worden.

Merk op dat er een verschil is tussen de omgevingen verbatim en no_wrap. In
verbatim (woordelijke) blokken gebeurt er geen analyse van commando's en
commentaar.

Indien deze omgeving nog niet geregistreerd was, zal po4a deze omgeving
beschouwen als een parameterloze omgeving.

=item B<exclude_include>

Door dubbele punten gescheiden lijst van bestanden die niet mogen ingevoegd
worden met de commando's \input en \include.

=item B<definitions>

De naam van een bestand dat definities voor po4a bevat, zoals beschreven
wordt in de sectie B<INBOUWAANPASSINGEN>. U kunt deze optie gebruiken indien
het niet mogelijk is om de definities te plaatsen in het document dat
vertaald wordt.

=item B<verbatim>

Door komma's gescheiden lijst van omgevingen die als letterlijk (verbatim)
moeten worden beschouwd.

Indien deze omgeving nog niet geregistreerd was, zal po4a deze omgeving
beschouwen als een parameterloze omgeving.

=back

Gebruik deze opties om het standaardgedrag van de gedefinieerde commando's
op te heffen.

=head1 INBOUWAANPASSINGEN

De TeX-module kan aangepast worden met regels die beginnen met B<%
po4a:>. Deze regels worden geïnterpreteerd als commando's voor de
ontleder. De volgende commando's worden herkend:

=over 4

=item B<% po4a: command> I<commando1> B<alias> I<commando2>

Geeft aan dat de argumenten voor het commando I<commando1> behandeld moeten
worden zoals de argumenten voor het commando I<commando2>.

=item B<% po4a: command> I<commando1> I<parameters>

Dit beschrijft in detail de parameters voor het commando I<commando1>. Deze
informatie wordt vervolgens gebruikt om het aantal argumenten en hun type te
controleren.

U kunt het commando I<commando1> laten voorafgaan door

=over 4

=item een sterretje (B<*>)

po4a zal dit commando uit paragrafen halen (als het zich in het begin of aan
het einde van een paragraaf bevindt). De vertalers zullen dan de parameters,
die gemarkeerd zijn als vertaalbaar, moeten vertalen.

=item een plus (B<+>)

Zoals dit bij een sterretje gebeurt, zal het commando uit het blok gehaald
worden, als het zich aan een uiteinde ervan bevindt, maar de parameters
zullen niet afzonderlijk vertaald worden. De vertaler zal het commando
samengevoegd met al zijn parameters moeten vertalen. Dit behoudt meer
context en is nuttig voor commando's met kleine woorden als parameter, welke
verschillende betekenissen (en vertalingen) kunnen hebben.

Opmerking: in dit geval moet u niet specificeren welke parameters
vertaalbaar zijn, maar po4a moet het type en het aantal parameters kennen.

=item een minteken (B<->)

In dit geval zal het commando nooit uit een blok geëxtraheerd worden. Maar
wanneer het alleen in een blok voorkomt, dan zullen enkel de als vertaalbaar
gemarkeerde parameters voorgelegd worden aan de vertaler. Dit is nuttig voor
lettertypecommando's. Deze commando's zouden in het algemeen niet losgemaakt
moeten worden uit hun alinea (om de context te behouden), maar er is geen
reden om de vertaler ermee te ergeren als een heel tekstfragment door zo'n
commando omsloten wordt.

=back

The I<parameters> argument is a set of [] (to indicate an optional
argument) or {} (to indicate a mandatory argument).
You can place an underscore (_) between these brackets to indicate that
the parameter must be translated. For example:
 % po4a: command *chapter [_]{_}

This indicates that the chapter command has two parameters: an optional
(short title) and a mandatory one, which must both be translated.
If you want to specify that the href command has two mandatory parameters,
that you don't want to translate the URL (first parameter), and that you
don't want this command to be separated from its paragraph (which allow
the translator to move the link in the sentence), you can use:
 % po4a: command -href {}{_}

In dit geval wordt de informatie die aangeeft welke argumenten moeten worden
vertaald, alleen gebruikt als een alinea alleen bestaat uit dit
href-commando.

=item B<% po4a: environment> I<env> I<parameters>

This defines the parameters accepted by the I<env> environment and specifies the ones to be translated.
This information is later used to check the number of arguments of the
\begin command.
The syntax of the I<parameters> argument is the same as described for the
others commands.
The first parameter of the \begin command is the name of the environment.
This parameter must not be specified in the list of parameters. Here are
some examples:
 % po4a: environment multicols {}
 % po4a: environment equation

Zoals dit voor de commando's het geval is , kan I<env> voorafgegaan worden
door een plusteken (+) om aan te geven dat het \begin-commando met al zijn
argumenten vertaald moet worden.

=item B<% po4a: separator> I<env> B<">I<regex>B<">

Geeft aan dat een omgeving moet worden gesplitst volgens de gegeven
reguliere expressie.

De reguliere expressie wordt binnen aanhalingstekens geplaatst. Ze mag geen
terugverwijzing creëren. U moet (?:) gebruiken als u een groep wilt
gebruiken. Mogelijk zijn er ook escape-tekens nodig.

Bijvoorbeeld gebruikt de LaTeX-module de reguliere expressie "(?:&|\\\\)" om
elke cel van een tabel (regels worden gescheiden door '\\' en cellen door
'&') apart te vertalen.

Het begrip omgeving wordt uitgebreid naar het type dat wordt weergegeven in
het PO-bestand. Dit kan gebruikt worden om te splitsen bij  "\\\\" in het
eerste verplichte argument van het title-commando. In dit geval is de
omgeving title{#1}.

=item B<% po4a: verbatim environment> I<env>

Geeft aan dat I<env> een letterlijke omgeving is. In deze omgeving worden
commentaar en commando's genegeerd.

Indien deze omgeving nog niet geregistreerd was, zal po4a deze omgeving
beschouwen als een parameterloze omgeving.

=back

=head1 AFGELEIDE MODULES SCHRIJVEN

=over 4

=item B<pre_trans>

=item B<post_trans>

=item B<add_comment>

Een tekstfragment toevoegen om rond het volgende vertaalde element toe te
voegen. Dit is voornamelijk nuttig voor de texinfo-module, omdat commentaar
in TeX automatisch verwerkt wordt.

=item B<translate>

Wikkel rond de translate-functie van Transtractor, met voor- en
naverwerkingsfilters.

Commentaar bij een alinea wordt ingevoegd als PO-commentaar bij het eerste
vertaalde tekstfragment van deze paragraaf.

=item B<get_leading_command>($buffer)

Deze functie zendt het volgende terug:

=over 4

=item Een commandonaam

Indien aan het begin van de gegeven buffer geen commando aangetroffen wordt,
zal dit tekstfragment leeg zijn. Enkel met commando's die afgezonderd kunnen
worden, wordt rekening gehouden. De hash %separated_command bevat de lijst
met deze commando's.

=item Een variant

Dit geeft aan of een variant gebruikt wordt. Bijvoorbeeld kan een sterretje
(*) toegevoegd worden aan het eind van een section-commando om aan te geven
dat deze secties niet genummerd moeten worden. In dit geval zal dit veld "*"
bevatten. Dit veld is een lege tekenreeks indien er geen variant is.

=item Een reeks tupels (soort argument, argument)

Het soort argument is ofwel '{' (voor verplichte argumenten) of '[' (voor
facultatieve argumenten).

=item De resterende buffer

De rest van de buffer, nadat aan het begin ervan dit commando en zijn
argumenten verwijderd werden. Indien geen commando aangetroffen wordt,
blijft de originele buffer ongewijzigd en wordt deze teruggegeven in dit
veld.

=back

=item B<get_trailing_command>($buffer)

Hetzelfde als B<get_leading_command>, maar voor commando's aan het eind van
een buffer.

=item B<translate_buffer>

Een buffer recursief vertalen door de commando's aan het begin en het eind
ervan af te splitsen (deze welke vertaald moeten worden apart) van de
buffer.

Indien voor de huidige omgeving een functie gedefinieerd is in
%translate_buffer_env, zal deze functie gebruikt worden om de buffer te
vertalen in plaats van translate_buffer().

=item B<read>

Overbelast de functie read() van Transtractor.

=item B<read_file>

Een bestand recursief lezen en er de ingevoegde bestanden, welke niet
vermeld zijn in de matrix @exclude_include, aan toevoegen. Ingevoegde
bestanden worden opgezocht met het commando B<kpsewhich> uit de
Kpathsea-bibliotheek.

Behalve voor het aspect van het invoegen van bestanden, is het een knippen
en plakken uit de functie read van Transtractor.

=back

=over 4

=item B<parse_definition_file>

Een subroutine voor het ontleden van een bestand met po4a-richtlijnen
(definities voor nieuwe commando's).

=item B<parse_definition_line>

Een definitieregel in de vorm "% po4a: " ontleden.

Zie het gedeelte B<INBOUWAANPASSINGEN> voor meer details.

=item B<is_closed>

=item B<parse>

=item B<docheader>

=back

=head1 INTERNE FUNCTIES welke gebruikt worden voor het schrijven van afgeleide
ontleders

Functies voor commando's en omgevingen nemen de volgende argumenten (naast
het object $self):

=over

=item Een commandonaam

=item Een variant

=item Een lijst van tupels (type, argument)

=item De huidige omgeving

=back

De eerste 3 argumenten worden geëxtraheerd door get_leading_command of
get_trailing_command.

De functies voor commando's en omgevingen geven de vertaling van het
commando met zijn argumenten terug, evenals de nieuwe omgeving.

Omgevingsfuncties worden aanroepen wanneer een \begin-commando aangetroffen
wordt. Zij worden aanroepen met het \begin-commando en zijn argumenten.

De TeX-module bevat slechts één commandofunctie en één omgevingsfunctie:
generic_command en generic_environment.

generic_command uses the information specified by
register_generic_command or by adding definition to the TeX file:
 % po4a: command I<command1> I<parameters>

generic_environment uses the information specified by
register_generic_environment or by adding definition to the TeX file:
 % po4a: environment I<env> I<parameters>

Beide functies zullen enkel de parameters vertalen welke als vertaalbaar
(met een '_') opgegeven werden. generic_environment zal de naam van de
omgeving toevoegen aan de omgevingsstapel en generic_command zal de naam van
het commando toevoegen, gevolgd door een identificatiesymbool van de
parameter (zoals {#7} of [#2]).

=head1 STATUS VAN DEZE MODULE

Deze module moet nog meer getest worden.

Ze werd getest met een boek en met de Python-documentatie.

=head1 TO-DOLIJST

=over 4

=item Automatische detectie van nieuwe commando's

De TeX-module zou de newcommand-argumenten kunnen ontleden en kunnen
proberen te raden naar het aantal argumenten, naar het type ervan en of ze
al dan niet vertaald moeten worden.

=item Vertaling van het omgevingsscheidingsteken

Wanneer \item gebruikt wordt als een scheidingsteken in een omgevings, wordt
het argument van item toegevoegd aan het volgende tekstfragment.

=item Sommige commando's zouden toegevoegd moeten worden aan de omgevingsstapel

Deze commando's moeten door paren worden gespecificeerd. Dit kan gebruikt
worden om commando's te specificeren die een verbatim-omgeving beginnen of
beëindigen.

=item Andere

Verschillende andere punten staan in de broncode gemarkeerd als TODO.

=back

=head1 GEKENDE BUGS

Verschillende punten staan in de broncode gemarkeerd als FIXME.

=head1 ZIE OOK

L<Locale::Po4a::LaTeX(3pm)|Locale::Po4a::LaTeX>,
L<Locale::Po4a::TransTractor(3pm)|Locale::Po4a::TransTractor>,
L<po4a(7)|po4a.7>

=head1 AUTEURS

 Nicolas François <nicolas.francois@centraliens.net>

=head1 COPYRIGHT EN LICENTIE

Copyright © 2004, 2005 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.

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).
