
        *****************************************************
        *           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::Sgml - SGML-documenten 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::Sgml is een module ter ondersteuning van de vertaling van
documentatie in de SGML-indeling naar andere [menselijke] talen.

Deze module gebruikt B<onsgmls>(1) om de SGML-bestanden te ontleden. Zorg
ervoor dat dit geïnstalleerd is. Zorg er ook voor dat de DTD van de
SGML-bestanden op het systeem geïnstalleerd zijn.

=head1 MOGELIJKE OPTIES BIJ DEZE MODULE

=over 4

=item B<debug>

Door spaties gescheiden lijst met trefwoorden die aangeven welke categorie
extra debug-berichten moet worden weergegeven. Mogelijke waarden zijn:
C<entities>, C<generic>, C<onsgml>, C<refs> en C<tag>.

=item B<verbose>

Meer informatie geven over wat gaande is.

=item B<translate>

Door spaties gescheiden lijst van extra tags (naast de door DTD verstrekte
tags) waarvan de inhoud een extra msgid moet vormen, d.w.z. die moeten
worden vertaald.

=item B<section>

Door spaties gescheiden lijst van extra tags (naast de door DTD verstrekte
tags) die andere tags bevatten, waarvan sommige van categorie B<translate>
zijn.

=item B<indent>

Door spaties gescheiden lijst met tags die het insprongniveau verhogen. Dit
zal het inspringen in het resulterende document beïnvloeden.

=item B<verbatim>

Binnen deze tags mag de opmaak niet gewijzigd worden. Op de alinea zal geen
regelafbreking toegepast worden en er zal geen extra insprongruimte en geen
nieuwe regel toegevoegd worden voor cosmetische doeleinden.

=item B<empty>

Tags welke niet gesloten moeten worden.

=item B<ignore>

Genegeerde tags welke door po4a beschouwd worden als gewone
lettertekens. Dit wil zeggen dat zij deel kunnen uitmaken van een
msgid. Bijvoorbeeld is E<lt>bE<gt> een goede kandidaat voor deze categorie,
want dit plaatsen in de sectie B<translate> (vertalen), zou een msgid maken
met alleen de inhoud ervan (en dit is meestal geen hele zin), wat slecht is.

=item B<attributes>

Een door spaties gescheiden lijst met attributen welke vertaald moeten
worden. U kunt de attributen bij hun naam opgeven (bijvoorbeeld C<lang>),
maar u kunt ze ook laten voorafgaan door een hiërarchie van tags, om aan te
geven dat dit attribuut enkel vertaald zal worden wanneer het zich binnen de
opgegeven tag bevindt. Bijvoorbeeld: C<< <bbb><aaa>lang >> geeft aan dat het
attribuut lang enkel vertaald zal worden als het zich binnen een C<< <aaa>
>>-tag bevindt, welke zich op zijn beurt binnen een C<< <bbb> >>-tag moet
bevinden. De namen van tags zijn eigenlijk reguliere expressies, en dus kunt
u ook zaken schrijven zoals C<< <aaa|bbb>lang >> om C<lang>-attributen enkel
te vertalen wanneer deze zich binnen een tag C<< <aaa> >> of C<< <bbb> >>
bevinden.

=item B<qualify>

Een door spaties gescheiden lijst met attributen waarvoor de vertaling moet
worden gekwalificeerd door de naam van het attribuut, dat wil zeggen dat de
tekst die wordt geëxtraheerd voor de vertaling zowel de naam van het
attribuut als de waarde ervan zal bevatten. bijv. voor een tag als C<< <aaa
lang_en="foo"> >> zullen vertalers de string C<lang_en="foo"> te zien
krijgen.. Merk op dat dit ook automatisch het gegeven attribuut toevoegt aan
de lijst met B<attributen>.

=item B<force>

Doorgaan, zelfs als de DTD onbekend is of als B<onsgmls> fouten vindt in het
invoerbestand.

=item B<include-all>

Standaard worden msgid's, welke slechts één entiteit (zoals C<&version;>)
bevatten, overgeslagen voor het comfort van de vertalers. Het activeren van
deze optie voorkomt deze optimalisatie. Dit kan nuttig zijn als het document
een constructie bevat, zoals C<< <title>&Aacute;</title> >> hoewel ik eraan
twijfel dat dergelijke zaken ooit voorkomen...

=item B<ignore-inclusion>

