BroadRouter

Uygulama metinlerini LLM ile Arapçaya çevirme: yer tutucular, çoğullar

BroadNet Inference ekibi · 7 dk okuma · Yayımlandı

Metinleri her yer tutucunun bir işaretle değiştirildiği JSON olarak gönderin, altı Arapça çoğul biçiminin (zero, one, two, few, many, other) hepsini isteyin ve ICU çoğul yapısını modelde değil, kodda kurun. CI'da doğrulayın: aynı anahtarlar, aynı argümanlar ve etiketler, altı biçimin hepsi mevcut. Sağdan sola metnin doğru görünmesi için eklenen adları Unicode yalıtımlarıyla sarın.

Bir uygulamanın metin dosyalarını çevirmek, düz yazı çevirmekten farklı bir iştir. Her değer kısadır, çoğu zaman bağlamı yoktur ve modelin dokunmaması gereken sözdizimi taşır: yer tutucular, HTML etiketleri ve çoğul kuralları. Arapça sonuncusunu zorlaştırır. İngilizce dosyalar iki çoğul biçimi tutar; Arapçanın altıya ihtiyacı vardır. Bu yazı OpenAI uyumlu bir LLM üzerinde küçük bir hat kuruyor: yer tutucuları dondurun, altı düz çoğul metin isteyin, ICU sözdizimini kodda kurun, sonra her şeyi CI’da doğrulayın.

Belge, destek talebi ve sözleşme çevirisi için tonu, terim sözlüklerini ve düz yazı değerlendirmesini ele alan LLM’lerle Arapça–İngilizce çeviri yazısına bakın.

Arapça çoğullar makineyle çevrilmiş metin dosyalarını neden bozar?

Intl.PluralRules, ICU ve i18next’in hepsinin izlediği Unicode CLDR, Arapçaya altı sayısal kategori verir:

Kategori CLDR kuralı Örnek sayılar Örnek: “dosya”
zero n = 0 0 لا توجد ملفات
one n = 1 1 ملف واحد
two n = 2 2 ملفان (ikil)
few n % 100 = 3..10 3–10, 103–110 5 ملفات (çoğul)
many n % 100 = 11..99 11–99, 111 11 ملفًا (tekil, nasb hâli)
other geri kalan her şey 100–102, 1000, 0.5 100 ملف (tekil)

İki ayrıntı insanları şaşırtır. Birincisi, kategoriler sayıların kendisi değildir: 103 few, 111 ise many kategorisindedir. İkincisi, İngilizce bir kaynak modele yalnızca one ve other verir; dolayısıyla model dört biçimi yalnızca dil bilgisinden üretmek zorundadır. Hataların çoğu, modelin İngilizce çifti kopyalamasından gelir.

Hata sessizdir. Yalnızca one ve other içeren bir Arapça mesajı intl-messageformat 12.1.5 ile işledik: 0, 2 ve 11 dosyanın hepsi “N ملف” olarak çıktı. i18next 27.1.2, _many anahtarı eksikken aynı şekilde davrandı: 11 dosya _other metnini gösterdi. Hata yok, uyarı yok, yalnızca yanlış Arapça.

Metinler modele nasıl gönderilmeli?

Toplu gönderin. Metin başına bir istek, sistem istemine token harcar ve ilişkili metinler arasındaki bağlamı kaybeder. Her seferinde 50 ila 200 anahtarı, ekrana ya da özelliğe göre gruplanmış bir JSON nesnesi olarak gönderin; böylece “Cancel”ın yanındaki “Save” bir düğme olarak okunur.

Üç kural yanıtı kontrol edilebilir kılar:

  1. Yer tutucuları dondurun. {name}, çift süslü parantezli i18next yer tutucularını, %s, %1$s ve <b> gibi etiketleri ⟦0⟧ gibi işaretlerle değiştirin. Model “Welcome back, ⟦0⟧!” görür ve name’i اسم olarak çeviremez.
  2. Çoğul biçimlerini düz metin olarak isteyin. İngilizce one ve other metinlerini gönderin ve altı Arapça metin isteyin. ICU sözdizimini kod kurar. Model hiçbir süslü parantez yazmaz.
  3. Bir terim sözlüğü ve çevrilmeyecekler listesi verin. Ürün adları, plan adları ve destek ekibinizin kullandığı terimler. Çeviri yazısının terim sözlüğü bölümü bunun neden model seçiminden daha önemli olduğunu açıklıyor.

Çeviri betiği

