CLAUDE.md#claude-md #i18n #locale #tuzak #türkçe

Türkçe projelerde locale tuzakları

Türkçe karakterler yüzünden sessizce bozulan kod parçaları: i/I dönüşümü, sıralama, arama, slug üretimi. CLAUDE.md'ye konunca Claude bu hataları baştan yapmaz.

yazan kuscubasiece·8 Eylül 2026

Kaynak: MDN

Kurulum

curl -sL https://www.antrophiclove.com/api/kaynak/turkce-projelerde-locale-tuzaklari/raw

Bu içerik mevcut dosyaya elle harmanlanmalı: CLAUDE.md

Önizleme Ham metin ⑂ Kendi sürümünü oluştur

# CLAUDE.md'ye ekle

## Türkçe locale kuralları

### Büyük/küçük harf
JavaScript'te `toLowerCase()` Türkçe'de yanlış çalışır:
  "IST".toLowerCase()               -> "ist"   (beklenen "ıst")
  "İSTANBUL".toLowerCase()          -> "i̇stanbul" (birleşik nokta!)

Kullanıcı metnini karşılaştırırken:
  a.toLocaleLowerCase("tr") === b.toLocaleLowerCase("tr")

Ama teknik değerlerde (e-posta, slug, HTTP başlığı, dosya uzantısı)
ASLA "tr" locale kullanma — orada `toLowerCase()` doğrudur:
  email.toLowerCase()   ✓
  email.toLocaleLowerCase("tr")   ✗  ("I" -> "ı" olur, eşleşme kırılır)

### Sıralama
  liste.sort()                       ✗ Ç, Ğ, İ, Ö, Ş, Ü sona atılır
  liste.sort((a, b) => a.localeCompare(b, "tr"))   ✓

### Arama ve filtreleme
Kullanıcı "sarı" yazıp "SARI" bulmalı:
  const norm = (s) => s.toLocaleLowerCase("tr").normalize("NFC");

### Slug üretimi
Türkçe harfler NFD ile ayrışmaz, elle eşle:
  const MAP = { ç:"c", ğ:"g", ı:"i", ö:"o", ş:"s", ü:"u",
                Ç:"c", Ğ:"g", İ:"i", I:"i", Ö:"o", Ş:"s", Ü:"u" };

Dikkat: "I" -> "i" ve "İ" -> "i" ikisi de i'ye gider, çakışma olabilir.

### PostgreSQL
Tam metin arama için 'turkish' sözlüğü mevcut:
  to_tsvector('turkish', metin)
Sıralamada:
  ORDER BY ad COLLATE "tr-TR"

### Tarih ve sayı
  new Intl.NumberFormat("tr-TR").format(2410)      -> "2.410"
  new Intl.DateTimeFormat("tr-TR").format(d)
Binlik ayırıcı nokta, ondalık virgüldür; CSV üretirken ayırıcıyı
noktalı virgül yap yoksa Excel sütunları bozar.