Lihat sumber Membuat Kamus untuk KOReader

Panduan ini menjelaskan cara mengonversi file '''TXT''' (tab-separated) menjadi format kamus Stardict ('''.ifo''', ''`.idx`'', ''`.dict.dz`'') yang dapat digunakan di '''[[KOReader]]'''.

== Prasyarat Instalasi ==
Pastikan kamu menginstal semua perangkat lunak yang dibutuhkan:
<pre>
sudo apt update
sudo apt install pyglossary sed gzip
</pre>

== Langkah 1: Konversi TXT ke CSV ==
Jika file kamus kamu adalah '''TXT''' dengan tab (''`\t`'') sebagai pemisah, kita perlu mengonversinya menjadi '''CSV''' dengan koma sebagai pemisah.

=== Persiapan File TXT ===
Pastikan definisi di dalam kamus kamu tidak mengandung koma. Jika ada koma, ubah koma dalam definisi menjadi tanda strip ''(-)'' menggunakan perintah berikut:
<pre>
sed -i 's/,/-/g' KamusKita.txt
</pre>

=== Ubah Tab menjadi Koma ===
Gunakan perintah berikut untuk mengubah tab (''`\t`'') menjadi koma (''`,`'') dan menyimpan file sebagai '''CSV''':
<pre>
sed 's/\t/,/g' KamusKita.txt > KamusKita.csv
</pre>

=== Cek Hasil CSV ===
Lihat 10 baris pertama file CSV untuk memastikan formatnya benar:
<pre>
head KamusKita.csv
</pre>

Hasilnya akan terlihat seperti ini:
<pre>
cat,An animal commonly kept as a pet with fur whiskers and a tail.
dog,A domesticated carnivorous mammal typically with a long snout.
</pre>

== Langkah 2: Konversi CSV ke Stardict ==
Gunakan [[PyGlossary]] untuk mengonversi file CSV menjadi format Stardict:
<pre>
pyglossary KamusKita.csv KamusKita.ifo --read-format=Csv
</pre>

Setelah proses selesai, kamu akan mendapatkan file:
* '''KamusKita.ifo'''
* '''KamusKita.idx'''
* '''KamusKita.dict'''
* '''KamusKita.syn''' (opsional)

=== Kompres File .dict ===
Agar lebih ringkas, kompres file '''.dict''' menjadi '''.dict.dz''' menggunakan perintah:
<pre>
gzip KamusKita.dict
</pre>

Hasil akhirnya:
* '''KamusKita.ifo'''
* '''KamusKita.idx'''
* '''KamusKita.dict.dz'''
* '''KamusKita.syn'''

== Langkah 3: Tambahkan SourceLang dan TargetLang ==
Agar kamus dapat dikenali dengan baik di [[KOReader]], tambahkan kode bahasa di file '''.ifo'''.

1. Buka file '''.ifo''' dengan teks editor:
   <pre>
   nano KamusKita.ifo
   </pre>

2. Tambahkan baris berikut di bagian atas:
   <pre>
   sourceLang=en
   targetLang=id
   </pre>

'''Penjelasan:'''
* '''sourceLang=en''': Bahasa sumber (misalnya, Inggris)  
* '''targetLang=id''': Bahasa target (misalnya, Indonesia)

3. Simpan dan keluar dari editor.

== Langkah 4: Copy File ke KOReader ==
Pindahkan file-file tersebut ke folder kamus di [[KOReader]]:
<pre>
/KOReader/data/dicts/
</pre>

Jika folder '''dicts''' belum ada, buat folder tersebut secara manual.

== Langkah 5: Aktifkan Kamus di KOReader ==

# Buka '''KOReader'''.  
# Masuk ke '''Settings > Dictionary'''.  
# Pilih '''KamusKita''' dari daftar kamus.

== Langkah 6: Uji Coba Kamus ==

# Buka eBook di KOReader.  
# Tekan dan tahan kata untuk melihat definisinya dari kamus '''KamusKita'''.

== Kesimpulan ==
Dengan langkah-langkah ini, kamu berhasil membuat kamus Stardict dari file TXT dan menggunakannya di [[KOReader]]. Jika ada masalah, pastikan format CSV benar dan '''sourceLang''' serta '''targetLang''' sudah ditambahkan.