Yazılım Yardım İçeriği: Konu Birimleri, DITA ve Kılavuz Çevirisi

Bir yazılım projesinde arayüz dizeleri işin görünen yüzüdür. Yazılım yardım içeriği ise arkada duran, çoğu zaman daha hacimli olan bölümdür: kullanım kılavuzları, yardım konuları, öğreticiler ve teknik notlar. Kullanıcı takıldığında başvurduğu yer burasıdır.

İçindekiler

Bu içerik türü arayüz metinlerinden farklı bir mantıkla üretilir, farklı biçimlerde saklanır ve farklı araçlarla işlenir. Üslubu da farklıdır: kısa ve kendi başına duran dizeler yerine, teknik üsluplu uzun paragraflar görürsünüz.

Aşağıda bu içeriğin nerede durduğunu, nasıl bölündüğünü, kapsam kararının nasıl verildiğini ve testinin neden ayrı ele alınması gerektiğini anlatıyoruz.

Yazılım yardım içeriği ürünün neresinde durur?

Bir yerelleştirme projesinde çevrilen varlıklar üç ana başlıkta toplanır. Birincisi yazılım içeriğidir: programın içine gömülü arayüz metinleri ve diyalog kutuları. İkincisi kullanıcı destek içeriğidir. Üçüncüsü ise ürün siteleri, haberler ve bloglardan oluşan bilgi içeriğidir.

Kullanıcı destek içeriğinin amacı, kullanıcının programı kullanırken yolunu bulmasını sağlamak ve paketin yeteneklerini anlatmaktır. Bu içerik çoğunlukla konu adı verilen bilgi birimleri halinde düzenlenir ve bir içerik yönetim sisteminde saklanır.

Yazılım ürünü bir bütün olarak tek bir dijital tür sayılır. Terminoloji ve üslup, bütün bileşenlerde aynı olmalıdır. Bir kılavuzda geçen menü adı ile ekrandaki menü adı farklıysa, kullanıcı anlatılanı üründe bulamaz.

Bu tutarlılık görsellere de uzanır. Yerelleştirilmiş bir yardım sayfasındaki ekran görüntüsü, ürünün yerelleştirilmiş sürümünü göstermelidir. Metin Türkçe, resim İngilizceyse belgeye duyulan güven zedelenir. Bu nedenle görsellerin yenilenmesi, çeviri kadar planlanması gereken ayrı bir iş kalemidir.

Üçüncü içerik türü olan bilgi içeriği ise ayrı bir uzmanlık ister. Ürün siteleri, duyurular ve tanıtım sayfaları pazarlama diline yakın durur ve web yerelleştirmesi kapsamında ele alınır. Aynı üründen söz etseler de yazım ölçütleri kılavuzunkinden farklıdır.

Konu birimleri ve DITA

Yardım içeriği bugün büyük ölçüde konu temelli yazılır. Her konu, kendi başına anlaşılabilen bağımsız bir bilgi birimidir. Bu birimler bir araya getirilerek kılavuz, yardım sitesi ya da PDF gibi farklı çıktılar üretilir.

En yaygın saklama biçimi XML’dir. Belge temsili için geliştirilen açık mimarilerden DITA ve onun hafifletilmiş sürümü bu alanda sık kullanılır. Bunların yanında ReStructuredText, Markdown ve Wikipedia’yı çalıştıran MediaWiki’nin anlamsal wiki biçimi de karşımıza çıkar.

Bilgi birimleri daha sonra derlenir ve kullanıcıya HTML ya da PDF gibi biçimlerde sunulur. Yerelleştirme açısından bu, aynı içeriğin birden fazla çıktıda görüneceği anlamına gelir. Bir birimdeki hata, bütün çıktılara birden yansır.

Çeviri aşamasında bu dosyalar bellek araçlarıyla işlenebilir. Bazı durumlarda XML dosyalarının metin içeriği ayrıştırılarak katalog dosyalarına aktarılır. Hangi yol izlenirse izlensin, yapı korunur ve çeviri sonrası özgün biçime geri dönülür.

Konu temelli yazımın yerelleştirmeye en somut katkısı yeniden kullanımdır. Aynı bilgi birimi birden çok kılavuzda görünüyorsa yalnızca bir kez çevrilir. Ürün geliştikçe değişen konular güncellenir, değişmeyenler olduğu gibi kalır. Bu düzen, sürüm başına düşen çeviri hacmini belirgin biçimde düşürür.

Arayüz dizesiyle yardım metninin üslup farkı

İki içerik türü arasında belirgin bir dil farkı vardır. Arayüz dizeleri kısadır ve kendi başına durur. Yardım içeriği ise uzun paragraflardan oluşur ve teknik bir üslup taşır. Çeviri kararları da buna göre değişir.

Yardım metninde tercih edilen dil sade, açık ve doğrudandır. Bunun nedeni okuyucunun konumudur: kullanıcı genellikle belirli bir sorunu çözmek için bu sayfaya gelir. Karmaşık ya da dolambaçlı bir anlatım, aradığı bilgiyi bulmasını engeller.

