NAAM¶

Locale::Po4a::SimplePod - POD-data van/naar PO-bestanden converteren met Pod::Simple

OVERZICHT¶

  [po4a_paths] /pad/naar/pot $lang:/pad/naar/po
  [type:SimplePod] /pad/naar/source.pod $lang:/pad/naar/localized.pod

of

  [po4a_paths] /pad/naar/pot $lang:/pad/naar/po
  [po4a_alias:pod] SimplePod
  [type:pod] /pad/naar/source.pod $lang:/pad/naar/localized.pod

BESCHRIJVING¶

Dit is een module ter ondersteuning van de vertaling van documentatie in de POD-indeling (de voorkeurtaal bij het documenteren van Perl) naar andere menselijke talen.

De belangrijkste verschillen tussen de huidige Pod-indeling en de SimplePod-indeling zijn als volgt:

• De SimplePod-indeling bevat nooit extra nieuwe regels in te vertalen berichten. De huidige Pod-indeling kan echter wel extra nieuwe regels bevatten, met name in letterlijke berichten.
• Paragrafen kunnen met regelafbreking worden weergegeven. De module Pod::Parser kan mogelijk een speciale afhandeling toepassen voor regelafbreking, waardoor het moeilijk is om dit na te bootsen met Pod::Simple. Echter, Pod::Simple lijkt een natuurlijkere uitvoer te produceren.
• In SimplePod bevat het bericht "=for" (bijvoorbeeld "=for comment text") geen formaatnaam (zoals "comment"), waardoor het bericht uitsluitend uit tekst bestaat. De huidige Pod-indeling daarentegen behoudt de formaatnaam, wat resulteert in een bericht zoals "comment text". De eerste werkwijze wordt als prettiger ervaren door vertalers.
• Items zoals hieronder, die "=end comment" aangeven, zijn niet meer aanwezig in de huidige Pod-module. Omdat dit geen vertaalbare berichten zijn, is hun afwezigheid een verbetering.

    #. type: =end
    #: sample.pod:10
    msgid "comment"
    msgstr ""
      

• Tekstblokken waarvan de geldigheid van de POD-indeling onzeker is, worden nu behandeld als "no-wrap". Dit geldt bijvoorbeeld voor de inhoud van een "=begin html"-blok. In de Pod-module werden deze niet behandeld als "no-wrap", wat soms resulteerde in regelafbreking.
• De "=begin"-parametersectie is niet langer onderhevig aan vertaling. In de huidige Pod-module is deze wel opgenomen. Mocht er vraag zijn om deze in de vertaling op te nemen, meld dit dan.

STATUS VAN DEZE MODULE¶

Deze module is nog in ontwikkeling en daardoor minder stabiel dan Locale::Po4a::Pod. De module blijft evolueren en er is ruimte voor verdere verfijning. Het gedrag kan in de loop der tijd veranderen en er kunnen extra opties worden geïntroduceerd om de vertaalervaring voor gebruikers te optimaliseren. Feedback en praktijkvoorbeelden van echte toepassingen zullen een belangrijke rol spelen bij de toekomstige ontwikkeling ervan.

De code wordt volledig gedekt door onze testsuite en we zijn niet op de hoogte van bestaande bugs. Vanaf 2025 is de code echter nog niet uitvoerig getest in echte werkstromen van externe vertaalprojecten. Desondanks zijn we ervan overtuigd dat de module klaar is voor productie, ook al zullen er ongetwijfeld bugs worden ontdekt naarmate de module breder wordt toegepast.

Deze module is bedoeld om de huidige Locale::Po4a::Pod-module te vervangen. De reden is dat Pod::Parser, dat door de huidige Locale::Po4a::Pod wordt gebruikt, nu verouderd is en het wordt aanbevolen om in plaats daarvan Pod::Simple te gebruiken. Zie ook GitHub issue #256 "Consider migrating away from deprecated "Pod::Parser"" <https://github.com/mquinson/po4a/issues/256>.

ZIE OOK¶

Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, po4a(7), Locale::Po4a::SimplePod::Parser.

AUTEURS¶

  gemmaro <gemmaro.dev@gmail.com>

COPYRIGHT EN LICENTIE¶

  Copyright (C) 2025 gemmaro <gemmaro.dev@gmail.com>.

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