Cara Menerjemahkan File CSV Tanpa Merusak Kolom

Equalang

Secara singkat

Terjemahkan file CSV ke bahasa Indonesia atau bahasa lain tanpa kolom bergeser akibat koma atau tanda kutip. Konversi ke XLSX dulu atau ekstrak kolom teks.

Kata kunci: cara menerjemahkan file csv; terjemahkan file csv ke bahasa indonesia; translate file csv online; translate file csv gratis; perataan kolom terjemahan csv

Menerjemahkan file CSV mentah secara langsung sebagai teks biasa hampir selalu merusak struktur tabelnya. Karena file CSV mengandalkan tanda koma, jeda baris (line break), dan tanda kutip ganda untuk menandai batas awal dan akhir setiap sel, satu koma tambahan dalam kalimat terjemahan—atau desimal seperti 12.50 yang berubah menjadi 12,50—akan membelah satu kolom menjadi dua dan menggeser seluruh kolom berikutnya ke kanan.

Untuk menerjemahkan file CSV ke bahasa Indonesia atau bahasa lain tanpa merusak data, Anda harus memisahkan batas sel dari teks di dalam sel sebelum proses penerjemahan dilakukan. Ada dua cara andal untuk melakukannya: mengonversi file CSV menjadi buku kerja Excel (.xlsx) agar setiap bidang terkunci rapat di dalam sel spreadsheet, atau mengekstrak kolom teks saja berdasarkan ID baris menggunakan skrip.

Mengapa File CSV Mentah Rusak di Penerjemah Teks Biasa?

