Gå til hovedinnhold

CSV format (.csv)

The CSV format reads comma-separated value files, extracts selected columns as translatable blocks, and writes the translations back into the same rows. It handles quoted fields containing delimiters or newlines and optional header rows. The same implementation backs the tab-separated TSV format with a tab delimiter.

By default the first row is treated as a header and every data column is translatable. You can restrict extraction to specific columns, designate key columns that supply each block's ID, mark comment columns whose values become notes, and tune the delimiter, quote character, and row offsets.

IDcsv
SourceBuilt-in
Extensions.csv
MIME Typestext/csv
CapabilitiesRead + Write

Parameters

ParameterTypeDefaultDescription
codeFinderRulesarrayRegex-mønstre som samsvarer med innebygde koder i oversettbar tekst
columnNamesRowinteger01-basert radnummer som inneholder kolonnenavn. 0 betyr automatisk gjenkjenning.
columnsobjectKolonnerolletilordning for tospråklige oversettelsetabeller: et objekt med 0-baserte kolonneindekser for nøkkel, kilde og mål (f.eks. {key: 0, source: 1, target: 2}). Ved sammenslåing skrives bare målkolonnen om.
commentColumnsarrayKolonneindekser (0-basert) som inneholder kommentarer eller notater
extractNonTranslatableContentbooleantrueHvis sann (standard), vises ikke-oversettbart kontekstuelt innhold som innledningsrader og ikke-oversettbare kolonnceller som innholdsblokker (synlig for innlesing/LLM-konsumenter, hoppes over av maskinoversettelse) i stedet for ugjennomsiktige datadeler. Deaktiver for å beholde det som vanlige datadeler.
hasHeaderbooleantrueHvis sann, behandles første rad som overskrifter (ikke oversettbare)
keyColumnsarrayKolonneindekser (0-basert) som angir blokk-ID (kilde-ID / post-ID)
separatorstring,Feltavgrensingstegn (komma for CSV, tabulator for TSV)
textQualifierstring"Tegn brukt til å omslutte feltverdier som inneholder skilletegn eller linjeskift
translatableColumnsarrayKolonneindekser (0-basert) som skal trekkes ut som oversettbart innhold. Hvis tom, er alle kolonner oversettbare.
trimValuesbooleanfalseHvis sant, fjernes innledende og avsluttende mellomrom fra celleverdier
useCodeFinderbooleanfalseAktiver regex-basert gjenkjenning av innebygd kode i celleverdier
valuesStartRowinteger01-basert radnummer der dataverdier begynner. 0 betyr automatisk gjenkjenning.

Configure it live

Configuration
Loading form…

Examples

Translate one column, keyed by another

Extract column 2, using column 0 as the record ID.

translatableColumns:
- 2
keyColumns:
- 0

Headerless semicolon-delimited file

Read a file with no header row and a semicolon delimiter.

separator: ";"
hasHeader: false

Processing notes

  • Each selected cell becomes a translatable block; row structure, delimiters, and quoting form the non-translatable skeleton.

  • Key columns supply IDs and comment columns supply notes; they are not themselves extracted as translatable content.

Limitations

  • Column selection is index-based; columns are not addressed by header name.

← Back to the Format Reference