Bu nedenle yardım içeriği çevirisinde süslü anlatımdan kaçınılır. Kısa cümle, tek adımı anlatan tek paragraf ve tutarlı terim kullanımı esastır. Arayüzde geçen komut adları ise birebir aynı biçimde aktarılır; yakın anlamlı bir karşılık kullanılmaz.

Bu fark, çevirmen seçimini de etkiler. Arayüz dizeleri kısalık ve yerleşim duyarlılığı ister; yardım içeriği ise teknik metin yazma alışkanlığı ve tutarlı bir anlatım disiplini gerektirir. İki işin aynı kişide birleşmesi mümkündür, ancak beklentiyi baştan tanımlamak gerekir.

Neyin çevrileceğine nasıl karar verilir?

Arayüz tarafında kapsam belirlemek görece kolaydır. Katalog dosyaları bellidir, çıkarılır ve çeviriye gönderilir. Yardım içeriğinde ise durum daha bulanıktır: hangi bilgi biriminin hangi pazar için gerekli olduğu baştan belli olmaz.

Bu yüzden kapsam kararı ayrı bir çalışma gerektirir. Bazı konular yalnızca belirli pazarlarda kullanılan işlevleri anlatır. Bazıları ise mevzuata ya da yerel hizmetlere bağlıdır ve hedef pazarda karşılığı yoktur. Yerelleştirme uzmanının işi, bu ayrımı ürün ekibiyle birlikte netleştirmektir.

Belgelendirme türlerini ayırmak da karar vermeyi kolaylaştırır. Aşağıdaki tablo, yaygın türleri ve tipik yerelleştirme kapsamını özetler.

Tür	İçerik	Kapsama girer mi?
Ürün yardımı	Üreticinin sağladığı resmi belgeler	Genellikle evet
Öğretici	Adım adım görev anlatımı	Genellikle evet
Örnekler	Çalışan kod ya da veri örnekleri	Kısmen
Tanıtım videosu	Ürünü genel hatlarıyla anlatan video	Duruma göre
Teknik not	Hata düzeltmesi ve güncelleme notu	Genellikle evet
Forum	Kullanıcı soru ve yanıtları	Genellikle hayır
Blog	Dönemsel kısa yazılar	Genellikle hayır

Forum ve blog içerikleri tipik yerelleştirme projelerinin dışında kalır; gerekirse makine çevirisiyle karşılanır. Kullanıcıların kendi ürettiği üçüncü taraf belgeler de kapsam dışıdır. Bu ayrım, kapsamı sınırlamak için değil, kaynağı gerçekten kullanılan içeriğe ayırmak için yapılır.

Çeviri birimi ve yeniden kullanım

Yardım içeriğinin dikkatle bölümlenmesi gerekir. Metin çeviri birimlerine ayrılırken bölme noktaları tutarlı seçilmezse, bellekteki eşleşme oranı düşer ve aynı cümle her sürümde yeniden çevrilir. Bu, hem maliyet hem tutarlılık sorunudur.

XML belgelerinde hangi içeriğin çevrilebilir olduğunu belirlemek için standartlar kullanılır. Uluslararasılaştırma etiket kümesi, belgedeki çevrilecek bölümleri işaretlemeye yarar. Böylece teknik alanlar ile kullanıcıya görünen metin birbirine karışmaz.

Hazırlık ve dönüştürme işleri için açık kaynak araç takımları vardır. Bu araçlar dosyayı çeviri paketine hazırlar, biçimler arasında dönüştürür ve dosyanın yapısal olarak sağlam kalıp kalmadığını denetler.

Yeniden kullanımın önündeki en sık engel, kaynak metnin kendisidir. Aynı adım üç ayrı konuda üç farklı cümleyle anlatılmışsa bellek eşleşme üretmez. Bu durumda kazanç, çeviriden önce kaynak metnin düzenlenmesiyle sağlanır; teknik yazım disiplini doğrudan çeviri maliyetini etkiler.

Yardım içeriğinde test nasıl yapılır?

Yardım içeriğinin testi, yazılım testinden farklıdır. Burada ağırlık işlevsel ve görsel kontroldedir: derlenen bilgi birimlerinin son kullanıcıya sunulan biçimde doğru görünüp görünmediği denetlenir.

Testin ikinci ayağı içerik tutarlılığıdır. Kılavuzda anlatılan adım, ürünün yerelleştirilmiş sürümünde gerçekten aynı adlarla mı ilerliyor? Bu kontrol yalnızca metne bakarak yapılamaz; ürünün açık olması ve adımların birlikte izlenmesi gerekir.

Bu aşamada en sık görülen sorun, çeviri sırasında XML koduna istenmeden yapılan değişikliklerdir. Sonuç, derleme hatası ya da görüntüleme hatası olur. HTML ile XML arasındaki fark burada belirginleşir: tarayıcılar hatalı HTML’yi yine de gösterir, XML tarafında ise eksik bir etiket belgenin hiç görüntülenmemesine yol açabilir.

