NAMN¶

Locale::Po4a::Xml - konvertera XML-dokument och derivat från/till PO-filer

BESKRIVNING¶

Målet med po4a-projektet (PO för allt) är att underlätta översättningar (och, ännu mer intressant, underhållet av översättningar) med hjälp av gettext-verktyg på områden där de inte förväntades användas, såsom dokumentation.

Locale::Po4a::Xml är ett modul som hjälper till att översätta XML-dokument till andra [mänskliga] språk. Det kan också användas som bas för att bygga moduler för XML-baserade dokument.

ÖVERSÄTTNING MED PO4A::XML¶

Denna modul kan användas direkt för att hantera generiska XML-dokument. Detta extraherar allt tagginnehåll, men inga attribut, eftersom det är där texten skrivs i de flesta XML-baserade dokument.

Det finns några flaggor (beskrivna i nästa avsnitt) som kan anpassa detta beteende. Om detta inte passar ditt dokumentformat uppmuntras du att skriva din egen modul som härrör från denna, för att beskriva detaljerna i ditt format. Se avsnittet B-<WRITING DERIVATE MODULES> en nedan för en beskrivning av processen.

FLAGGOR SOM ACCEPTERAS AV DENNA MODUL¶

Det globala felsökningsflaggan gör att denna modul visar de uteslutna strängarna, för att se om den hoppar över något viktigt.

Detta är modulens specifika flaggor:

nostrip

Förhindrar att mellanslag runt de extraherade strängarna tas bort.

wrap

Kanoniserar strängen som ska översättas, med hänsyn till att blanktecken inte är viktiga, och slår in det översatta dokumentet. Denna flagga kan åsidosättas av anpassade taggflaggor. Se flaggan B-<translated> nedan.

unwrap_attributes

Attribut är som standard inslagna. Den här flaggan inaktiverar inslagningen.

caseinsensitive

Det gör att sökningen efter taggar och attribut fungerar utan hänsyn till versaler och gemener. Om det är definierat kommer det att behandla <BooK>laNG och <BOOK>Lang som <book>lang.

escapequotes

Undvik citattecken i utdatasträngar. Nödvändigt, till exempel för att skapa strängresurser för användning av Android-byggverktyg.

Se även: https://developer.android.com/guide/topics/resources/string-resource.html

includeexternal

När externa enheter definieras inkluderas de i det genererade (översatta) dokumentet och för extrahering av strängar. Om de inte definieras måste du översätta externa enheter separat som oberoende dokument.

ontagerror

Den här flaggan definierar modulens beteende när den stöter på ogiltig XML-syntax (en avslutande tagg som inte matchar den sista öppnande taggen). Det kan ha följande värden:

tagsonly

Observera: Den här flaggan är föråldrad.

Extraherar endast de angivna taggarna i flaggan B-<tags>. Annars extraheras alla taggar utom de angivna.

doctype

Sträng som försöker matcha den första raden i dokumentets doctype (om sådan finns definierad). Om den inte matchar visas en varning om att dokumentet kan vara av fel typ.

addlang

Sträng som anger sökvägen (t.ex. <bbb><aaa>) till en tagg där attributet lang="..." ska läggas till. Språket definieras som basnamnet på PO-filen utan filändelsen .po.

optionalclosingtag

Boolesk variabel som anger om slutetaggar är valfria (som i HTML). Som standard genererar saknade slutetaggar ett fel som hanteras enligt ontagerror.

tags

Observera: Den här flaggan är föråldrad. Du bör istället använda flaggorna translated och untranslated.

En lista med taggar som du vill översätta eller hoppa över, separerade med mellanslag. Som standard kommer de angivna taggarna att exkluderas, men om du använder flaggan "tagsonly" kommer endast de angivna taggarna att inkluderas. Taggarna måste ha formen <aaa>, men du kan slå ihop några (<bbb><aaa>) för att ange att innehållet i taggen <aaa> endast ska översättas när det finns i en <bbb> tagg.

Du kan också ange vissa taggflaggor genom att placera vissa tecken framför tagghierarkin. Du kan till exempel placera w (bryt) eller W (bryt inte) för att åsidosätta standardbeteendet som anges av det globala flaggan wrap.

Exempel: W<chapter><title>

attributes

En lista med taggattribut som du vill översätta, separerade med mellanslag. Du kan ange attributen med deras namn (till exempel "lang"), men du kan också lägga till en tagghierarki framför namnet för att ange att attributet endast ska översättas när det finns i den angivna taggen. Till exempel: <bbb><aaa>lang anger att attributet lang endast ska översättas om det finns i en <aaa> tagg och om det finns i en <bbb> tagg.

foldattributes

Översätt inte attribut i inline-taggar. Ersätt istället alla attribut i en tagg med po4a-id=<id>.

Detta är användbart när attribut inte ska översättas, eftersom det förenklar strängarna för översättare och undviker stavfel.

customtag

Mellanslagsavgränsad lista över taggar som inte ska behandlas som taggar. Dessa taggar behandlas som inline och behöver inte stängas.

break

Lista med taggar separerade med mellanslag som ska bryta sekvensen. Som standard bryter alla taggar sekvensen.

