input var
Tüm giriş değişkenlerinden hedef dilin adını çıkarmak için kullanılan prompt şablonu.
Bu iş akışı, özellikle dosya yapısı ve biçimlendirmeyi koruyarak HUGO projelerinde kullanılan markdown dosyalarının çevirisini otomatikleştirmek için tasarlanmıştır. Akış, yalnızca ilgili metin içeriğinin çevrilmesini sağlarken, teknik unsurların (front matter, markdown yapısı ve kontrol karakterleri gibi) bozulmadan kalmasına dikkat eder. Bu, çok dilli HUGO tabanlı statik siteleri yöneten ekipler için; içerik yerelleştirmesini yüksek kalite ve tutarlılıkla ölçeklendirmek isteyenler için özellikle faydalıdır.
Amaç ve Faydası
- Otomatik Çeviri: İş akışı, markdown dosyaları için yüksek kaliteli çeviriler sunmak üzere en gelişmiş dil modellerinden (OpenAI GPT-4 varyantları) yararlanır.
- Yapı Koruma: HUGO markdown dosyalarının yapısını; TOML biçimindeki front matter, markdown başlıkları ve özel biçimlendirmeler dahil dikkatle korur.
- Seçici Çeviri: Akış, front matter’daki alan adlarını veya HTML etiketleri içindeki metni çevirmemeye, yalnızca alan değerleri ve markdown içeriğine odaklanmaya tasarlanmıştır.
- Ölçeklenebilir Yerelleştirme: Çeviri sürecini otomatize ederek, minimum manuel çabayla birden fazla dile hızlı ölçeklenmeyi mümkün kılar.
İş Akışındaki Temel Adımlar
İş akışı birkaç birbirine bağlı bileşenden oluşur. İşte adım adım bir özet:
| Adım | Bileşen | İşlev |
|---|---|---|
| 1 | Chat Input | Çevrilecek markdown dosyasını ve gerekli değişkenleri (örn. hedef dil) kabul eder. |
| 2 | Prompt Template (input var) | Giriş değişkenlerinden hedef dil adını sonraki adımlar için çıkarır. |
| 3 | LLM OpenAI (nano) | Promtları işlemek için hafif bir GPT-4 modeli kullanır. |
| 4 | Generator (get language name) | Sağlanan değişkenlerden hedef dil adını üretir. |
| 5 | Document Retriever (GetBestTranslation) | Mevcut en iyi çevirileri veya dahili/doküman kaynaklarından bağlamı arar. |
| 6 | Prompt Template (Prompt) | LLM’ye nasıl çevireceğiyle ilgili ayrıntılı bir prompt hazırlar; kısıtlamalar ve örnekler içerir. |
| 7 | LLM OpenAI (full) | Çeviri işlemini gerçekleştirmek için tam özellikli bir GPT-4 modeli (geniş bağlamlı) kullanır. |
| 8 | Generator | Yukarıdaki prompt ve modelle çeviriyi gerçekleştirir. |
| 9 | Chat Output | Çevrilmiş markdown dosyasını çıktı arayüzünde gösterir. |
İş Akışı Mantığı: Detaylar
- Girdi İşleme: Kullanıcı bir markdown dosyası ve hedef dili belirtir. İş akışı, promptlarda kullanılacak ilgili değişkenleri çıkarır.
- Dil Çıkarma: İş akışının ilk bölümü, girişten hedef dilin adını belirlemek için hafif bir LLM ve özel bir prompt şablonu kullanır.
- Bağlamsal Getirme: Mevcut çevirileri veya alakalı dokümantasyonu isteğe bağlı olarak getirerek ek bağlam sağlar ve çeviri tutarlılığını arttırır.
- Çeviri Promptu Oluşturma: Biçimlendirme kuralları, çeviri kısıtlamaları ve dosya yapısı beklentilerini ayrıntılandıran kapsamlı bir prompt hazırlanır. Model için örnek dosya yapısı verilir; neyin çevrileceği ve neyin korunacağı net talimatlarla belirtilir.
- Çeviri Üretimi: Ana çeviri, güçlü bir LLM kullanılarak gerçekleştirilir; çıktı kalitesi yüksek tutulurken biçim ve yapı gerekliliklerine titizlikle uyulur.
- Çıktı: Çevrilen markdown dosyası, kullanıcı incelemesi veya ek otomatik işlem için sunulur.
Bu İş Akışı Neden Faydalı?
- Tutarlılık: Tüm çevrilen dosyaların HUGO projelerinde istenen biçim ve yapıya sıkı sıkıya uymasını sağlar.
- Verimlilik: Statik site üreticileri için markdown dosyalarının çeviri ve biçimlendirmesinde manuel çabayı büyük ölçüde azaltır.
- Ölçeklenebilirlik: Birden fazla dile ve büyük hacimli içeriğe kolayca ölçeklenmeyi mümkün kılar.
- Kalite Kontrolü: Hem bağlam farkındalıklı getirme hem de açık çeviri talimatları sayesinde, basit makine çevirilerinde sık rastlanan hataları en aza indirir.
Özel Hususlar
- Alana Özel Kurallar: İş akışı, front matter içindeki alan adlarını değil sadece alan değerlerini çevirmeye dikkat eder.
- Biçimlendirme Bütünlüğü:
+ + +gibi kontrol karakterleri ile markdown/HTML öğeleri, HUGO ve TOML gereksinimleri doğrultusunda korunur. - Genişletilebilirlik: Modüler yapı (retriever’lar, prompt şablonları ve generator’lar ile), gereksinimler geliştikçe kolay uyarlama imkânı sunar.
Özetle, bu iş akışı HUGO markdown dosyalarının çevirisi için uçtan uca, güvenilir ve ölçeklenebilir bir çözüm sunar; çok dilli statik siteler veya dokümantasyon projeleri yöneten organizasyonlar için son derece değerli kılar.