Berdasarkan spesifikasi standar format CSV (RFC 4180), file CSV tidak memiliki garis kisi tersembunyi—melainkan murni tersusun dari karakter teks:

  • Setiap kolom dipisahkan oleh tanda koma (,), dan setiap baris data dipisahkan oleh jeda baris (CRLF atau LF).
  • Setiap bidang yang memuat koma, jeda baris, atau tanda kutip ganda (") wajib diapit oleh tanda kutip ganda.
  • Tanda kutip ganda literal di dalam bidang yang diapit kutipan harus di-escape dengan cara menggandakannya ("").

Ketika Anda menempelkan teks CSV mentah ke alat penerjemah biasa atau mengunggah file .csv yang diubah ekstensinya menjadi .txt, mesin penerjemah membaca baris tersebut sebagai kalimat biasa, bukan data terstruktur. Tiga kegagalan struktural akan langsung terjadi:

  1. Koma tanpa tanda kutip dalam teks terjemahan: Frasa sumber yang tidak memiliki koma (seperti "Versandkostenfrei ab 50 EUR" atau teks tanpa kutip Livraison gratuite dès 50 EUR) diterjemahkan menjadi "Free shipping, orders over 50 EUR". Jika bidang asli tidak diapit tanda kutip, koma baru tersebut langsung menciptakan kolom tambahan pada baris tersebut.
  2. Penyesuaian lokal format angka dan desimal: Menerjemahkan ke bahasa seperti Jerman, Prancis, atau Spanyol kerap mengubah angka desimal 12.50 menjadi 12,50 atau 1,200 menjadi 1.200. Pada kolom numerik tanpa tanda kutip, 12,50 terbelah menjadi dua kolom terpisah (12 dan 50), sehingga kode SKU produk, jumlah stok, dan stempel waktu bergeser satu kolom ke kanan.
  3. Tanda kutip rusak dan tanda kutip tipografi lengkung: Mesin penerjemah sering mengganti tanda kutip ganda lurus ("") dengan tanda kutip lengkung tipografi (“” atau « »), atau menghilangkan tanda kutip penutup pada deskripsi produk multibaris. Begitu pasangan tanda kutip rusak, parser CSV akan menggabungkan ratusan baris berikutnya ke dalam satu sel raksasa yang kacau.

File CSV asli (3 kolom: sku, title, price_usd):

SKU-104,Wireless mouse with USB receiver,24.99

Hasil rusak setelah diterjemahkan sebagai teks biasa (menjadi 4 kolom):

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

Metode 1: Konversi CSV ke XLSX, Terjemahkan Per Sel, dan Ekspor Kembali ke CSV

Untuk katalog produk, data survei, tabel lokalisasi aplikasi, dan laporan keuangan, alur kerja yang paling rapi adalah mengonversi file .csv ke buku kerja Excel (.xlsx) terlebih dahulu, menerjemahkan file .xlsx agar setiap sel tetap terisolasi, lalu menyimpan lembar kerja yang selesai kembali ke format CSV UTF-8.

Kami mencontohkan langkah ini menggunakan terjemahan dokumen Equalang. Perlu dipahami batasan formatnya sejak awal: Equalang mendukung PDF, DOCX, PPTX, XLSX, EPUB, HTML, dan TXT—tetapi tidak menerima file .csv secara langsung. Mengonversi .csv ke .xlsx terlebih dahulu merupakan syarat unggah sekaligus mekanisme teknis untuk mencegah karakter pemisah di dalam kalimat merusak struktur kolom Anda.

Langkah 1: Impor CSV ke Editor Spreadsheet dan Simpan sebagai .xlsx

Jangan sekadar mengubah ekstensi file dari .csv menjadi .xlsx melalui pengelola file komputer Anda. Buka atau impor file CSV ke dalam editor spreadsheet seperti Microsoft Excel, LibreOffice Calc, atau Google Sheets agar parser memisahkan kolom dengan tepat, lalu simpan atau ekspor salinannya sebagai buku kerja .xlsx.

Jika CSV Anda memuat karakter non-ASCII (seperti huruf beraksen, aksara Arab, atau Mandarin), gunakan dialog Data > From Text/CSV di Excel dan pastikan asal file (File Origin) diatur ke 65001: Unicode (UTF-8) sebelum memuat data (panduan impor/ekspor teks dan CSV Microsoft Excel). Membuka file CSV UTF-8 tanpa Byte Order Mark (BOM) dengan klik ganda di beberapa versi Excel dapat menyebabkan karakter terbaca rusak bahkan sebelum Anda menerjemahkannya.

Langkah 2: Terjemahkan File .xlsx

Unggah file .xlsx di Equalang Dokumen dan pilih bahasa target Anda (layanan terjemahan dokumen saat ini mencakup bahasa Indonesia, Inggris, Mandarin, Jepang, Korea, Spanyol, Prancis, dan lainnya, dengan deteksi otomatis bahasa sumber). Anda dapat melihat rincian kalkulasi penggunaan token di halaman harga.

Karena file .xlsx menyimpan setiap bidang sebagai objek sel tersendiri, bukan teks yang dipisahkan koma:

  • Koma dan jeda baris tetap berada di dalam sel: Jika deskripsi produk hasil terjemahan memiliki tambahan tiga koma dan jeda paragraf baru, teks tersebut tetap berada rapi di dalam sel B14.
  • Angka murni dan rumus tidak tersentuh: Sel angka (harga, kuantitas, ID numerik) serta rumus spreadsheet dilewati selama penerjemahan dan ditulis kembali persis seperti aslinya, sehingga 24.99 tetap menjadi 24.99 dan tidak berubah menjadi 24,99.
  • Teks yang berulang hanya diterjemahkan satu kali: Jika nama kategori seperti Electronics atau status In Stock muncul di 2.000 baris, sistem hanya menerjemahkan dan menagihnya satu kali, menjaga konsistensi istilah di seluruh tabel.
Spreadsheet XLSX terjemahan berbahasa Inggris yang mempertahankan struktur kolom, sel numerik, dan total
Tangkapan layar dalam bahasa Inggris ini menunjukkan bagaimana konversi dataset CSV ke XLSX sebelum diterjemahkan di Equalang mengunci setiap teks di selnya sendiri tanpa mengubah angka maupun rumus

Setelah proses penerjemahan selesai, Anda dapat meninjau lembar kerja asli dan lembar kerja terjemahan secara berdampingan di ruang kerja web sebelum mengunduhnya. Untuk panduan mendalam tentang penanganan buku kerja, lihat panduan kami tentang cara menerjemahkan file Excel.

Langkah 3: Periksa Kode Alfanumerik, Lalu Ekspor Kembali ke CSV UTF-8

Sebelum mengekspor kembali ke format .csv, periksa sekilas kolom yang berisi rangkaian alfanumerik—seperti kode SKU (BLK-SM-01), singkatan satuan (pcs), nama produsen, atau label status sistem yang dibaca oleh kode backend. Meskipun angka murni otomatis dilewati, sel teks yang memuat kata atau singkatan bisa saja ikut diterjemahkan (misalnya pcs diterjemahkan menjadi kata lokal untuk buah/biji). Jika sistem database Anda mengharuskan nilai enum bahasa Inggris asli pada kolom tertentu, salin kembali kolom asli tersebut dari file sumber.

Perhatikan juga bahwa nama tab lembar kerja tidak diterjemahkan. Jika Anda menambahkan rumus Excel yang memeriksa teks dalam tanda kutip (seperti =IF(F2="In Stock", 1, 0)), teks di dalam rumus tersebut tetap menggunakan bahasa sumber, jadi sesuaikan kondisi rumus agar cocok dengan isi sel terjemahan sebelum diekspor.

Terakhir, di Excel, pilih File > Save As dan pilih format CSV UTF-8 (Comma delimited) (*.csv). Excel secara otomatis akan membungkus setiap bidang terjemahan yang memuat koma, tanda kutip, atau jeda baris dengan tanda kutip ganda RFC 4180 yang valid.

Metode 2: Pisahkan Kolom Teks Berdasarkan ID Baris dalam Skrip (Untuk Pengembang & Pipeline Otomatis)

Jika file CSV Anda memiliki ratusan ribu baris, berada di dalam pipeline CI/CD otomatis, atau memiliki 40 kolom di mana hanya 2 kolom (product_name dan description) yang perlu diterjemahkan, mengonversi ke .xlsx secara manual tentu tidak efisien.

Dalam alur kerja skrip, jangan pernah memecah baris CSV secara manual (line.split(",")) atau mengirim seluruh baris mentah ke API penerjemah. Gunakan parser RFC 4180 standar—seperti modul bawaan csv di Python—untuk membaca setiap baris ke dalam memori, menerjemahkan indeks kolom yang ditentukan saja, dan membiarkan csv.writer menyusun kembali file keluaran dengan format escaping yang benar.

Berikut adalah pola aman menggunakan Python (menerjemahkan kolom tertentu berdasarkan nama header tanpa menyentuh ID, SKU, URL, maupun harga):

import csv

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

def translate_text(text: str) -> str:
    # Ganti dengan panggilan API penerjemahan Anda untuk nilai satu sel
    if not text.strip():
        return text
    return text  # placeholder

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)