Taggarna måste ha formen <aaa>, men du kan sammanfoga några (<bbb><aaa>), om en tagg (<aaa>) endast ska beaktas när den finns inom en annan tagg (<bbb>).

Observera att en tagg endast ska anges i en av inställningssträngarna break, inline placeholder eller customtag.

inline

Mellanslagsavgränsad lista över taggar som ska behandlas som inline. Som standard bryter alla taggar sekvensen.

Taggarna måste ha formen <aaa>, men du kan sammanfoga några (<bbb><aaa>), om en tagg (<aaa>) endast ska beaktas när den finns inom en annan tagg (<bbb>).

placeholder

Lista med taggar separerade med mellanslag som ska behandlas som platshållare. Platshållare bryter inte sekvensen, men innehållet i platshållarna översätts separat.

Platshållarens placering i sitt block markeras med en sträng som liknar:

  <platshållare typ=\"fotnot\" id=\"0\"/>
    

Taggarna måste ha formen <aaa>, men du kan sammanfoga några (<bbb><aaa>), om en tagg (<aaa>) endast ska beaktas när den finns inom en annan tagg (<bbb>).

break-pi

Som standard hanteras bearbetningsinstruktioner (dvs. "<? ... ?>"-taggar) som inline-taggar. Ange denna flagga om du vill att PI ska hanteras som brytande tagg. Observera att obearbetade PHP-taggar hanteras som bearbetningsinstruktioner av tolkaren.

nodefault

Lista med taggar separerade med mellanslag som modulen inte ska försöka ställa in som standard i någon kategori.

Om du har en tagg som har sin standardinställning av underklassen för denna modul men du vill ställa in en alternativ inställning, måste du lista den taggen som en del av B-<nodefault> -inställningssträngen.

cpp

Stöd för C-preprocessordirektiv. När denna flagga är aktiverat kommer po4a att betrakta preprocessordirektiv som styckeavgränsare. Detta är viktigt om XML-filen måste förbehandlas, eftersom direktiven annars kan infogas mitt i raderna om po4a anser att de tillhör det aktuella stycket, och de kommer då inte att kännas igen av preprocessorn. Observera: preprocessordirektiven får endast förekomma mellan taggar (de får inte bryta en tagg).

translated

En lista med taggar som du vill översätta, separerade med mellanslag.

Taggarna måste ha formen <aaa>, men du kan sammanfoga några (<bbb><aaa>), om en tagg (<aaa>) endast ska beaktas när den finns inom en annan tagg (<bbb>).

Du kan också ange vissa taggflaggor genom att placera vissa tecken framför tagghierarkin. Detta åsidosätter standardbeteendet som anges av de globala flaggorna wrap och defaulttranslateoption.

untranslated

Lista med taggar som du inte vill översätta, separerade med mellanslag.

Taggarna måste ha formen <aaa>, men du kan sammanfoga några (<bbb><aaa>), om en tagg (<aaa>) endast ska beaktas när den finns inom en annan tagg (<bbb>).

Observera att en översättningsbar inline-tagg i en icke översatt tagg behandlas som en översättningsbar brytande tagg, inställningen i tas bort och w eller W ställs in beroende på flaggan wrap.

defaulttranslateoption

Standardkategorierna för taggar som inte finns i någon av kategorierna översatt, oöversatt, brytning, inline eller platshållare.

Detta är en uppsättning bokstäver som definieras i translated och denna inställning gäller endast för översättningsbara taggar.

SKRIVA DERIVATMODULER¶

  $self->{options}{'new_option'}='';
  $self->SUPER::initialize(%options);
  $self->{options}{'_default_translated'}.=' <p> <head><title>';
  $self->{options}{'attributes'}.=' <p>lang id';
  $self->{options}{'_default_inline'}.=' <br>';
  $self->treat_options;

  sub found_string {
    my ($self,$text,$ref,$options)=@_;
    $text = $self->translate($text,$ref,"type ".$options->{'type'},
      'wrap'=>$self->{options}{'wrap'});
    return $text;
  }

INTERNA FUNKTIONER som används för att skriva derivatparsers¶

STATUS FÖR DENNA MODUL¶

Denna modul kan översätta taggar och attribut.

ATT GÖRA-LISTA¶

DOCTYPE (ENTITETER)

Det finns ett minimalt stöd för översättning av enheter. De översätts som en helhet och taggar beaktas inte. Enheter med flera rader stöds inte och enheter omformateras alltid under översättningen.

ÄNDRA TAGGTYPER FRÅN ARVADE MODULER (flytta tag_types-strukturen inuti $self-hash?)

SE ÄVEN¶

Locale::Po4a::TransTractor(3pm), po4a(7)

UPPHOVSPERSONER¶

 Jordi Vilalta <jvprat@gmail.com>
 Nicolas François <nicolas.francois@centraliens.net>

UPPHOVSRÄTT OCH LICENS¶

 Copyright © 2004 Jordi Vilalta  <jvprat@gmail.com>
 Copyright © 2008-2009 Nicolas François <nicolas.francois@centraliens.net>

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