Traduco — Nasıl Kullanılır

Son Güncelleme: 1 Ocak 2025

Gereksinimler

  • Autodesk Revit 2023, 2024, 2025, 2026 veya 2027
  • Aktif bir Revit modeli (herhangi bir disiplin)
  • İsteğe bağlı: Yapay zeka destekli çeviri için Claude veya OpenAI API anahtarı
  • Yapay zeka çevirisi için internet erişimi (Gözden Geçir ve Uygula adımları tamamen çevrimdışı çalışır)

İş Akışına Genel Bakış

1. Çıkar    →   2. Otomatik Çeviri (isteğe bağlı)   →   3. Gözden Geçir   →   4. Uygula   →   5. Doğrula

Tüm komutlar Avant Leap sekmesi → Traduco panelindedir.

Adım 1 — Model Metnini Çıkar

Buton: Model Metnini Çıkar (camgöbeği simge)

Aktif Revit modelini tarar ve tüm çevrilebilir metinleri extraction.json dosyasına yazar.

Neler çıkarılır (10 kategori):

Kategori Yakalananlar
Proje Bilgisi Bina Adı, Proje Adı, Proje Numarası, Durum, Müşteri, Adres
Katlar Kat adları
Görünümler Görünüm adları (şablonlar ve dahili görünümler atlanır)
Aileler Aile adları ve tip adları
Eleman Tipleri Kategoriye göre gruplanmış aile olmayan tip isimleri
Örnek Parametreleri Yerleştirilmiş elemanlardaki seçilmiş metin parametreleri (isteğe bağlı — büyük modellerde yavaş olabilir)
Tip Parametreleri Eleman tiplerindeki seçilmiş metin parametreleri (isteğe bağlı — büyük modellerde yavaş olabilir)
Malzemeler Malzeme adları
Metin Notları Metin notu elemanlarının içeriği
Çizelge Başlıkları Tüm şablon olmayan çizelgelerin sütun başlıkları

Nasıl çalıştırılır:

  1. Bir Revit modeli açın.
  2. Model Metnini Çıkar butonuna tıklayın.
  3. Bir kategori seçim penceresi açılır — istediğiniz kategorileri işaretleyin (Örnek/Tip Parametreleri varsayılan olarak işaretli değildir, çünkü tarama süresi uzundur).
  4. Çıkar butonuna tıklayın. Bir ilerleme penceresi kategori bazında ilerlemeyi gösterir.
  5. Tamamlandığında bir özet, kategori başına kaç dize bulunduğunu gösterir.

Çıktı dosyası: {MyDocuments}\AvantLeap\Tools\Traduco\{ModelName}\{Year}\extraction.json

Adım 2 — Otomatik Çeviri (isteğe bağlı)

Buton: Otomatik Çeviri (mor simge)

Çıkarılan dizeleri bir yapay zeka sağlayıcısına gönderir ve çevirileri otomatik olarak doldurur. Bu adımı atlayabilir ve 3. adımda manuel olarak çevirebilirsiniz.

Nasıl çalıştırılır:

  1. Otomatik Çeviri butonuna tıklayın.
  2. Kaynak dili ve hedef dili açılır listelerden seçin.
  3. Yapay zeka sağlayıcınızı seçin (Claude veya OpenAI).
  4. API anahtarınızı API Anahtarı alanına yapıştırın.
  5. Test Modunu isteğe bağlı olarak etkinleştirin (sarı onay kutusu) — herhangi bir API çağrısı yapmadan çalışır; iş akışını test etmek için faydalı.
  6. Çevir butonuna tıklayın. Bir ilerleme çubuğu her partinin ilerlemesini gösterir.

Ne olur:

  • Global sözlükte bulunan girişler anında çözülür (API çağrısı veya token gerekmez).
  • Kalan girişler partilere ayrılır (her çağrıya 50 adet) ve yapay zeka sağlayıcısına gönderilir.
  • Başarılı her parti, gelecekte tekrar kullanım için global sözlüğü günceller.
  • Çevrilen girişlere ai durumu atanır.

Çıktı dosyası: {MyDocuments}\AvantLeap\Tools\Traduco\{ModelName}\{Year}\{SRC}_{TGT}.json (örn. ES_EN.json)

Küresel sözlük: {MyDocuments}\AvantLeap\Tools\Traduco\dictionary\{SRC}_{TGT}.json — tüm modeller arasında paylaşılır. Zamanla büyür, API maliyetini azaltır.

Adım 3 — Eşleştirmeleri Gözden Geçir

Buton: Eşleştirmeleri Gözden Geçir (sarı simge)

Çevirileri modele uygulamadan önce inceleyip düzenleyebileceğiniz ve onaylayabileceğiniz bir WPF ızgarası açar.

Nasıl kullanılır:

  1. Eşleştirmeleri Gözden Geçir butonuna tıklayın.
  2. Gözden geçirilmesini istediğiniz dil çiftini seçin (örn. ES → EN).
  3. Izgara tüm girişleri gösterir: kaynak metin, yapay zeka tarafından önerilen çeviri, kategori ve durum.
  4. Çeviri sütununda bir hücreye tıklayarak çevirileri doğrudan düzenleyin.
  5. Atlandı olarak işaretlenen girişler Uygula adımında hariç tutulur.
  6. Kategori ve Durum filtrelerini kullanarak belirli girişlere odaklanın.
  7. Pencereyi kapatın — değişiklikler otomatik olarak kaydedilir.