Kaynak dosya, FormatJS’nin belgelediği sözdizimi olan ICU MessageFormat’ı kullanıyor. Aynı dondurma yöntemi, çoğul anahtarları _zero, _one, _two, _few, _many ve _other ile biten i18next’in kendi JSON biçiminde de işe yarar.

{
  "save": "Save",
  "welcome": "Welcome back, {name}!",
  "invite": "<b>{inviter}</b> invited you to the {workspace} workspace",
  "billing": "Pay with AcmePay",
  "files": "{count, plural, one {# file} other {# files}}"
}
import json, os, re
from openai import OpenAI

client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])

FORMS = ["zero", "one", "two", "few", "many", "other"]
# ICU arguments, double-brace and printf placeholders, HTML-style tags
PH = re.compile(r"\{\{\s*\w+\s*\}\}|\{\w+\}|%(?:\d+\$)?[sdif@]|</?\w+[^>]*>")
PLURAL = re.compile(r"^\{(\w+), plural,(.*)\}$", re.S)

def freeze(text):
    """Replace each placeholder with ⟦n⟧ so the model cannot translate or break it."""
    found = PH.findall(text)
    for i, p in enumerate(found):
        text = text.replace(p, f"⟦{i}⟧", 1)
    return text, found

def thaw(text, found):
    for i, p in enumerate(found):
        text = text.replace(f"⟦{i}⟧", p)
    return text

def branches(body):
    """'one {# file} other {# files}' -> {'one': '# file', 'other': '# files'}."""
    out, i = {}, 0
    while i < len(body):
        m = re.compile(r"\s*([=\w]+)\s*\{").match(body, i)
        if not m:
            break
        depth, j = 1, m.end()
        while depth:
            depth += {"{": 1, "}": -1}.get(body[j], 0)
            j += 1
        out[m.group(1)] = body[m.end():j - 1]
        i = j
    return out

SYSTEM = """You translate app interface strings from English to Modern Standard Arabic.
Reply with one JSON object only: {"STRINGS": {key: Arabic}, "PLURALS": {key: {six forms}}}.
Rules:
- ⟦0⟧, ⟦1⟧ ... are placeholders. Keep every one exactly once and unchanged; move it if Arabic word order needs it.
- # stands for the number. Keep it where the number should appear.
- Interface style: short, no full stops on buttons or labels.
- Never translate terms in DO_NOT_TRANSLATE. Use GLOSSARY translations exactly.
- For each PLURALS key, return all six Arabic forms: zero, one, two, few, many, other.
  zero = none; one = singular without a number; two = dual without a number;
  few = 3-10: # + plural noun; many = 11-99: # + singular noun in the accusative;
  other = 100, 1000 and also 0.5 and 1.5: # + singular noun."""

def translate(src, glossary=None, dnt=(), model="broadnet/qwen3.8-27b"):
    strings, plurals, frozen = {}, {}, {}
    for key, text in src.items():
        m = PLURAL.match(text)
        if m:
            b = branches(m.group(2))
            fone, ph = freeze(b.get("one", b["other"]))
            fother, _ = freeze(b["other"])
            plurals[key] = {"one": fone, "other": fother}
            frozen[key] = (m.group(1), ph)
        elif "{" in PH.sub("", text):
            raise ValueError(f"{key}: nested ICU, send to a human")
        else:
            strings[key], ph = freeze(text)
            frozen[key] = (None, ph)
    payload = {"STRINGS": strings, "PLURALS": plurals,
               "GLOSSARY": glossary or {}, "DO_NOT_TRANSLATE": list(dnt)}
    r = client.chat.completions.create(
        model=model, max_tokens=4000, temperature=0.2,
        messages=[{"role": "system", "content": SYSTEM},
                  {"role": "user", "content": json.dumps(payload, ensure_ascii=False)}])
    out = json.loads(r.choices[0].message.content)
    ar = {k: thaw(v, frozen[k][1]) for k, v in out.get("STRINGS", {}).items() if k in frozen}
    for k, forms in out.get("PLURALS", {}).items():
        if k not in frozen:
            continue
        arg, ph = frozen[k]
        ar[k] = "{%s, plural, %s}" % (arg, " ".join(
            f + " {" + thaw(forms[f], ph) + "}" for f in FORMS if f in forms))
    return ar

en = json.load(open("en.json"))
ar = translate(en, glossary={"workspace": "مساحة العمل"}, dnt=["AcmePay"])
json.dump(ar, open("ar.json", "w"), ensure_ascii=False, indent=2)

