CSV-bestand vertalen zonder dat kolommen verschuiven

Equalang

Kort samengevat

Vertaal een CSV-bestand naar het Engels of andere talen zonder dat extra komma's of aanhalingstekens kolommen verschuiven. Converteer eerst naar XLSX of filter tekstkolommen.

Trefwoorden: csv bestand vertalen; csv vertalen naar engels; csv bestand online vertalen; csv vertaling kolommen behouden; csv vertalen excel

Een CSV-bestand direct als platte tekst vertalen leidt vrijwel altijd tot verschoven kolommen. Omdat een CSV-bestand afhankelijk is van standaardkomma's, regeleinden en dubbele aanhalingstekens om te bepalen waar een cel begint en eindigt, splitst elke komma die in een vertaalde zin wordt toegevoegd—of een decimaal getal zoals 12.50 dat lokaal wordt omgezet naar 12,50—één veld in tweeën, waardoor alle volgende kolommen uit het gelid raken.

Om een CSV-bestand naar het Engels of een andere taal te vertalen zonder dat uw gegevensstructuur beschadigd raakt, moet u de celgrenzen scheiden van de tekst in elke cel voordat de vertaling plaatsvindt. Hieronder staan de twee betrouwbare manieren om dit aan te pakken: het CSV-bestand omzetten naar een .xlsx-werkmap zodat elk veld veilig in een spreadsheetcel staat opgesloten, of via een script uitsluitend de tekstkolommen extraheren op basis van kolomnamen of rij-ID's.

Waarom ongecodeerde CSV-bestanden kapotgaan in tekstvertalers

