NAMN¶

Locale::Po4a::SimplePod – konvertera POD-data från/till PO-filer med Pod::Simple

SYNOPSIS¶

  [po4a_paths] /sökväg/till/pot $lang:/sökväg/till/po
  [type:SimplePod] /sökväg/till/källa.pod $lang:/sökväg/till/lokalanpassad.pod

eller

  [po4a_paths] /sökväg/till/pot $lang:/sökväg/till/po
  [po4a_alias:pod] SimplePod
  [type:pod] /sökväg/till/källa.pod $lang:/sökväg/till/lokalanpassad.pod

BESKRIVNING¶

Detta är ett modul som hjälper till att översätta dokumentation i POD-format (det föredragna språket för dokumentation av Perl) till andra mänskliga språk.

De viktigaste skillnaderna mellan det nuvarande Pod-formatet och SimplePod-formatet är följande:

• SimplePod-formatet innehåller aldrig extra radbrytningar i meddelanden som ska översättas. Det nuvarande Pod-formatet kan dock innehålla extra radbrytningar, särskilt i ordagrant återgivna meddelanden.
• Avsnitt kan återges med radbrytning. L-<Pod::Parser> -modulen kan tillämpa särskild hantering för radbrytning, vilket gör det svårt att replikera med L-<Pod::Simple>. L-<Pod::Simple> verkar dock ge ett mer naturligt resultat.
• I SimplePod innehåller C-<=for> -meddelandet (t.ex. "=for comment text") inte något formatnamn (som "comment"), så meddelandet består enbart av text. Däremot behåller det nuvarande Pod-formatet formatnamnet, vilket resulterar i ett meddelande som "comment text". Det förstnämnda beteendet anses vara bekvämare för översättare.
• Inlägg som det nedan, som betecknar "=end comment", finns inte längre i den aktuella Pod-modulen. Eftersom dessa inte är översättningsbara meddelanden är deras frånvaro en förbättring.

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

• Textblock vars POD-format är osäkert behandlas nu som C-<no-wrap>. Detta gäller till exempel innehållet i ett C-<=begin html> -block. I Pod-modulen behandlades dessa inte som C-<no-wrap>, vilket ibland resulterade i radbrytningar.
• Parametersektionen "=begin" översätts inte längre. I den aktuella Pod-modulen ingår den. Om det finns ett behov av att inkludera den i översättningen, vänligen rapportera detta.

STATUS FÖR DENNA MODUL¶

Denna modul är fortfarande nyutvecklad, så den är mindre stabil än Locale::Po4a::Pod. Den fortsätter att utvecklas och det finns utrymme för ytterligare förbättringar. Dess beteende kan komma att förändras över tid och ytterligare flaggor kan introduceras för att optimera översättningsupplevelsen för användarna. Återkoppling och användningsfall från verkliga tillämpningar kommer att spela en viktig roll för att styra dess framtida utveckling.

Koden täcks helt av vår testserie och vi känner inte till några befintliga buggar. Men 2025 har den ännu inte testats i verkliga översättningsarbetsflöden i externa projekt. Vi anser dock att modulen är redo för produktionsanvändning, även om vissa buggar oundvikligen kan upptäckas när den får bredare användning.

Denna modul är avsedd att ersätta den nuvarande Locale::Po4a::Pod -modulen. Anledningen är att Pod::Parser, som används av den nuvarande Locale::Po4a::Pod, nu är föråldrad, och det rekommenderas att använda Pod::Simple istället. Se även GitHub issue #256 "Consider migrating away from deprecated "Pod::Parser"" <https://github.com/mquinson/po4a/issues/256>.

SE ÄVEN¶

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

UPPHOVSPERSONER¶

  gemmaro <gemmaro.dev@gmail.com>

UPPHOVSRÄTT OCH LICENS¶

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

Detta program är fri programvara; du får distribuera och/eller modifiera det enligt villkoren i GPL v2.0 eller senare (se filen COPYING).