DITA Tercümesi: hangi dosyalar ve kontroller gerekir?
DITA, teknik dokümantasyonu topic parçalarına ayırır ve bir içeriğin farklı ürün yayınlarında yeniden kullanılmasına olanak tanır. Bu avantaj çeviride özel bir sorumluluk yaratır: tek bir common warning metni farklı bağlamlarda görünebilir. Yanlış çevrilmiş ortak bir bölüm, birden çok dokümanda tekrar eden risk oluşturur. Bu nedenle sözcük seçimi, topic türü ve reuse ilişkisi birlikte değerlendirilmelidir.
Çeviri kapsamını dosyanın yapısıyla birlikte belirleyelim
Neden yalnızca metin çevirisi yeterli değil?
DITAMAP dosyaları yayın ağacını gösterirken topic XML dosyaları gerçek metinleri taşır. conref ve keyref gibi mekanizmaların kaynak bilgisi korunmalı, link hedefleri ve teknik referanslar bozulmamalıdır. Dosyanın yapısal doğruluğunun kontrolü ile belirli bir yayın motorunda çıktı üretimi birbirinden farklı aşamalardır.
Proje başlangıcında neyi netleştiriyoruz?
Kaynak ve hedef dili, kullanılacak yazılım sürümünü, dosyanın düzenlenebilirliğini, teslim formatını ve hedef uygulamada yapılacak son kontrolü birbirinden ayırıyoruz.
Bu sayfada anılan doğrulama adımları, her projede otomatik sunulduğu anlamına gelmez. Hangi kontrollerin ve teslim biçimlerinin dahil olduğu, dosya incelemesi sonrasındaki teklifte belirlenir.
Uzmanlık gerektiren beş kritik ayrıntı
Topic yeniden kullanım riski
DITA’nın temel yararı, metni yeniden kullanılabilir topic bölümlerine ayırmasıdır. Ancak ortak bir güvenlik uyarısında yapılan yanlış terim seçimi birden çok yayın yerine taşınabileceğinden, yeniden kullanım ağının görünmesi çeviri kalitesi için kritiktir.
DITAMAP ve topic dosyaları
Çeviri için yalnızca DITAMAP dosyası gönderilirse bu harita içindeki topic dosyaları eksik olabilir. Topic ve referans kaynaklarının arşiv halinde paylaşılması, eksik kapsam ve bozuk bağlantı sorunlarını azaltır.
conref ve keyref ilişkileri
conref ve keyref gibi mekanizmalar içerik ilişkisini kod düzeyinde tanımlar. Bu işaretlerin değerlerini sıradan sözcük gibi çevirmek yayın işleyicisinin hedefe ulaşmasını engelleyebilir; işaretleyici ve görünen metin ayrımı yapılmalıdır.
Teknik yönerge semantiği
DITA belgelerinde adımlar, uyarılar, sonuçlar ve ön koşullar farklı anlam taşır. Bir işlem yönergesindeki “Before you begin” türü bilgi yapısı hedef dilde de anlaşılır kılınmalı; standart uyarı terimleri ürün sözlüğüne göre kontrol edilmelidir.
Şema ve yayın testi ayrımı
Bir DITA XML dosyasının etiketlerinin geçerli olması, son PDF veya HTML yayının doğru üretildiğini garanti etmez. DTD/şema kontrolü, yayın motoru testi ve link doğrulaması ayrı teslim aşamaları olarak değerlendirilebilir.
Modüler teknik doküman: işleme ve kalite kontrol matrisi
İçeriğin çeviriye uygun biçimde ayrıştırılması kadar çevrilmemesi gereken teknik öğelerin korunması da önemlidir. Aşağıdaki tablo proje keşfinde kullanılan kontrol başlıklarını gösterir.
| Öğe / dosya alanı | Kontrol konusu | Gözden kaçabilecek risk |
|---|---|---|
| DITAMAP ve topic ağacı | Kapsam, bölüm sırası ve anahtar çözümlemesi | Eksik veya yanlış kaynak linki |
| conref/keyref | Yeniden kullanılan fragment ve anahtar bağlantısı | Yayın içinde farklı uyarı/terim görünmesi |
| DITA element/attribute | Çevrilebilir metin ve korunacak işaretleme | XML doğrulama hatası |
| Filtrelenmiş varyantlar | profiling metadata ve product/platform koşulu | Yanlış ürün sürümü içeriği |
Gerçek iş akışlarını açıklayan üç kullanım senaryosu
Aynı uyarı topic’inin farklı ürün sayfalarında nasıl kullanıldığı eşleştirilir.
Prosedür adımları ve uyarı düzeyleri teknik terim listesiyle birlikte kontrol edilir.
Yalnızca değişen topic’ler işaretlenir ve önceki yayın belleğiyle uyum denetlenir.
Projeyi doğru hazırlamak için temel kavramlar
Proje dosyanızda karşılaşılabilecek terimlerden bazıları aşağıdadır. Bu kavramlar çevrilecek metin ile korunması gereken teknik yapı arasındaki sınırları belirlemeye yardımcı olur.
| Teknik ifade | Projedeki anlamı |
|---|---|
| topic | DITA içerik birimi |
| ditamap | Topic hiyerarşisini tanımlayan yayın haritası |
| conref | Başka içerikten öğe yeniden kullanma mekanizması |
| keyref | Anahtar tabanlı bağlantı/başvuru |
Tekliften önce hazırlayabileceğiniz dosya kontrol listesi
Dosyaları doğrudan bu sayfaya yüklemenize gerek yoktur. İlk mesajınızda kaynak/hedef dili ve kapsamı belirtin; belgeleri WhatsApp veya e-posta görüşmesinde paylaşabilirsiniz.
- Tüm topic, DITAMAP ve ortak kaynakları birlikte gönderin.
- DITA sürümünü, DTD/şemayı ve çıktı motorunu belirtin.
- conref/keyref kaynaklarının tam olduğundan emin olun.
- Ürün varyantlarını ve koşullu filtreleri tanımlayın.
- Şema doğrulama ve yayın testinin kapsamını kararlaştırın.
İncelemeden teslimata çalışma akışı
1. İnceleme ve kapsam
Dosya formatı, kaynak hacmi, çevrilecek alanlar ve hedef uygulamanın gereksinimleri belirlenir. Düzenleme, DTP veya çalışır uygulama kontrolü gerekiyorsa ayrı iş olarak tanımlanır.
2. Çeviri ve terminoloji
Bağlam, sektör terimleri ve varsa onaylı müşteri sözlüğü esas alınır. Teknik işaretleyiciler ve değişmemesi gereken alanlar proje talimatına dahil edilir.
3. Kalite kontrol
Metin tutarlılığı ve kaynak-hedef eşleşmesi incelenir. Yapısal kontrollerin kapsamı; dosyanın türüne, teslim biçimine ve üzerinde anlaşılan hizmete bağlıdır.
4. Teslim ve gerekirse revizyon
Kararlaştırılan format teslim edilir. Hedef uygulamada test veya sonraki sürüm güncellemesi gerekiyorsa geri bildirim ve revizyon süreci ayrıca planlanır.
DITA Tercümesi hakkında sık sorulan sorular
Yalnızca DITAMAP dosyası çeviri için yeterli mi?
Genellikle hayır. DITAMAP yayın haritasıdır; bağlı topic XML ve kullanılan ortak kaynakların da sağlanması gerekir.
conref ve keyref değerleri çevrilmeli mi?
Teknik başvuru değerleri çoğu durumda sabit tutulur; ancak kullanıcıya görünen metinler bağlama göre çevrilir. Kaynak şema esas alınır.
Yinelenen metinleri tek kez çevirebilir miyiz?
Tekrar kullanım ilişkisi ve onaylı terminoloji varsa çeviri belleğiyle tutarlılık sağlanabilir. Farklı bağlamdaki benzer metinler ise ayrıca değerlendirilir.
DITA XML yapısının geçerliliği nasıl kontrol edilir?
Etiket/attribute bütünlüğü incelenir; mümkünse müşterinin DTD veya şemasıyla doğrulama yapılır. Yayın motoru testi ayrıca planlanabilir.
Profiling/conditional processing çeviriye dahil mi?
Hedeflenecek ürün, sürüm ve audience variant’ları proje başında belirlenmelidir. Görünmeyen varyantlar ayrıca kapsamlandırılır.
Görsellerin alt metinleri çevrilir mi?
Müşteriye görünen açıklama ve erişilebilirlik metinleri kapsamda olabilir; bunların dosyalarda nerede tutulduğu incelenmelidir.
Teslimi doğrudan PDF veya HTML olarak alabilir miyiz?
Yayın çıktısı istenirse DITA aracı ve derleme profili gerekir; yalnızca XML metin çevirisi ile yayın hizmeti ayrı değerlendirilir.
İlgili hizmetler ve yararlı bağlantılar
Belgenin kaynak biçimine ve hedef kullanım amacına göre aşağıdaki hizmetler birlikte değerlendirilebilir.
Dosyanıza uygun fiyat ve teslim planı isteyin
DITA Tercümesi için kaynak/hedef dilinizi, dosya tipinizi ve teslim beklentinizi paylaşın. Çevrilecek alanları birlikte netleştirerek size özel teklif sunalım.