Diacritics & Range Mapping
Sumber kode: Source/Core/TextProcessing/ArabicRangeCalculator.swift
Masalah Disparitas Panjang String
Teks Arab memiliki karakter vokal pendek (harakat / tashkeel) yang menempati slot indeks tersendiri dalam pengodean string UTF-16 di platform Apple (NSString / NSRange).
Saat pengguna mengaktifkan atau menonaktifkan tampilan harakat di reader:
- Posisi indeks awal (location) dan panjang (length) dari rentang seleksi teks akan berubah drastis.
- Jika hanya satu
NSRangeyang disimpan, posisi sorotan anotasi akan bergeser (misaligned) ketika mode tampilan harakat dialihkan (toggled).
Ilustrasi Perbandingan Indeks
ArabicRangeCalculator (Class)
Saat pengguna membuat sorotan (highlight) baru, sistem menjalankan fungsi calculateRanges:
func calculateRanges(
for selection: NSRange,
in text: String,
selectedText: String,
diacriticsText: String?,
showHarakat: Bool
) -> (withDiacritics: NSRange, withoutDiacritics: NSRange)
Logika Konversi
-
Jika mode aktif saat ini
showHarakat == true:- Rentang
withDiacriticsdiambil langsung dari nilaiselection. - Teks dinormalisasi dengan menghapus karakter harakat.
- Fungsi
calculateRangeWithoutHarakatmenelusuri pemetaan karakter satu per satu untuk menghitung rentangwithoutDiacritics.
- Rentang
-
Jika mode aktif saat ini
showHarakat == false:- Rentang
withoutDiacriticsdiambil langsung dari nilaiselection. - Sistem mencari letak teks terpilih pada
diacriticsTextasli menggunakan metode pencocokan rentang perkiraan (approximate range matching).
- Rentang
Resolusi Kata Berulang (Duplicate Words)
Salah satu tantangan penting muncul ketika kata yang dianotasi muncul beberapa kali dalam satu halaman (misalnya kata قال atau عن).
Jika hanya mencocokkan string tanpa memperhitungkan offset perkiraan, sistem dapat salah memetakan rentang ke kata yang sama di paragraf lain. Fungsi findRangeInOriginal menggunakan pembobotan jarak terdekat dari selection.location untuk memastikan pemetaan dilakukan pada kata yang tepat.