Betiği OpenAI Python SDK ile, canlı API’ye değil, hazır bir Arapça yanıt döndüren yerel bir sahte (mock) sunucuya karşı çalıştırdık. Modelin göreceği istek “Welcome back, ⟦0⟧!” ve “⟦0⟧⟦1⟧⟦2⟧ invited you to the ⟦3⟧ workspace” içeriyordu ve betik şu ar.json dosyasını yazdı:

{
  "save": "حفظ",
  "welcome": "مرحبًا بعودتك يا {name}!",
  "invite": "دعاك <b>{inviter}</b> إلى مساحة العمل {workspace}",
  "billing": "ادفع عبر AcmePay",
  "files": "{count, plural, zero {لا توجد ملفات} one {ملف واحد} two {ملفان} few {# ملفات} many {# ملفًا} other {# ملف}}"
}

Kodla ilgili notlar:

  • İşaretler yer değiştirir, kaybolmaz. Arapça çoğu zaman fiili başa koyar; bu yüzden ⟦0⟧ yer değiştirebilir. Aşağıdaki kontrol işaretleri sayar; nerede durduklarıyla ilgilenmez.
  • İç içe ICU bir insana gider. Bir plural içindeki select nadirdir ve kolayca bozulur. Betik tahmin etmek yerine onu reddeder.
  • max_tokens=4000 akıl yürütmeye yer bırakır. BroadNet’in dokümantasyonuna göre DeepSeek V4.1 Flash, GLM 5.3 ve Qwen3.8 27B yanıt vermeden önce akıl yürütür ve akıl yürütme max_tokens’a sayılır. Bkz. akıl yürütme modellerinden boş yanıtlar.
  • json.loads başarısız olabilir. Onu sarmalayın ve hatayla birlikte bir kez yeniden gönderin; LLM’den gelen geçersiz JSON’u düzeltme yazısında test edilmiş bir onarım fonksiyonu var. Yapılandırılmış çıktı ile belgelenmiş iki BroadNet modeli olan GLM 5.3 ve Qwen3.8 27B’de bir response_format şeması da ekleyin. Aşağıdaki kontrol her durumda kalır.

Arapça dosya CI’da nasıl doğrulanır?

Her mesajı uygulamanızın çalışma anında kullandığı ayrıştırıcıyla ayrıştırın ve kaynakla karşılaştırın. Bu Node betiği @formatjs/icu-messageformat-parser kullanıyor (testimizde 3.5.23 sürümü):

// node check-ar.mjs en.json ar.json  -> exits 1 on any problem
import { readFileSync } from "node:fs";
import { parse, TYPE } from "@formatjs/icu-messageformat-parser";

const AR_FORMS = ["zero", "one", "two", "few", "many", "other"];
const [en, ar] = process.argv.slice(2).map((p) => JSON.parse(readFileSync(p, "utf8")));
const errors = [];

// Collect argument and tag names; return the plural elements too.
function walk(nodes, names = [], plurals = []) {
  for (const n of nodes) {
    if (n.type === TYPE.literal || n.type === TYPE.pound) continue;
    names.push(n.type === TYPE.tag ? `<${n.value}>` : `{${n.value}}`);
    if (n.type === TYPE.tag) walk(n.children, names, plurals);
    if (n.type === TYPE.plural) plurals.push(n);
    if (n.options) for (const o of Object.values(n.options)) walk(o.value, [], plurals);
  }
  return { names: names.sort().join(" "), plurals };
}

for (const key of Object.keys(en)) {
  if (!(key in ar)) { errors.push(`${key}: missing`); continue; }
  let src, dst;
  try { src = walk(parse(en[key])); dst = walk(parse(ar[key], { requiresOtherClause: true })); }
  catch (e) { errors.push(`${key}: ICU syntax error ${e.message}`); continue; }
  if (src.names !== dst.names) errors.push(`${key}: arguments differ: [${src.names}] vs [${dst.names}]`);
  for (const p of dst.plurals) {
    const missing = AR_FORMS.filter((f) => !(f in p.options));
    if (missing.length) errors.push(`${key}: plural {${p.value}} lacks ${missing.join(", ")}`);
  }
  if (!/[؀-ۿ]/.test(ar[key])) errors.push(`${key}: no Arabic letters`);
  if (/⟦\d+⟧/.test(ar[key])) errors.push(`${key}: placeholder marker left in text`);
}
for (const key of Object.keys(ar)) if (!(key in en)) errors.push(`${key}: not in source`);
console.log(errors.join("\n") || "ok");
process.exit(errors.length ? 1 : 0);

Yukarıdaki dosyada ok yazdırdı. Sonra sahte yanıtın many biçimini ve {workspace} işaretini düşürmesini sağladık. Betik 1 koduyla çıktı ve şunu yazdırdı:

