Gå til hovedinnhold

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.

IDxml
SourceBuilt-in
Extensions.xml
MIME Typestext/xml, application/xml
CapabilitiesRead + Write

How kapi reads it

Parameters

ParameterTypeDefaultDescription
attributesobjectAvanserte attributtspesifikke behandlingsregler med elementomfangsbegrensninger
blockTypeMapobjectTilordning av elementnavn til blokktype-strenger for semantisk typeannotering
codeFinderRulesarrayRegex-mønstre som matcher innebygd kode i oversettbar tekst
elementsobjectAvanserte elementspesifikke behandlingsregler med betingelser, innebygd merking og oversettbare attributttilordninger
excludeByDefaultbooleanfalseEkskluder alle elementer med mindre de eksplisitt er inkludert av en elementregel med INCLUDE
excludedElementsarrayElementnavn hvis innhold er utelatt fra uttrekk
extractNonTranslatableContentbooleantrueHvis 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.
groupElementsarrayElementnavn som produserer gruppe-/laggrenser i utdataene
idAttributesarrayAttributtnavn brukt til å hente blokk-ID-er fra elementer
inlineElementsarrayElementnavn behandlet som innebygde (spenn i tekst) i stedet for blokknivå
preserveWhitespacebooleanfalseBevar original mellomrom i tekstinnhold i stedet for å komprimere det
preserveWhitespaceElementsarrayElementnavn som bevarer mellomrom uavhengig av den globale innstillingen
subfiltersarrayArray med {pattern, format}-tilordninger for innebygd innhold. Mønstre bruker punktseparerte elementstier med glob-støtte.
translatableAttributesarrayAttributtnavn som kan oversettes på tvers av alle elementer
translatableElementsarrayElementnavn hvis tekstinnhold er oversettbart. Hvis tom, er alt tekstinnhold oversettbart.
useCodeFinderbooleanfalseAktiver regex-basert gjenkjenning av innebygde koder i oversettbar tekst

Configure it live

Configuration
Loading form…

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/EXCLUDE kombineres med excludeByDefault for å 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