YAML Tercümesi: kapsam, teknik gereksinimler ve teslim seçenekleri
Çevrilecek açıklamayı yapılandırmanın anahtarından ayırın.
YAML dosyaları uygulama yapılandırması, içerik yönetimi ve yazılım yerelleştirmesi için kullanılabilir. Ancak her YAML dosyası tercüme edilecek metinlerden oluşmaz; bazı alanlarda ortam değişkeni, servis adı, şifrelenmiş değer veya sayısal parametre bulunabilir. LingoTurk, YAML tercümesi projelerinde çevrilebilir kullanıcı metinlerini korunması gereken anahtar ve program mantığından ayrıştıran bir çalışma planı önerir.
Yapılandırma ve yazılım metinleri: çeviride hangi ayrıntılar önemlidir?
Kaynağın kapsamını anlamak
YAML girintiye duyarlı bir dosya biçimidir. Anahtar adları, `:` ayraçları, listeler, blok dizgeler, `&` anchor ve `*` alias gibi sözdizimi öğeleri yanlış düzenlendiğinde dosya çözümlenemez. Özellikle `on`, `yes` gibi ifadeler farklı ayrıştırıcılarda farklı yorumlanabildiğinden kaynak hedef ortamı önemlidir. Tercüme ile YAML doğrulaması veya uygulama dağıtımı aynı iş adımı değildir.
Çeviri ile teknik teslimi ayırmak
Çeviri, düzenleme, yerel yazılımda açılış, derleme, yayınlama ve işlevsel test farklı teslim aşamalarıdır. Bunlar aynı projede birlikte planlanabilir ancak her dosyada kendiliğinden yapılmış kabul edilmemelidir. Örnek dosyanın incelenmesi, gerçekçi kapsam ve süre belirlenmesini sağlar.
Kaynak ve hedef dil, hedef kurum veya uygulama, dosya sürümü, özel terminoloji ve son kullanıcının beklentisi bildirildiğinde fiyatlandırma da daha anlaşılır hale gelir.
Hangi metinler çeviri kapsamına girebilir?
Locale sözlükleri
Menü, uyarı, açıklama ve çok dilli mesajlar
Yazılım tanımları
İleti şablonu, API açıklaması, müşteri metinleri
Dokümantasyon
Statik site içerikleri, front matter alanları
Yapılandırma dosyaları
Yalnızca kullanıcı metni olan alanların seçimi
YAML Tercümesi için üç kritik karar noktası
Sözdizimi kontrolüyle dil kontrolü farklıdır
YAML ayrıştırıcısı dosyanın teknik bakımdan geçerli olduğunu gösterebilir; ancak “başvuru gönderildi” yerine anlamı yanlış başka bir bildirim yazılmışsa bunu tespit etmeyebilir. Tersine, dilsel olarak doğru bir mesaj `:` veya girinti hatası nedeniyle çalışmayabilir. İyi bir iş akışı iki testi birbirinden ayırır ve sorumluları açıkça belirler.
Gizlilik ve yapılandırma dosyaları
Bazı YAML dosyaları geliştirme ortamına ait bağlantı, kullanıcı, token veya başka özel değerler barındırabilir. Tercüme kapsamıyla ilgisi olmayan bu verilerin paylaşılması gerekli değildir. Çeviri öncesinde metin alanlarının ayıklanması ve örnek verilerin gerçek gizli bilgiler yerine kullanılması, gereksiz veri aktarımı riskini azaltır.
Tekrarlı yerelleştirme anahtarları
Farklı uygulama ekranlarında aynı kısa ifade farklı anlam taşıyabilir. Kaynakta `save`, `submit`, `cancel` gibi anahtarlar varsa bunların her zaman aynı kelimeyle çevrileceği varsayılmamalıdır; bağlam önemlidir. Çok dilli uygulamalarda onaylı terim listesi ve yer tutucu kontrolü, anahtarların değişmeden kalmasıyla birlikte yönetilmelidir.
Dosya türüne özel kalite kontrol tablosu
YAML Tercümesi için önemli olan yalnızca yazının anlamı değildir. Hedef dosyanın kullanım amacı, teknik işaretler ve değişmemesi gereken alanlar birlikte değerlendirilmelidir. Aşağıdaki tablo, teklif öncesi kontrol başlıklarını açıklar; tüm testlerin otomatik olarak dahil olduğu anlamına gelmez.
| Kontrol edilen alan | Neye bakılır? | Başlıca risk |
|---|---|---|
| Anahtar/indent | Girinti, iki nokta, kısa/uzun blok yapısı | YAML ayrıştırma hatası |
| Değişken değerleri | ${VAR}, %{name}, {{value}} gibi ifadeler | Yanlış interpolasyon veya kod hata mesajı |
| Dizi/sıra | Liste öğesi, anahtar sırası, iç içe hiyerarşi | Yanlış anahtar bağlamı |
| Anchor/alias | &ref ve *ref ilişkileri | Kopyalanamayan veya kopan referans |
| Çevrilmeyen değer | Endpoint, ID, sayı, özellik bayrağı | Uygulama davranışının değişmesi |
Üç örnek kullanım senaryosu
Aşağıdakiler gerçek müşteri/proje iddiası değil, bu tür dosyalarda karşılaşılabilen örnek çeviri ihtiyaçlarıdır.
`tr:` ve `en:` kaynaklarının aynı anahtar yapısında kalması sağlanır; metin değerleri hedef dile aktarılır.
Front matter başlık ve özet alanları içerikten ayrılır; permalink ve teknik etiketler olduğu gibi korunur.
Kullanıcıya gösterilen bildirim metni çevrilir; servis adı, ortam değişkeni ve yürütme seçenekleri değiştirilmez.
Teknik terimler ve sık karşılaşılan dosya öğeleri
Çeviriye hazırlanırken bilinmesi gereken terimler hem müşteriyle kapsam görüşmesini hem de proje içinde terminoloji birliğini kolaylaştırır.
| Terim | Pratik açıklama |
|---|---|
| YAML/YML | Girintiye dayanan insan okunabilir veri biçimi |
| Scalar | Tek değer taşıyan metin veya sayı alanı |
| Mapping | Anahtar-değer ilişkisi |
| Sequence | Liste şeklindeki veri alanı |
| Anchor/Alias | YAML içinde aynı öğeye başvuran işaretler |
Dosyanızı çeviriye hazırlama kontrol listesi
Teklif sayfamız ilk aşamada dosya yüklemez. Belge türü, kaynak/hedef dil ve ihtiyacınızı belirten kısa talebin ardından dosyaları WhatsApp veya e-posta görüşmesinde iletebilirsiniz.
- YAML dosyası ve hedef uygulamanın sürüm bilgisini paylaşın.
- Çevrilecek anahtar yollarını veya locale alanlarını işaretleyin.
- Değişken, anchor ve URL değerlerini korunacak listeye ekleyin.
- Dosya girintisi ve kodlama beklentisini belirtin.
- Parser ile validasyon ve canlı test isteğini ayrı tanımlayın.
İncelemeden teslimata dört aşamalı yaklaşım
Kaynak dosya, dil çifti ve kullanıcının amacı değerlendirilir.
Çevrilecek metinle korunacak yapı öğeleri birbirinden ayrılır.
Terim listesi, bağlam ve metin kontrol planı uygulanır.
Kararlaştırılan formatta teslim ve gerekli ek kontroller planlanır.
YAML Tercümesi hakkında sık sorulan sorular
YAML dosyasındaki tüm değerler çevrilir mi?
Hayır. Sadece kullanıcıya yönelik metinler çevrilmeli; servis kimlikleri, teknik anahtarlar, URL ve yapılandırma parametreleri genellikle korunmalıdır.
Anahtar isimlerini de çevirmeli miyiz?
Uygulama anahtarı olan alanlar değiştirilmemelidir. İstisnalar yazılım sahibinin açık teknik talimatına bağlıdır.
Girinti neden kritik?
YAML iç içe yapıları girintiyle gösterir. Yanlış boşluk sayısı dosyanın hiç yüklenmemesine veya farklı veri üretmesine yol açabilir.
Değişkenler ve placeholder’lar çevrilir mi?
Teknik belirteçler korunur; hedef dilin sözdizimine göre yerleri değişmesi gerekiyorsa uygun değişken doğrulaması yapılmalıdır.
JSON’dan YAML’e çevirmek gerekiyor mu?
Hayır. Çeviri ile veri biçimi dönüştürme ayrı işlemlerdir. Mevcut YAML kullanılabiliyorsa aynı yapı üzerinde çalışılabilir.
YAML dosyasını geçerli olarak teslim etmek garanti mi?
Yapısal kontrol planlanabilir, ancak hedef uygulamada çalışma doğrulaması ve dağıtım koşulları ayrıca kapsamlandırılmalıdır.
Front matter alanlarından hangileri çevrilir?
Genellikle başlık, açıklama gibi insan okuyacağı değerler çevrilir; slug, tarih ve kategori kimlikleri site planına göre ele alınmalıdır.
Teklif için hangi örnekler gerekli?
Kaynak YAML, hedef locale, çevrilebilir anahtar örneği, kullanılan parser/framework ve koruma kuralları paylaşılmalıdır.
İlgili çeviri hizmetleri
Belgenizin çıktısı başka bir dosya türüyle birlikte kullanılacaksa aşağıdaki hizmetleri de inceleyebilirsiniz.
Belgenize uygun fiyat ve teslim süresi isteyin
YAML Tercümesi için kaynak ve hedef dilinizi, dosya örneğinizi ve beklediğiniz çıktı türünü belirtin. İnceleme sonucunda çalışma kapsamını ve teklif seçeneklerini paylaşalım.