XML format (.xml)
XML-formatet leser generiske XML-dokumenter, trekker ut teksten i konfigurerte elementer og attributter som oversettbare blokker, og skriver oversettelsene tilbake mens omliggende markup bevares. Inline-elementer blir inline-koder i en blokk, slik at formateringskoder overlever oversettelse.
Uttrekk er regelbasert. De enkle listene (translatableElements, translatableAttributes, inlineElements, excludedElements) dekker de fleste tilfeller. De avanserte mappene elements og attributes uttrykker rikere ITS-lignende regler med attributtbetingelser, ID- og oversettbart-attributt-mappinger, og eksplisitt inkluder/ekskluder-atferd. Når ingen oversettbare elementer er oppgitt, behandles alt tekstinnhold som oversettbart; sett excludeByDefault for å invertere dette og bare inkludere det som regler velger inn.
How kapi reads it
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
attributes | object | Avanserte attributtspesifikke behandlingsregler med elementomfangsbegrensninger | |
blockTypeMap | object | Tilordning av elementnavn til blokktype-strenger for semantisk typeannotering | |
codeFinderRules | array | Regex-mønstre som matcher innebygd kode i oversettbar tekst | |
elements | object | Avanserte elementspesifikke behandlingsregler med betingelser, innebygd merking og oversettbare attributttilordninger | |
excludeByDefault | boolean | false | Ekskluder alle elementer med mindre de eksplisitt er inkludert av en elementregel med INCLUDE |
excludedElements | array | Elementnavn hvis innhold er utelatt fra uttrekk | |
extractNonTranslatableContent | boolean | true | Hvis sann (standard), vises ikke-oversettbart kontekstuelt innhold, som tekst i elementer utelukket fra hvitelisten og verbatim kode/pre-undertrær, som innholdsblokker (synlig for innhenting/LLM-konsumenter, hoppes over av maskinoversettelse) i stedet for å skjules i skjelettet. Deaktiver for å beholde det i skjelettet. |
groupElements | array | Elementnavn som produserer gruppe-/laggrenser i utdataene | |
idAttributes | array | Attributtnavn brukt til å hente blokk-ID-er fra elementer | |
inlineElements | array | Elementnavn behandlet som innebygde (spenn i tekst) i stedet for blokknivå | |
preserveWhitespace | boolean | false | Bevar original mellomrom i tekstinnhold i stedet for å komprimere det |
preserveWhitespaceElements | array | Elementnavn som bevarer mellomrom uavhengig av den globale innstillingen | |
subfilters | array | Array med {pattern, format}-tilordninger for innebygd innhold. Mønstre bruker punktseparerte elementstier med glob-støtte. | |
translatableAttributes | array | Attributtnavn som kan oversettes på tvers av alle elementer | |
translatableElements | array | Elementnavn hvis tekstinnhold er oversettbart. Hvis tom, er alt tekstinnhold oversettbart. | |
useCodeFinder | boolean | false | Aktiver regex-basert gjenkjenning av innebygde koder i oversettbar tekst |
Configure it live
Examples
Trekk ut spesifikke elementer
Oversett kun title- og para-tekst, og behandle b og i som inline.
translatableElements:
- title
- para
inlineElements:
- b
- i
Oversettbare attributter
Trekk ut verdier for title- og alt-attributter på tvers av alle elementer.
translatableAttributes:
- title
- alt
Betinget uttrekk med regler
Inkluder bare div-elementer hvis translate-attributt er yes.
excludeByDefault: true
elements:
div:
ruleTypes:
- INCLUDE
conditions:
- translate
- EQUALS
- "yes"
Processing notes
Inline-elementer blir inline-koder innenfor blokker; elementer på blokknivå danner den omkringliggende strukturen.
Elementregler med
INCLUDE/EXCLUDEkombineres medexcludeByDefaultfor å gi finkornet kontroll over hvilket innhold som trekkes ut.
Limitations
Dette er en generisk XML-leser; for spesifikke XML-dialekter (som RESX) bør du starte fra et skreddersydd regelsett i stedet for de bare standardverdiene.
Element- og attributtnavn i avanserte regler omgitt av enkle anførselstegn behandles som forankrede regulære uttrykk.
← Back to the Format Reference