Volgens de officiële CSV-specificatie (RFC 4180) heeft een CSV-bestand geen onzichtbare rasterlijnen, maar uitsluitend platte tekens:

  • Velden worden gescheiden door komma's (,) en rijen worden gescheiden door regeleinden (CRLF of LF).
  • Elk veld dat een komma, een regeleinde of een dubbel aanhalingsteken (") bevat, moet tussen dubbele aanhalingstekens staan.
  • Een dubbel aanhalingsteken binnen een geciteerd veld moet worden geëscapet door het te verdubbelen ("").

Wanneer u een CSV rechtstreeks in een algemene vertaaltool plakt of een .csv-bestand hernoemd naar .txt uploadt, leest de vertaler elke regel als een gewone zin in plaats van als een gestructureerde tabelrij. Dit leidt direct tot drie veelvoorkomende fouten:

  1. Niet-geëscapete komma's in de vertaling: Een brontekst zonder komma ("Versandkostenfrei ab 50 EUR" of een niet-geciteerd veld Livraison gratuite dès 50 EUR) vertaalt bijvoorbeeld naar "Gratis verzending, vanaf 50 EUR". Als het oorspronkelijke veld niet tussen aanhalingstekens stond, zorgt die nieuwe komma direct voor een extra kolom op die rij.
  2. Gelokaliseerde getallen en decimalen: Bij vertalingen naar talen zoals het Nederlands, Duits, Frans of Spaans wordt 12.50 vaak aangepast naar 12,50 en 1,200 naar 1.200. In een numerieke kolom zonder aanhalingstekens splitst 12,50 direct in twee kolommen (12 en 50), waardoor artikelnummers (SKU's), voorraadcijfers en tijdstempels één positie naar rechts opschuiven.
  3. Verbroken aanhalingstekens en typografische tekens: Vertaalsystemen vervangen rechte ASCII-aanhalingstekens ("") dikwijls door gekrulde aanhalingstekens (“” of « »), of laten het sluitteken bij een lange productbeschrijving weg. Zodra een aanhalingstekenpaar breekt, voegt de CSV-parser honderden opeenvolgende rijen samen tot één gigantische cel.

Originele CSV (3 kolommen: sku, title, price_usd):

SKU-104,Wireless mouse with USB receiver,24.99

Beschadigde uitvoer na tekstvertaling (4 kolommen in plaats van 3 door de toegevoegde komma en decimale komma):

SKU-104,Souris sans fil, avec récepteur USB,24,99

Methode 1: CSV converteren naar XLSX, cel voor cel vertalen en exporteren naar CSV

Voor productcatalogi, enquêteresultaten, lokalisatietabellen en financiële overzichten is de meest ordelijke werkwijze om uw .csv eerst om te zetten in een Excel-werkmap (.xlsx), het .xlsx-bestand te vertalen zodat elke cel geïsoleerd blijft, en het voltooide blad weer op te slaan als UTF-8 CSV.

We tonen deze stap met Equalang documentvertaling. Let vooraf op een belangrijke randvoorwaarde: Equalang ondersteunt PDF, DOCX, PPTX, XLSX, EPUB, HTML en TXT, maar accepteert geen rechtstreekse .csv-bestanden. Het vooraf converteren van .csv naar .xlsx is zowel een vereiste voor het uploaden als de garantie dat leestekens binnen een zin de kolomstructuur niet kunnen verstoren.

Stap 1: De CSV importeren in een spreadsheetprogramma en opslaan als .xlsx

Wijzig niet simpelweg de bestandsextensie van .csv naar .xlsx in uw bestandsbeheerder. Open of importeer de CSV in een spreadsheetprogramma zoals Microsoft Excel, LibreOffice Calc of Google Spreadsheets zodat de parser de kolommen correct scheidt, en sla het bestand vervolgens op als een .xlsx-werkmap.

Als uw CSV niet-ASCII-tekens bevat (zoals Chinese tekens, Arabisch of Europese letters met accenten), gebruik dan in Excel de importfunctie via Gegevens > Van tekst/CSV en controleer of de bestandsoorsprong is ingesteld op 65001: Unicode (UTF-8) voordat u de gegevens laadt (zie de handleiding voor importeren en exporteren van tekst- en CSV-bestanden in Microsoft Excel). Als u in oudere Excel-versies dubbelklikt op een UTF-8 CSV zonder Byte Order Mark (BOM), kunnen speciale tekens al verminkt raken voordat u überhaupt begint met vertalen.

Stap 2: Het .xlsx-bestand vertalen

Upload het .xlsx-bestand via Equalang Documenten en kies de gewenste doeltaal (documentvertaling ondersteunt onder meer Chinees, Engels, Japans, Koreaans, Spaans en Frans, met automatische herkenning van de brontaal). U kunt de berekening van het tokenverbruik bekijken op de prijzenpagina.

Omdat een .xlsx-bestand elk veld opslaat als een afzonderlijk celobject in plaats van door komma's gescheiden tekst:

  • Komma's en regeleinden blijven netjes in de cel: Als een vertaalde productomschrijving drie nieuwe komma's en een alinea-einde bevat, blijft alle tekst binnen cel B14.
  • Zuivere getallen en formules blijven onaangeroerd: Numerieke cellen (prijzen, aantallen, numerieke id's) en spreadsheetformules worden tijdens de vertaling overgeslagen en ongewijzigd weggeschreven, waardoor 24.99 altijd 24.99 blijft en niet verandert in 24,99.
  • Herhalende strings worden eenmalig vertaald: Als een categorienaam zoals Electronics of een status zoals In Stock in 2.000 rijen voorkomt, wordt deze consistent vertaald zonder onnodig herhaald verbruik.
Vertaald Engelstalig XLSX-werkblad met behoud van kolomstructuur, numerieke cellen en totalen
Het Engelstalige voorbeeldscherm toont hoe een naar XLSX geconverteerde CSV-tabel na vertaling op Equalang alle tekstvelden in afzonderlijke cellen vasthoudt terwijl getallen en formules ongewijzigd blijven

Zodra de verwerking is voltooid, kunt u de oorspronkelijke en vertaalde tabellen naast elkaar vergelijken in de online werkomgeving voordat u het bestand downloadt. Raadpleeg voor een uitgebreide toelichting onze handleiding over het vertalen van een Excel-bestand.

Stap 3: Alfanumerieke codes controleren en exporteren naar UTF-8 CSV

Controleer vóór het exporteren naar .csv de kolommen met alfanumerieke tekenreeksen—zoals artikelcodes (BLK-SM-01), eenheidsafkortingen (pcs), merknamen of statussen die door software worden uitgelezen. Terwijl zuivere getallen automatisch worden overgeslagen, kunnen cellen met woorden of afkortingen worden vertaald (zo kan pcs bijvoorbeeld vertaald worden naar de doeltaalvariant van stuks). Als uw database-import strikte Engelse waarden vereist in een specifieke kolom, kopieert u die oorspronkelijke kolom eenvoudig terug uit het bronbestand.

Houd er daarnaast rekening mee dat namen van werkbladtabbladen niet worden vertaald. Hebt u formules gebruikt die letterlijke tekst tussen aanhalingstekens controleren (zoals =ALS(F2="In Stock"; 1; 0)), dan blijft die voorwaarde in de brontaal staan. Werk dergelijke formulevoorwaarden bij zodat ze overeenkomen met de vertaalde celinhoud voordat u exporteert.

Kies ten slotte in Excel Bestand > Opslaan als en selecteer CSV UTF-8 (door komma's gescheiden) (*.csv). Excel plaatst automatisch geldige dubbele aanhalingstekens volgens RFC 4180 om elk vertaald veld dat komma's, aanhalingstekens of regeleinden bevat.

Methode 2: Tekstkolommen extraheren via een script (voor ontwikkelaars en CLI-pipelines)

Heeft uw CSV-bestand honderdduizenden rijen, draait het in een geautomatiseerde CI/CD-pipeline of telt de tabel 40 kolommen waarvan er slechts 2 (product_name en description) vertaald moeten worden, dan is handmatig omzetten naar .xlsx niet praktisch.

Stuur in een geautomatiseerde workflow nooit ruwe CSV-regels rechtstreeks naar een API of taalmodel. Gebruik in plaats daarvan een volwaardige RFC 4180 CSV-parser—zoals de ingebouwde csv-module in Python—om elke rij in het geheugen in te lezen, vertaal uitsluitend de gewenste kolommen en laat csv.writer de uitvoer wegschrijven met de juiste escaping.

Hieronder ziet u het veilige Python-patroon (waarbij uitsluitend specifieke tekstkolommen op basis van veldnamen worden vertaald en id's, SKU's, URL's en prijzen ongemoeid blijven):

import csv

SOURCE_FILE = "catalog_source.csv"
OUTPUT_FILE = "catalog_nl.csv"
COLUMNS_TO_TRANSLATE = {"title", "description"}

def translate_text(text: str) -> str:
    # Vervang door uw eigen vertaal-API-aanroep voor een afzonderlijke celwaarde
    if not text.strip():
        return text
    return text  # plaatshouder

with open(SOURCE_FILE, mode="r", encoding="utf-8-sig", newline="") as infile, \
     open(OUTPUT_FILE, mode="w", encoding="utf-8", newline="") as outfile:

    reader = csv.DictReader(infile)
    writer = csv.DictWriter(
        outfile,
        fieldnames=reader.fieldnames,
        quoting=csv.QUOTE_MINIMAL
    )
    writer.writeheader()

    for row in reader:
        for col in COLUMNS_TO_TRANSLATE:
            if col in row and row[col]:
                row[col] = translate_text(row[col])
        writer.writerow(row)

Waarom deze aanpak werkt:

  1. newline="" en csv.DictReader verwerken cellen met meerdere regels: Zelfs als een productomschrijving vijf regels beslaat met interne komma's en geëscapete ""-tekens, levert csv.DictReader één zuivere Python-tekenreeks op voor die cel.
  2. Niet-te-vertalen kolommen blijven onaangeroerd: Kolommen zoals id, sku, price, image_url en created_at passeren de vertaalfunctie niet, waardoor er geen risico is op verminkte URL's of ongewenste decimale komma's.
  3. csv.DictWriter plaatst aanhalingstekens automatisch terug: Zodra de vertaalde tekst nieuwe komma's of aanhalingstekens bevat, zorgt csv.QUOTE_MINIMAL ervoor dat het veld tussen "..." wordt geplaatst en dat interne aanhalingstekens worden verdubbeld volgens RFC 4180.

Als u voor kleine bestanden (tot een paar honderd rijen) liever zonder code werkt, kunt u de CSV importeren in Google Spreadsheets en een formule zoals =GOOGLETRANSLATE(B2; "auto"; "nl") in een hulpkolom gebruiken. Kopieer daarna de kolom en kies 'Plakken als waarden' voordat u het bestand downloadt als .csv. Houd er rekening mee dat spreadsheetformules per rij een verzoek sturen en bij duizenden rijen kunnen vastlopen of een time-out geven.

Vergelijking: welke aanpak past bij uw CSV-bestand?

SituatieAanbevolen werkwijzeAandachtspunten
100 tot 50.000 rijen, gemengde tekst- en getalkolommen, herhaalde categorielabelsConverteer .csv → .xlsx, vertaal via Equalang, exporteer terug naar UTF-8 CSVKopieer alfanumerieke SKU- of enum-kolommen terug als downstream software exacte bronwaarden vereist
Minder dan 200 rijen, snelle eenmalige controleOpen in Google Spreadsheets, gebruik =GOOGLETRANSLATE() in een hulpkolom, exporteer als CSVFormules herberekenen voortdurend en haperen bij grotere bestanden; plak als waarden vóór export
Geautomatiseerde backend-pipeline of zeer grote datasets (100k+ rijen)Parseer met Python csv.DictReader, vertaal alleen specifieke tekstkolommen, schrijf weg met csv.DictWriterSla herhaalde zinnen lokaal op in een cache om dubbele API-aanroepen voor identieke rijen te voorkomen

Veelgestelde vragen

Kan ik een .csv-bestand rechtstreeks uploaden naar Equalang?

Nee. De documentvertaler van Equalang ondersteunt PDF, DOCX, PPTX, XLSX, EPUB, HTML en TXT, maar accepteert geen rechtstreekse .csv-bestanden. Open de CSV in Excel of een ander spreadsheetprogramma, sla het op als .xlsx, vertaal het .xlsx-bestand en sla het resultaat vervolgens weer op als UTF-8 CSV.

Hoe voorkom ik dat Excel vertaalde tekens verandert in vreemde symbolen (??? of é)?

Sla uw CSV altijd op als CSV UTF-8 (door komma's gescheiden). Als dubbelklikken in Microsoft Excel op Windows vreemde tekens oplevert, open dan een lege werkmap en gebruik Gegevens > Van tekst/CSV waarbij u de bestandsoorsprong instelt op 65001: Unicode (UTF-8).

Waarom zijn mijn getalkolommen of prijzen verschoven na het vertalen van een CSV?

Als u de CSV als platte tekst hebt vertaald naar een taal die een komma gebruikt als decimaalteken (zoals het Nederlands, Frans, Duits of Spaans), is 19.99 waarschijnlijk veranderd in 19,99 zonder omsluitende dubbele aanhalingstekens. Door de CSV voor vertaling naar .xlsx om te zetten, blijven getallen opgeslagen als numerieke waarden, waardoor de vertaler ze automatisch overslaat en ze exact hetzelfde blijven.

Bronnen