invite: arguments differ: [<b> {inviter} {workspace}] vs [<b> {inviter}]
files: plural {count} lacks many

“Arapça harf yok” kuralı, modelin İngilizce bıraktığı metinleri işaretler. Yalnızca bir ürün adı ya da bir sayı olan değerleri de işaretler; bu yüzden bunlar için bir izin listesi tutun. i18next’in kendi biçimi için aynı kontrolleri anahtar bazında uygulayın: İngilizcedeki her _one/_other çifti Arapçada ekli altı anahtarın hepsine ihtiyaç duyar ve her biri aynı yer tutuculara sahip olmalıdır; tek istisna, _zero, _one ve _two anahtarlarının sayıyı atabilmesidir.

Son olarak birkaç sayıyı gerçek biçimlendiricinizden geçirin. intl-messageformat 12.1.5 ile yukarıdaki files mesajı 0 → لا توجد ملفات, 2 → ملفان, 5 → 5 ملفات, 11 → 11 ملفًا, 102 → 102 ملف ve 111 → 111 ملفًا verdi. Bu nokta kontrolü, ayrıştırılabilen ama yanlış isim biçimi kullanan bir çoğulu yakalar.

Sağdan sola görüntüleme ne olacak?

Çeviri kelimeleri doğru yapar; onları sıralamak yine tarayıcıya kalır. Latin harfli bir ad ya da bir sayı Arapça bir cümleye eklendiğinde Unicode çift yönlü algoritması noktalamayı kaydırabilir ya da komşu parçaların yerini değiştirebilir. W3C’nin önerisi, eklenen metni yalıtmaktır: HTML’de <bdi> ya da dir="auto" olan bir öğeyle sarın, push bildirimleri gibi düz metinde ise U+2068 FIRST STRONG ISOLATE ve U+2069 POP DIRECTIONAL ISOLATE ile çevreleyin.

Bunu çeviride değil, değeri yerleştirdiğiniz yerde yapın. Testimizde karşılama mesajını U+2068 ve U+2069 ile sarılmış adla biçimlendirmek iki karakteri de çıktıda tuttu ve Arapçaya dokunmadı. Sayfada ya da kapsayıcıda dir="rtl" ve lang="ar" da ayarlayın. Arapça istem mühendisliği yazısında RTL görüntüleme hataları için kısa bir kontrol listesi var.

Rakamlar bir çeviri tercihi değil, biçimlendirici tercihidir. Metinde # ya da argümanı tutun. Node 24’te (ICU 78.3) Intl.NumberFormat, 1234’ü ar için 1,234, ar-EG ve ar-SA için ١٬٢٣٤ olarak yazdı. Pazarınıza uyan yerel ayar etiketini seçin. Daha geniş ürün soruları (arayüz yerel ayarı ile model dili, karışık yönlü sohbet balonları, dil tespiti ve dil başına maliyet) için bkz. birden fazla dil için yapay zekâ deneyimi tasarlamak.

Çıktıyı kim gözden geçirmeli?

Bu kontrollere sahip bir LLM hattı, dosyanın iyi biçimlendirilmiş olmasını garanti eder. Arapçanın doğru olmasını garanti etmez. Arapça bilen birine şunları gözden geçirtin:

  • Yalnızca yeni ve değişmiş metinler. en.json’u son sürümle karşılaştırın ve yalnızca değişeni çevirin. İncelemeler küçük kalır, onaylanmış metinler hiç oynamaz.
  • Çoğul biçimleri, kelime kelime. Sayılarla uyum, modelin en sık kaydığı yerdir; özellikle 11 ila 99’dan sonraki nasb hâli.
  • Cinsiyet. Arapçada “sen” ve fiiller okuyucunun cinsiyetine göre değişir. Arayüzünüz kullanıcılara doğrudan hitap ediyorsa sabit bir biçim ya da nötr bir yeniden ifade gibi bir kurala karar verin ve onu sistem istemine koyun.
  • Uzunluk. Arapça metinler İngilizceden daha uzun ya da daha kısa olabilir. Düğmeleri ve sekmeleri gerçek düzende, mobil genişlikte kontrol edin.

Depoda gözden geçirilmiş bir terim sözlüğü dosyası tutun ve her istekle gönderin; böylece onaylanmış terimler sabit kalır.

Maliyeti ne?

