Java Properties format (.properties)
The Java Properties format reads .properties resource bundles,
extracts the value of each entry as a translatable block, and writes the
translations back while preserving keys, comments, and layout. It is the
standard format for translatable resources in Java applications and
libraries.
Each line is a key=value (or key:value) entry; comment lines begin with
# or !. By default every value is extracted. You can restrict extraction
to entries whose keys match a pattern, treat comments as translator notes,
retain or resolve Java escape sequences, and control non-ASCII escaping in
the output.
How kapi reads it
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
codeFinderRules | array | Regex-mønstre som matcher innebygde koder i oversettbar tekst | |
commentsAreNotes | boolean | true | Behandle kommentarer som oversetternotater knyttet til den følgende oppføringen |
escapeExtendedChars | boolean | true | Escape utvidede Unicode-tegn (ikke-ASCII) i utdata ved hjelp av \uXXXX-notasjon |
extraComments | boolean | false | Gjenkjenn kommentstiler med semikolon og dobbelt skråstrek i tillegg til standard #- og !-markører |
extractNonTranslatableContent | boolean | true | Vis verditeksten til ekskluderte oppføringer (nøkler filtrert ut, eller under #_skip / #_bskip) som ikke-oversettbart innhold som er synlig for innlasting, men hoppes over av oversettelsen |
extractOnlyMatchingKey | boolean | true | Når aktivert, ekstraheres bare oppføringer hvis nøkler samsvarer med betingelsen; ellers utelates samsvarende nøkler |
keyCondition | string | .*text.* | Regulært uttrykksmønster som testes mot egenskapsnøkler for ekstraksjonsfiltreringen |
separator | string | = | Nøkkel-verdi-skilletegn (vanligvis «=» eller «:») |
useCodeFinder | boolean | false | Aktiver regex-basert deteksjon av innebygd kode i egenskapsverdier |
useJavaEscapes | boolean | false | Behold Java-egenskapens escape-sekvenser (\: \= \# \!) i ekstrahert tekst i stedet for å løse dem opp |
useKeyCondition | boolean | false | Filtrer oppføringer for uttrekk basert på en regex-betingelse anvendt på nøklene deres |
Configure it live
Examples
Translate only label keys
Extract only entries whose keys contain "label".
useKeyCondition: true
keyCondition: ".*label.*"
extractOnlyMatchingKey: true
UTF-8 output
Emit characters literally instead of \uXXXX escapes.
escapeExtendedChars: false
Processing notes
Each entry's value becomes a translatable block; keys, separators, and comments form the non-translatable skeleton.
Multi-line values continued with a trailing backslash are joined per the properties format.
Limitations
The key filter is a single regex applied to each key; there is no per-pattern routing of values to different handlers.
← Back to the Format Reference