Dosyaların yapısal sağlamlığını denetleyen araçlar bu riski azaltır. Yine de gözle yapılan son kontrolün yerini tutmazlar. Aşağıdaki sıra, teslim öncesinde uygulanabilecek pratik bir kontrol listesidir.

1. Çevrilen dosyaların yapısal geçerliliğini araçla denetleyin.
2. Belgeyi hedef çıktı biçiminde derleyip açın.
3. Bağlantıların ve içindekiler listesinin çalıştığını doğrulayın.
4. Ekran görüntülerinin yerelleştirilmiş sürümle güncellendiğini kontrol edin.
5. Kılavuzdaki komut adlarını arayüzdeki karşılıklarıyla karşılaştırın.

Türkiye bağlamı

Türkiye’de yazılım ürünlerinin arayüzü çevrilirken kılavuzların çoğu zaman İngilizce bırakıldığı görülür. Bu tercih kısa vadede maliyet düşürür; ancak destek talebini artırır. Kullanıcı ekranda Türkçe bir komut görür, kılavuzda İngilizce karşılığını arar ve bulamaz.

Kamu alımlarında durum farklıdır. Şartnamelerde Türkçe kullanım kılavuzu ve eğitim materyali istenmesi yaygındır. Bu tür projelerde yardım içeriğinin kapsamı baştan belirlenmeli, teslim biçimi ve güncelleme sorumluluğu sözleşmeye yazılmalıdır.

Bir başka yerel gözlem, kullanıcı davranışıyla ilgilidir. Kullanıcılar ürünle ilk karşılaşmada kılavuza bakma eğilimindedir; ilerleyen aşamalarda ise çevrimiçi arama ve video içerik tercih edilir. Bu, temel kılavuzun Türkçe olmasının neden önemli olduğunu gösterir.

Türkçenin yapısı da yardım metinlerinde kendini gösterir. Uzun tamlama zincirleri ve arka arkaya eklenen ekler, adım anlatımlarını okunmaz hale getirebilir. Kılavuz çevirisinde cümleleri bölmek, her adımı ayrı satıra almak ve emir kipini tutarlı kullanmak okunabilirliği belirgin biçimde artırır.

Bu sizin için ne anlama geliyor?

Yardım içeriği, çeviri bütçesinin genellikle en büyük ama en az planlanan kalemidir. Arayüz birkaç bin kelimeyken kılavuzlar on binlerce kelimeye ulaşabilir. Kapsamı erken belirlemek, hem maliyeti hem teslim süresini öngörülebilir kılar.

1. Yardım içeriğinizin hangi biçimde saklandığını tespit edin.
2. Hangi konuların hedef pazar için gerekli olduğunu ürün ekibiyle belirleyin.
3. Arayüz ve kılavuz için ortak bir terim listesi oluşturun.
4. Ekran görüntülerinin yenilenmesini ayrı bir iş kalemi olarak planlayın.
5. Derleme ve görsel testi teslim sürecine dahil edin.

Bu adımlar, kılavuz çevirisini belirsiz bir kalem olmaktan çıkarır. Kapsamınızı birlikte netleştirmek için teklif isteyebilir, benzer projelerdeki yaklaşımımızı hizmetler sayfamızda görebilirsiniz.

Son bir hatırlatma: kılavuz çevirisi tek seferlik bir iş değildir. Ürün her güncellendiğinde ilgili konular da güncellenir. Bu döngüyü baştan planlayan projelerde sonraki sürümlerin maliyeti düşer, planlamayanlarda ise kılavuz kısa sürede üründen kopar.

Sık sorulan sorular

Yardım içeriği arayüz metinleriyle birlikte mi çevrilir?

Genellikle ayrı bir akışta ilerler. Ancak arayüzdeki komut adlarıyla kılavuzdaki karşılıklarının aynı olması gerekir; bu yüzden iki akış aynı terim listesini kullanır.

DITA nedir?

Belge temsili için kullanılan açık bir XML mimarisidir. İçeriği konu adı verilen bağımsız bilgi birimlerine böler; bu birimler farklı çıktı biçimlerinde yeniden kullanılabilir.

Yardım içeriğinin tamamı her dile çevrilir mi?

Zorunlu değildir. Hangi bilgi biriminin hangi pazar için gerekli olduğu belirlenir. Bu karar genellikle yerelleştirme uzmanı ile ürün ekibi tarafından birlikte verilir.

XML dosyasında yapılan küçük bir hata ne yapar?

HTML tarayıcıları hatalı kodu yine de gösterir, XML ise göstermeyebilir. Silinen bir etiket, belgenin son biçiminde hiç görüntülenmemesine yol açabilir.

Kaynaklar

• Jiménez-Crespo, M. A. (2024). Localization in Translation. Routledge, s. 165–169.
• Byrne, J. (2012). Scientific and Technical Translation Explained. St. Jerome Publishing.
• OASIS DITA standardı belgeleri, oasis-open.org (çevrimiçi belge).