Metin dosyaları küçüktür. Çıktı yaklaşık olarak girdi kadar uzundur ve Arapça genellikle İngilizceden kelime başına daha fazla token ister; ölçülmüş oranlar Arapça ve İngilizcede kelime başına token yazısında. Bir partiyi Arapça token sayacına yapıştırın, parti sayısıyla çarpın ve her birine sistem istemini ekleyin. Akıl yürütme modelleri düşünürken de token harcar; BroadNet bunları usage içinde completion_tokens_details.reasoning_tokens olarak bildirir, bu yüzden tahmin yürütmeden önce gerçek bir istekten usage değerini okuyun.

Model Bu iş için notlar 1M token başına girdi / çıktı
Qwen3.8 27B Yapılandırılmış çıktı belgelenmiş $0.175 / $2.17
GLM 5.3 Yapılandırılmış çıktı belgelenmiş; 1.048.576 token bağlam $0.78 / $3.46
Gemma 4 VL 26B $5 başlangıç kredisiyle çalışır; JSON yalnızca istemle, bu yüzden doğrulayıcı daha önemli $0.10 / $0.22
DeepSeek V4.1 Flash Sabit planlarda da var, örneğin oturum başına haftada $15; oturum başına aynı anda bir istek $0.175 / $0.52

Fiyatlar BroadNet’in fiyat akışından alındı, güncellenme tarihi 2026-11-14. Birini seçmeden önce aynı 100 metni iki modelle çevirin ve inceleyicinize karşılaştırtın; token başına fiyat, gereken düzeltme sayısından daha az önemlidir. Birçok dilde binlerce anahtar için Batch API olmadan toplu işleme yazısı eşzamanlılığı ve yeniden denemeleri anlatıyor.

BroadNet Inference nerede devreye girer?

BroadRouter, BroadNet’in kendi sitesidir. BroadNet Inference yukarıdaki modellere OpenAI uyumlu erişim sunar; base URL’yi ve model kimliğini değiştirdikten sonra betik OpenAI Python SDK ile çalışır. Her modelin desteklediği parametreler için API başvurusunu kontrol edin. Çeviri uç noktası yok ve bir yerelleştirme kıyaslaması yayımlamıyor; bu yüzden kalite kapınız doğrulayıcı ve bir insan inceleyici olarak kalır. Özel yerelleştirme platformları çeviri belleği, inceleyici iş akışları ve bağlam içi ekran görüntüleri ekler; bunlara ihtiyacınız varsa birini kullanın ve yukarıdaki CI kontrolünü ikinci bir savunma hattı olarak tutun.

Sık sorulan sorular

Arapçada kaç çoğul biçimi var?

Unicode CLDR'de altı sayısal kategori: zero (0), one (1), two (2), few (3 ila 10 ve 103 gibi, 03 ila 10 ile biten sayılar), many (11 ila 99 ile biten) ve other (100 ila 102, 1000 ve 0.5 gibi ondalıklar). İngilizce bir dosyada yalnızca one ve other var.

ChatGPT ya da başka bir LLM i18n JSON dosyamı Arapçaya çevirebilir mi?

Evet, biçimi siz kontrol ederseniz. Yalnızca değerleri gönderin, yer tutucuları işaretlerle değiştirin, altı çoğul biçimi isteyin ve sonucu kodda kontrol edin: anahtarlar, argümanlar, etiketler ve çoğul kategorileri. Yayından önce yeni metinleri Arapça bilen birine gözden geçirtin.

Arapça çeviride bir çoğul biçimi eksikse ne olur?

Genellikle görünür hiçbir şey bozulmaz. i18next ve intl-messageformat other biçimine geri düşer; böylece 2 dosya ikil ملفان yerine "2 ملف" olarak görünür. Bunu kullanıcılardan önce yalnızca altı biçimin hepsini zorunlu tutan bir doğrulayıcı yakalar.

ICU MessageFormat sözdizimini LLM kendisi mi yazmalı?

Yazmasa daha iyi. Her çoğul mesaj için altı düz metin isteyin ve ICU sözdizimini kodda kurun. Modeller ara sıra bir süslü parantezi düşürür ya da argüman adını çevirir; o zaman bir ayrıştırıcı hatası çalışma anında bütün paketi bozar.

Arapça arayüz metinlerinde hangi rakamlar kullanılmalı?

Buna çeviri değil, sayı biçimlendirici karar versin. Metinde # ya da argümanı tutun. Node 24 testimizde Intl.NumberFormat, 1234'ü ar için 1,234, ar-EG ve ar-SA için ١٬٢٣٤ olarak biçimlendirdi; yani rakamları yerel ayar etiketi belirliyor.

Markdown olarak okuChatGPT asistanına sorClaude asistanına sorPerplexity asistanına sor