XLIFF 1.2 format (.xlf, .xliff)

XLIFF 1.2 is the OASIS XML interchange standard for bilingual content, the exchange format that translation tools and TMS platforms use to move content between extraction and translation. A document groups <trans-unit> elements under <file> containers, each unit holding a <source> and an optional <target>, with inline markup represented through paired (bpt/ept, g) or standalone (x, ph) code elements and segmentation expressed via <seg-source> and <mrk mtype="seg">.

The reader emits one block per translatable <trans-unit>, carrying the source, any existing target, segmentation, alt-trans matches, and unit metadata. The writer updates targets and, by default, the target state attribute, so a round-tripped file reflects translation progress. This mirrors Okapi's XLIFF 1.2 filter.

IDxliff

SourceBuilt-in

Extensions.xlf, .xliff

MIME Typesapplication/xliff+xml, application/x-xliff+xml

CapabilitiesRead + Write

How kapi reads it

Parameters

Parameter	Type	Default	Description
addAltTrans	boolean	false	Tillat tillegg av nye alt-trans-elementer
addTargetLanguage	boolean	true	Legg til målspråkattributtet i filelementer hvis det ikke allerede er til stede
allowEmptyTargets	boolean	false	Tillat at målelementer med tomt innhold skrives
alwaysAddTargets	boolean	false	Legg til målelementer for enspråklige XLIFF-filer som ikke har noe mål i kilden
codeFinderRules	array		Regex-mønstre som samsvarer med innebygde koder i oversettbar tekst
editAltTrans	boolean	false	Tillat redigering av eksisterende alt-trans-elementer
fallbackToID	boolean	false	Bruk trans-unit id-attributtet som blokknavn når resname-attributtet ikke er til stede
forceUniqueIds	boolean	false	Skriv om trans-unit-IDer for å håndheve unikhet på tvers av filen
ignoreInputSegmentation	boolean	false	Ignorer seg-source/mrk-segmentering fra inndata-XLIFF og behandle hele kilden som ett enkelt segment
includeExtensions	boolean	true	Inkluder ikke-standard navneromutvidelserelementer i uttrukket innhold
includeIts	boolean	true	Inkluder ITS (Internationalization Tag Set)-markup i ekstrahert innhold
overrideTargetLanguage	boolean	false	Overstyr attributtet for målspråk i utdatadokumentet med rørledningens mållokal
preserveSpaceByDefault	boolean	false	Behandle alt innhold som xml:space="preserve" med mindre det eksplisitt overstyres
targetStateValue	string	needs-translation	Tilstandsverdi som skal angis på målelementer når useTranslationTargetState er aktivert
useCodeFinder	boolean	false	Aktiver regex-basert deteksjon av innebygd kode i oversettbar tekst
useTranslationTargetState	boolean	true	Oppdater tilstandsattributtet på målelementer ved skriving av oversatt XLIFF

Configure it live

Configuration

Loading form…

Configuration output

vs defaults no changes

apiVersion: neokapi/v1
kind: XliffFormatConfig
metadata:
  name: xliff
spec:
  # (default configuration)

Examples

Mark targets as translated

Write a final target state instead of the default needs-translation.

useTranslationTargetState: true
targetStateValue: translated

Flatten input segmentation

Treat each source as one segment, ignoring seg-source markers.

ignoreInputSegmentation: true

Processing notes

• One block is emitted per translatable <trans-unit>; units marked translate="no" are passed through as non-translatable.

• Inline markup (bpt/ept, g, x, ph) and <seg-source>/<mrk mtype="seg"> segmentation are read into the block.

Reference documentation

← Back to the Format Reference