Door spaties gescheiden lijst van entiteiten die niet worden geïntegreerd in
de tekst. Gebruik deze optie voorzichtig: ze kan ervoor zorgen dat
B<onsgmls> (dat intern gebruikt wordt) tags toevoegt en het uitvoerdocument
ongeldig maakt.

=back

=head1 STATUS VAN DEZE MODULE

Het resultaat is perfect. Dat wil zeggen dat de gegenereerde documenten
exact hetzelfde zijn als de originele. Maar er zijn nog steeds enkele
problemen:

=over 2

=item *

Standaard wordt de foutuitvoer van B<onsgmls> omgeleid naar /dev/null, wat
duidelijk niet goed is. Ik weet niet hoe dit vermeden kan worden.

Het probleem is dat ik de voorwaardelijke insluitingen (d.w.z. de zaken
C<E<lt>! [ %foo [> en C<]]E<gt>>) moet "beschermen" tegen B<onsgmls>. Anders
eet B<onsgmls> ze op, en ik weet niet hoe ik ze moet herstellen in het
uiteindelijke document. Om dat te voorkomen, herschrijf ik ze naar
C<{PO4A-beg-foo}> en C<{PO4A-end}>.

Het probleem hiermee is dat de C<{PO4A-end}> en dergelijke, welke ik
toevoeg, ongeldig zijn in het document (behalve in een E<lt>pE<gt>-tag of
zo).

Indien u de uitvoer van B<onsgmls> wil zien, moet u gewoon het volgende
toevoegen aan uw commandoregel (of in de po4a configuratieregel):

  -o debug=onsgmls

=item *

Het werkt enkel met de DebianDoc en DocBook DTD. Ondersteuning toevoegen
voor een nieuwe DTD zou makkelijk moeten zijn. het mechanisme is hetzelfde
voor elke DTD. U dient gewoon een lijst op te geven met de tags en bepaalde
van hun karakteristieken.

Ik ga ermee akkoord dat dit wat meer documentatie kan gebruiken, maar het
wordt nog steeds als bèta beschouwd en ik heb er een hekel aan om
documentatie te maken voor zaken die kunnen/zullen veranderen.

=item *

Waarschuwing: ondersteuning voor DTD's is eerder experimenteel. Ik las geen
enkele referentiehandleiding om de definitie te vinden van elke tag. Ik
voegde aan de module tag-definities toe tot ze werkte voor sommige
documenten die ik op het internet vond. Indien in uw document meer tags
gebruikt worden dan in het mijne, zal het niet werken. Maar zoals ik
hiervoor reeds zegde, zou het redelijk makkelijk moeten zijn om dit aan te
passen.

Ik testte DocBook enkel met de SAG (System Administrator Guide), maar dit is
een behoorlijk groot document en het zou gebruik moeten maken van de meeste
van de specifieke kenmerken van DocBook.

Voor DebianDoc testte ik met een aantal handleidingen van het DDP, maar nog
niet met allemaal.

=item *

In het geval er bestanden ingesloten worden, zullen de
tekstfragmentreferenties van berichten in PO-bestanden (d.w.z. regels zoals
C<#: en/titletoc.sgml:9460>) fout zijn.

Dit is omdat ik een voorbehandeling toepas op het bestand om de
voorwaardelijke insluitingen (d.w.z. de zaken C<E<lt>! [ %foo [> en
C<]]E<gt>>) en sommige entiteiten (zoals C<&version;>) af te schermen voor
B<onsgmls>, omdat ik ze woordelijk in het gegenereerde document wil. Om die
reden maak ik een tijdelijke kopie van het invoerbestand waarop ik alle
gewenste veranderingen aanbreng, vooraleer ik dat ter ontleding doorgeef aan
B<onsgmls>.

Om dit te laten werken, vervang ik de entiteiten die vragen om de insluiting
van een bestand, door de inhoud van het gegeven bestand (zodat ik ook in een
subbestand de zaken die moeten afgeschermd worden, kan afschermen). Maar
voorlopig werd nog niets gedaan om achteraf de referenties te corrigeren
(d.w.z. bestandsnaam en regelnummer). Ik weet niet zeker wat er best gedaan
zou kunnen worden.

=back

=head1 AUTEURS

Deze module is een aanpassing van sgmlspl (SGML postprocessor voor de
ONSGMLS-ontleder). Deze was:

 Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>

De aanpassing voor po4a gebeurde door:

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)

=head1 COPYRIGHT EN LICENTIE

 Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>.
 Copyright © 2002-2005 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).
