JSON format (.json)
JSON-formatet leser JSON-dokumenter, trekker ut strengverdier som blokker og skriver de oversatte verdiene tilbake til den samme strukturen. Det er det vanlige formatet for web- og applikasjonsressursfiler (i18next, Chrome-utvidelsesmeldinger, generiske nøkkel/verdi-kataloger).
Som standard trekkes alle nøkkel/verdi-strengpar ut. Derfra kan du begrense uttrekket med et nøkkelunntak eller uttrekksmønster, styre hvordan blikknavn utledes fra nøkler, rute bestemte nøkler til notater, ID-er eller metadata, og sende innebygd markup (HTML inne i en verdi) til et underfilter. To forhåndsinnstillinger er tilgjengelige (Chrome Extension og i18next) som startpunkter for disse oppsettene.
How kapi reads it
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
codeFinderRules | array | Regex-mønstre som samsvarer med innebygde koder i oversettbar tekst. | |
escapeForwardSlashes | boolean | true | Escape skråstreker fremover i utdata-JSON (\/). |
exceptions | string | Regex-mønster for nøkkelnavn. Når extractAllPairs er sann, utelates samsvarende nøkler. Når den er usann, inkluderes samsvarende nøkler. | |
extractAllPairs | boolean | true | Trekk ut alle nøkkel-verdi-par for oversettelse. Når false, bruk extractionRules for å angi hvilke baner som skal trekkes ut. |
extractionRules | string | Regex-mønster for JSON-stier som skal ekstraheres. Overstyrer extractAllPairs når det er angitt. | |
extractIsolatedStrings | boolean | false | Ekstraher strengverdier i matriser (uten nøkler) som oversettbare blokker. |
extractNonTranslatableContent | boolean | true | Hvis sann (standard), vises ikke-oversettbart strenginnhold (isolerte matrisestrengar og verdier ekskludert av uttrekksreglene) som innholdsblokker (synlig for inntak/LLM-konsumenter, hoppes over av maskinoversettelse), i stedet for å skjules i skjelettet. Deaktiver for å holde det i skjelettet. |
genericMetaRules | string | Regex for nøkler hvis verdier blir generiske metadata. | |
idRules | string | Regex for nøkler hvis verdier blir blokk-ID-er (overstyrer useKeyAsName). | |
maxwidthRules | string | Regex for nøkler hvis verdier angir begrensninger for maksimumsbredde. | |
maxwidthSizeUnit | string | pixel | Størrelsesenheten for maxwidth. |
noteRules | string | Regex for nøkler hvis verdier blir oversetternotater. | |
subfilter | string | Globalt delfilterformatnavn (f.eks. 'html') brukt på alle eller samsvarende ekstraherte strenger. | |
subfilterRules | string | Regex-samsvar for nøkler hvis verdier skal behandles med delfilter. | |
subfilters | array | Matrise av {pattern, format}-tilordninger for innebygd innhold i spesifikke nøkler. | |
useCodeFinder | boolean | false | Aktiver mønsterbasert deteksjon av innebygde koder (plassholdere, tagger osv.). |
useFullKeyPath | boolean | false | Bruk full bane (/nøkkel1/nøkkel2) i stedet for umiddelbar nøkkel som navn. |
useIdStack | boolean | false | Bygg TextUnit-IDer fra nestet nøkkelstabel. |
useKeyAsName | boolean | true | Bruk JSON-nøkkel som blokk (TextUnit)-navn for referanse. |
useLeadingSlashOnKeyPath | boolean | true | Inkluder ledende skråstrek i nøkkelbanenavnene. |
Configure it live
Examples
Trekk ut et delsett av nøkler
Oversett bare nøkler under objektene messages og labels.
extractionRules: "/messages/.*|/labels/.*"
Notater fra beskrivelses-nøkler
Legg ved beskrindelsesverdier som oversetternotater (Chrome-utvidelse-stil).
extractAllPairs: false
exceptions: "^message$"
noteRules: "^description$"
HTML inne i verdier
Analyser HTML-markup i verdier hvis nøkkel slutter på _html (i18next-stil).
subfilter: html
subfilterRules: "_html$"
useFullKeyPath: true
Processing notes
Strengverdier blir oversettbare blokker; objekter, arrays og ikke-strenge skalarer danner den omkringliggende ikke-oversettbare strukturen.
Note-, ID-, generisk-metadata- og maks-bredde-regler knyttes til den neste oversettbare blokken i stedet for å produsere eget innhold.
Limitations
Treffmålet for regelbaserte regex-mønstre er enten den umiddelbare nøkkelen eller den fullstendige nøkkelstien, avhengig av
useFullKeyPath– aldri begge.
← Back to the Format Reference