Girdi durumları:

Durum Anlamı
pending Henüz çevrilmedi
ai Yapay zeka tarafından dolduruldu (gözden geçirilmesi önerilir)
dict Küresel sözlükten çözüldü
manual Tarafınızdan düzenlendi
skipped Uygulayadan hariç tutuldu

Adım 4 — Çeviriyi Uygula

Buton: Çeviriyi Uygula (kırmızı simge)

Eşleştirme dosyasındaki çevirileri tekrar Revit modeline yazar. Modeli değiştiren tek adım budur.

Nasıl çalıştırılır:

  1. Çeviriyi Uygula butonuna tıklayın.
  2. Uygulanacak dil çiftini seçin.
  3. İşlemi onaylayın. Kaç elemanın yeniden adlandırılacağını gösteren bir özet gösterilir.
  4. Uygula butonuna tıklayın. Tüm değişiklikler tek bir TransactionGroup içinde yapılır — Revit'in geri alma geçmişinde tek bir Geri Al adımı olur.

Yazılanlar:

  • ai, dict veya manual durumundaki girişler (boş olmayan çeviri) uygulanır.
  • pending veya skipped durumundaki girişler dokunulmadan bırakılır.
  • Her giriş, saklanan ElementId ile tam olarak hedefleyen Revit elemanına uygulanır — isim eşleştirme belirsizliği yoktur.

Bilinen sınırlama — Paylaşılan Parametreler: Paylaşılan bir parametrenin görünen adını değiştirmek için parametrenin tekrar oluşturulması gerekir. Traduco, bu durumu bir uyarı olarak bildirir ve bu girişleri gizlice başarısız olmak yerine atlar.

Adım 5 — Kapsamı Doğrula

Buton: Kapsamı Doğrula (mavi simge)

Çıkarılanlarla çevrilenlerin kategorilere göre karşılaştırıldığı kapsam raporunu gösterir.

Rapor sütunları:

Sütun Anlamı
Kategori Çıkarma kategorisi
Toplam Çıkarılan toplam girdi
Çevrilen Boş olmayan çevirisi olan girdiler
Bekleyen Henüz çevirisi olmayan girdiler
Atlandı Atlandı olarak işaretlenen girdiler
Kapsam % Çevrilen / (Toplam − Atlandı)

Modeli paylaşmadan veya tekrar Uygula'yı çalıştırmadan önce eksikleri belirlemek için bu raporu kullanın.

Veri Depolama

Tüm Traduco verileri yerel olarak saklanır — bulut senkronizasyonu veya harici sunucu yoktur.

{MyDocuments}\AvantLeap\Tools\Traduco\
  {ModelName}\
    {Year}\
      extraction.json        ← kaynak metinler (Çıkar’da yeniden oluşturulur)
      ES_EN.json             ← İspanyolca → İngilizce çeviri eşlemesi
      ES_PT.json             ← İspanyolca → Portekizce çeviri eşlemesi
      config.json            ← son kullanılan dil çifti, sağlayıcı tercihi
  dictionary\
    ES_EN.json               ← küresel sözlük (tüm modeller arasında paylaşılır)
    ES_PT.json

API anahtarları yalnızca bellekte tutulur ve asla diske yazılmaz.

İpuçları

  • Model düzenlendikten sonra Çıkar’ı tekrar çalıştırın ve extraction.json'u tazeleyin. {SRC}_{TGT}.json içindeki mevcut çevirileriniz korunur — sadece yeni metinler pending olarak eklenir.
  • Sözlük zamanla büyür. Ne kadar çok model çevirirseniz, sonraki işlemler o kadar az API tokeni harcar.
  • API tokeni harcamadan tam akışı doğrulamak için Test Modunu kullanın (Çıkar → Otomatik Çeviri → Gözden Geçir → Uygula → Doğrula).
  • Tek bir Geri Al adımı. Tüm Uygula işlemi Revit'te tek bir TransactionGroup'tur — tüm yeniden adlandırmaları Ctrl+Z ile geri alabilirsiniz.

Sorun Giderme

Sorun Çözüm
Eklenti şeritte görünmüyor .addin dosyasının %APPDATA%\Autodesk\Revit\Addins\{Year}\ içinde olduğundan emin olun
Revit başlatılırken DLL bulunamadı hatası Derlemeden sonra deploylocal.bat'ı çalıştırın
Yapay zeka çeviri işlemi zaman aşımına uğruyor Daha az kategori seçerek partiyi küçültün; büyük Örnek/Tip parametre taramaları yavaş olabilir
Çizelge başlıkları uygulanmıyor ColumnHeading ayarlama davranışı Revit sürümüne göre değişir — Doğrulama raporunu kontrol edin
Uyguladıktan sonra eksik çeviriler Kapsamı Doğrula'yı kontrol edin — girdiler pending veya skipped durumda olabilir