Markdown format (.md, .markdown)
Markdown-formatet leser Markdown-dokumenter, trekker ut prosa som blokker, og skriver oversettelsene tilbake mens det bevarer dokumentets struktur: overskrifter, lister, uthevinger, lenker og kode. Inline- markering (fet, kursiv, lenker, inline-kode) eksponeres som inline-koder inne i hver blokk slik at den omkringliggende syntaksen overlever oversettelsen.
Som standard er avsnitt, overskrifter, listeelementer, blokksitering og bildetekst blokker, mens kodeblokker, YAML-frontmatter, rå HTML-blokker og lenke-/bilde-URLer behandles som ikke-oversettbar struktur. Hver av disse kategoriene kan slås av og på, og innebygd HTML kan rutes til et underfilter.
How kapi reads it
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
codeFinderRules | array | Regex-mønstre som samsvarer med innebygde koder i oversettbar tekst | |
extractNonTranslatableContent | boolean | true | Hvis sann (standard), vises ikke-oversettbart kontekstuelt innhold som kodeblokker som innholdsblokker (synlig for innlesing/LLM-konsumenter, hoppes over av maskinoversettelse) i stedet for å være skjult i skjelett. Deaktiver for å beholde det i skjelett. |
frontMatterKeys | array | Nøkler i frontmatter som skal trekkes ut når translateFrontMatter er på (tom = alle skalarverdier). Angi nøklene som inneholder prosa, f.eks. title og description. | |
subfilter | string | Underfilterformat som skal brukes på HTML-innhold i Markdown (f.eks. 'html') | |
translateBlockQuotes | boolean | true | Hvis sann, er blokksitatinnhold oversettbart. |
translateCodeBlocks | boolean | false | Hvis sann, er gjerdet og innrykket kodeblokker oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data. |
translateFrontMatter | boolean | false | Hvis sann, er YAML front matter-verdier oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data. |
translateHTMLBlocks | boolean | false | Hvis sann, er rå HTML-blokker oversettbare. Hvis usann, sendes de ut som ikke-oversettbare data. |
translateImageAlt | boolean | true | Hvis sann, inkluderes alt-tekst for bilder i det oversettbare innholdet. |
translateURLs | boolean | false | Hvis sann, er lenke- og bilde-URL-er oversettbare. |
unescapeBackslashCharacters | boolean | false | Analyser omvendt skråstrek-escaped tegnsetting i kildedokumenter |
useCodeFinder | boolean | false | Aktiver regex-basert deteksjon av innebygd kode i oversettbar tekst |
Configure it live
Examples
Oversett frontmater også
Inkluder YAML front matter-verdier sammen med prosaen.
translateFrontMatter: true
Håndter innebygd HTML strukturelt
Rut inline- og blokk-HTML gjennom HTML-underfilteret.
subfilter: html
Processing notes
Inline-merking (uthevelse, koblinger, inline-kode) blir inline-koder inne i blokker, slik at den overlever oversettelse uendret.
Strukturelle elementer (gjerder, listeindikatorer, overskriftprefikser) danner det ikke-oversettbare skjelettet.
Limitations
Kodeblokker, frontmater, rå HTML-blokker og URLer er ikke-oversettbare som standard; aktiver det tilsvarende alternativet for å trekke dem ut.
← Back to the Format Reference