Alasan mengapa pendekatan skrip ini berjalan stabil:

  1. newline="" dan csv.DictReader menangani sel multibaris: Meskipun deskripsi suatu produk memiliki lima baris baru dengan koma di dalamnya dan tanda kutip ganda "", csv.DictReader mengekstraknya sebagai satu string Python yang utuh dan bersih.
  2. Kolom non-teks tidak pernah tersentuh: Kolom seperti id, sku, price, image_url, dan created_at dilewati sepenuhnya, menghilangkan risiko rusaknya URL atau bergesernya tanda desimal.
  3. csv.DictWriter menambahkan tanda kutip secara otomatis: Saat teks terjemahan kembali dengan koma atau tanda kutip baru, konfigurasi csv.QUOTE_MINIMAL otomatis membungkus teks tersebut dalam "..." dan menggandakan tanda kutip internal sesuai standar RFC 4180.

Jika Anda lebih memilih solusi rumus lembar kerja untuk file kecil (beberapa ratus baris), Anda juga dapat mengimpor CSV ke Google Sheets dan menggunakan rumus =GOOGLETRANSLATE(B2, "auto", "id") pada kolom bantuan, lalu menyalin dan menempelkan nilai (paste values) sebelum mengunduhnya kembali sebagai .csv. Ingatlah bahwa rumus spreadsheet memicu satu permintaan per baris dan dapat mengalami timeout atau limit jika dijalankan pada ribuan baris.

Perbandingan Cepat: Alur Kerja Mana yang Sesuai untuk File CSV Anda?

SkenarioAlur Kerja yang DirekomendasikanHal yang Perlu Diperhatikan
100 hingga 50.000 baris, kombinasi teks dan angka, banyak label kategori berulangKonversi .csv → .xlsx, terjemahkan di Equalang, lalu ekspor kembali ke CSV UTF-8Salin kembali kolom SKU/enum alfanumerik jika software hilir membutuhkan teks asli yang persis
Di bawah 200 baris, kebutuhan cepat satu kali jalanBuka di Google Sheets, gunakan rumus =GOOGLETRANSLATE() di kolom bantuan, ekspor sebagai CSVRumus terus menghitung ulang dan rentan timeout pada data besar; tempel nilai sebelum mengekspor
Pipeline backend otomatis atau dataset sangat besar (100k+ baris)Baca dengan csv.DictReader di Python, terjemahkan kolom teks yang ditentukan, tulis dengan csv.DictWriterSimpan string unik dalam dictionary lokal sebelum memanggil API untuk menghindari biaya terjemahan berulang

Pertanyaan yang Sering Diajukan

Bisakah saya mengunggah file .csv langsung ke Equalang?

Tidak. Layanan terjemahan dokumen Equalang menerima format PDF, DOCX, PPTX, XLSX, EPUB, HTML, dan TXT, serta tidak mendukung file berekstensi .csv secara langsung. Buka file CSV di Excel atau editor spreadsheet lain, simpan sebagai .xlsx, terjemahkan file .xlsx tersebut, lalu simpan kembali hasil terjemahan ke format CSV UTF-8.

Bagaimana cara mencegah Excel mengubah karakter terjemahan menjadi simbol aneh (seperti ??? atau é)?

Selalu simpan dan buka file CSV Anda sebagai CSV UTF-8 (Comma delimited). Saat membuka file CSV UTF-8 di Microsoft Excel pada Windows, jika klik ganda menampilkan teks yang berantakan, buka lembar kerja kosong lalu gunakan menu Data > From Text/CSV dan pilih File Origin 65001: Unicode (UTF-8).

Mengapa kolom angka atau harga bergeser setelah menerjemahkan CSV?

Jika Anda menerjemahkan file CSV sebagai teks biasa ke bahasa yang menggunakan tanda koma sebagai pemisah desimal (seperti Jerman, Prancis, atau Spanyol), angka 19.99 kemungkinan besar diubah menjadi 19,99 tanpa tanda kutip ganda pembungkus. Mengonversi CSV ke .xlsx sebelum diterjemahkan memastikan sel numerik tetap tersimpan sebagai tipe data angka, sehingga dilewati oleh sistem penerjemah dan tidak berubah.

Sumber Rujukan