Gå til hovedinnhold

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.

IDproperties
SourceBuilt-in
Extensions.properties
MIME Typestext/x-java-properties
CapabilitiesRead + Write

How kapi reads it

Parameters

ParameterTypeDefaultDescription
codeFinderRulesarrayRegex-mønstre som matcher innebygde koder i oversettbar tekst
commentsAreNotesbooleantrueBehandle kommentarer som oversetternotater knyttet til den følgende oppføringen
escapeExtendedCharsbooleantrueEscape utvidede Unicode-tegn (ikke-ASCII) i utdata ved hjelp av \uXXXX-notasjon
extraCommentsbooleanfalseGjenkjenn kommentstiler med semikolon og dobbelt skråstrek i tillegg til standard #- og !-markører
extractNonTranslatableContentbooleantrueVis 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
extractOnlyMatchingKeybooleantrueNår aktivert, ekstraheres bare oppføringer hvis nøkler samsvarer med betingelsen; ellers utelates samsvarende nøkler
keyConditionstring.*text.*Regulært uttrykksmønster som testes mot egenskapsnøkler for ekstraksjonsfiltreringen
separatorstring=Nøkkel-verdi-skilletegn (vanligvis «=» eller «:»)
useCodeFinderbooleanfalseAktiver regex-basert deteksjon av innebygd kode i egenskapsverdier
useJavaEscapesbooleanfalseBehold Java-egenskapens escape-sekvenser (\: \= \# \!) i ekstrahert tekst i stedet for å løse dem opp
useKeyConditionbooleanfalseFiltrer oppføringer for uttrekk basert på en regex-betingelse anvendt på nøklene deres

Configure it live

Configuration
Loading form…

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