co-op-translator

Co-op Translator: Eğitim Dokümantasyonunu Kolayca Otomatik Çevirin

Dokümantasyonunuzu birden fazla dile kolayca otomatik çevirerek global bir kitleye ulaşın.

Co-op Translator ile Güçlendirilmiş Dil Desteği

[!NOTE] Bunlar bu depo içeriğinin mevcut çevirileridir. Co-op Translator tarafından desteklenen dillerin tam listesi için lütfen Language Support bölümüne bakınız.

Genel Bakış: Eğitim İçeriğinizin Çevirisini Kolaylaştırın

Dil engelleri, dünya genelindeki öğrenenler ve geliştiriciler için değerli eğitim kaynaklarına ve teknik bilgiye erişimi önemli ölçüde zorlaştırır. Bu durum katılımı sınırlar ve küresel inovasyon ile öğrenme hızını yavaşlatır.

Co-op Translator, Microsoft’un kendi büyük ölçekli eğitim serileri (örneğin “Yeni Başlayanlar İçin” rehberleri) için verimsiz manuel çeviri sürecini çözme ihtiyacından doğdu. Herkes için bu engelleri kaldırmak üzere kolay kullanımlı, güçlü bir araç haline evrildi. CLI ve GitHub Actions aracılığıyla yüksek kaliteli otomatik çeviriler sunarak, Co-op Translator eğitimcilerin, öğrencilerin, araştırmacıların ve geliştiricilerin dünya çapında dil engeli olmadan bilgi paylaşmasını ve erişmesini sağlar.

Co-op Translator’ın çevrilmiş eğitim içeriğini nasıl düzenlediğine göz atın:

Example

Markdown dosyaları ve resim metinleri otomatik olarak çevrilir ve dil bazlı klasörlere düzenli şekilde yerleştirilir.

Eğitim içeriğinize Co-op Translator ile bugün küresel erişim sağlayın!

Microsoft’un Öğrenme Kaynakları İçin Küresel Erişimi Desteklemek

Co-op Translator, küresel geliştirici topluluğuna hizmet eden Microsoft’un önemli eğitim girişimleri için dil bariyerini aşmaya yardımcı olur ve çeviri sürecini otomatikleştirir. Şu anda Co-op Translator kullanan örnekler şunlardır:

Temel Özellikler

Otomatik Çeviriler: Metni kolayca birden fazla dile çevirin.
GitHub Actions Entegrasyonu: Çevirileri CI/CD sürecinizin bir parçası olarak otomatikleştirin.
Markdown Koruma: Çeviri sırasında doğru Markdown sözdizimini koruyun.
Resim Metni Çevirisi: Resimlerdeki metni çıkarıp çevirin.
Gelişmiş LLM Teknolojisi: Yüksek kaliteli çeviriler için son teknoloji dil modellerini kullanın.
Kolay Entegrasyon: Mevcut proje yapınıza sorunsuz entegre edin.
Yerelleştirmeyi Basitleştirin: Projenizin uluslararası pazarlara uyarlanmasını kolaylaştırın.

Nasıl Çalışır

Architecture

Co-op Translator, proje klasörünüzdeki Markdown dosyalarını ve resimleri şu şekilde işler:

Metin Çıkarma: Markdown dosyalarından ve yapılandırıldıysa (örneğin Azure AI Vision ile) resim içindeki gömülü metni çıkarır.
Yapay Zeka Çevirisi: Çıkarılan metni yapılandırılmış LLM’ye (Azure OpenAI, OpenAI vb.) gönderir.
Sonuç Kaydetme: Çevrilmiş Markdown dosyalarını ve (çevirisi yapılmış metin içeren) resimleri dil bazlı klasörlere, orijinal biçimlendirmeyi koruyarak kaydeder.

Başlarken

CLI ile hızlıca başlayabilir veya GitHub Actions ile tam otomasyon kurabilirsiniz. İş akışınıza en uygun yöntemi seçin:

Komut Satırı (CLI) - Tek seferlik çeviriler veya manuel kontrol için
GitHub Actions - Her push’da otomatik çeviriler için

[!NOTE] Bu öğretici Azure kaynaklarına odaklanmakla birlikte, desteklenen herhangi bir dil modelini kullanabilirsiniz.

Dil Desteği

Co-op Translator, küresel bir kitleye ulaşmanıza yardımcı olmak için çok sayıda dili destekler. İşte bilmeniz gerekenler:

Hızlı Referans

Dil	Kod	Dil	Kod	Dil	Kod
Arapça	ar	Bengalce	bn	Bulgarca	bg
Burmaca (Myanmar)	my	Çince (Basitleştirilmiş)	zh	Çince (Geleneksel, HK)	hk
Çince (Geleneksel, Macau)	mo	Çince (Geleneksel, TW)	tw	Hırvatça	hr
Çekçe	cs	Danca	da	Flemenkçe	nl
Fince	fi	Fransızca	fr	Almanca	de
Yunanca	el	İbranice	he	Hintçe	hi
Macarca	hu	Endonezce	id	İtalyanca	it
Japonca	ja	Korece	ko	Malayca	ms
Marathi	mr	Nepali	ne	Norveççe	no
Farsça (Persçe)	fa	Lehçe	pl	Portekizce (Brezilya)	br
Portekizce (Portekiz)	pt	Pencapça (Gurmukhi)	pa	Romence	ro
Rusça	ru	Sırpça (Kiril)	sr	Slovakça	sk
Slovence	sl	İspanyolca	es	Svahili	sw
İsveççe	sv	Tagalog (Filipince)	tl	Tayca	th
Türkçe	tr	Ukraynaca	uk	Urduca	ur
Vietnamca	vi	—	—	—	—

Dil Kodlarının Kullanımı

Co-op Translator kullanırken dilleri kodlarıyla belirtmeniz gerekir. Örneğin:

# Translate to French, Spanish, and German
translate -l "fr es de"

# Translate to Chinese (Simplified) and Japanese
translate -l "zh ja"

[!NOTE] Dil desteği hakkında ayrıntılı teknik bilgiler için, şunlar dahil:

Her dil için yazı tipi özellikleri

Bilinen sorunlar

Yeni dillerin nasıl ekleneceği

Bakınız: Supported Languages Documentation.

Desteklenen Modeller ve Servisler

Tür	İsim
Dil Modeli
AI Vision

[!NOTE] AI vision servisi mevcut değilse, co-op translator Markdown-only mode moduna geçer.

İlk Kurulum

Başlamadan önce aşağıdaki kaynakları kurmanız gerekir:

Dil Modeli Kaynağı (Zorunlu):
- Azure OpenAI (Önerilen) - Kurumsal düzeyde güvenilirlik ile yüksek kaliteli çeviriler sağlar
- OpenAI - Azure erişiminiz yoksa alternatif seçenek
- Desteklenen modeller hakkında ayrıntılar için Supported Models and Services bölümüne bakın
AI Vision Kaynağı (İsteğe Bağlı):
- Azure AI Vision - Resim içindeki metinlerin çevirisini mümkün kılar
- Yapılandırılmamışsa, çevirmen otomatik olarak Markdown-only mode kullanır
- Metin içeren resimlere sahip projeler için önerilir
Yapılandırma Adımları:
- Ayrıntılı talimatlar için Azure AI setup guide kılavuzunu izleyin
- API anahtarlarınız ve uç noktalarınızla bir .env dosyası oluşturun (bkz. Quick Start bölümü)
- Seçtiğiniz servisler için gerekli izin ve kota sahip olduğunuzdan emin olun

Çeviri Öncesi Proje Hazırlığı

Çeviri sürecine başlamadan önce projenizi hazırlamak için şu adımları izleyin:

README’nizi Hazırlayın:

README.md dosyanıza çevirilere bağlantı verecek bir çeviri tablosu ekleyin

Örnek format:

### 🌐 Multi-Language Support
     
[French](/co-op-translator/translations/fr/) | [Spanish](/co-op-translator/translations/es/) | [German](/co-op-translator/translations/de/) | [Russian](/co-op-translator/translations/ru/) | [Arabic](/co-op-translator/translations/ar/) | [Persian (Farsi)](/co-op-translator/translations/fa/) | [Urdu](/co-op-translator/translations/ur/) | [Chinese (Simplified)](/co-op-translator/translations/zh/) | [Chinese (Traditional, Macau)](/co-op-translator/translations/mo/) | [Chinese (Traditional, Hong Kong)](/co-op-translator/translations/hk/) | [Chinese (Traditional, Taiwan)](/co-op-translator/translations/tw/) | [Japanese](/co-op-translator/translations/ja/) | [Korean](/co-op-translator/translations/ko/) | [Hindi](/co-op-translator/translations/hi/) | [Bengali](/co-op-translator/translations/bn/) | [Marathi](/co-op-translator/translations/mr/) | [Nepali](/co-op-translator/translations/ne/) | [Punjabi (Gurmukhi)](/co-op-translator/translations/pa/) | [Portuguese (Portugal)](/co-op-translator/translations/pt/) | [Portuguese (Brazil)](/co-op-translator/translations/br/) | [Italian](/co-op-translator/translations/it/) | [Polish](/co-op-translator/translations/pl/) | [Turkish](/co-op-translator/translations/tr/) | [Greek](/co-op-translator/translations/el/) | [Thai](/co-op-translator/translations/th/) | [Swedish](/co-op-translator/translations/sv/) | [Danish](/co-op-translator/translations/da/) | [Norwegian](/co-op-translator/translations/no/) | [Finnish](/co-op-translator/translations/fi/) | [Dutch](/co-op-translator/translations/nl/) | [Hebrew](/co-op-translator/translations/he/) | [Vietnamese](/co-op-translator/translations/vi/) | [Indonesian](/co-op-translator/translations/id/) | [Malay](/co-op-translator/translations/ms/) | [Tagalog (Filipino)](/co-op-translator/translations/tl/) | [Swahili](/co-op-translator/translations/sw/) | [Hungarian](/co-op-translator/translations/hu/) | [Czech](/co-op-translator/translations/cs/) | [Slovak](/co-op-translator/translations/sk/) | [Romanian](/co-op-translator/translations/ro/) | [Bulgarian](/co-op-translator/translations/bg/) | [Serbian (Cyrillic)](/co-op-translator/translations/sr/) | [Croatian](/co-op-translator/translations/hr/) | [Slovenian](/co-op-translator/translations/sl/) | [Ukrainian](/co-op-translator/translations/uk/) | [Burmese (Myanmar)](/co-op-translator/translations/my/)

Mevcut Çevirileri Temizleyin (gerekirse):
- Var olan çeviri klasörlerini kaldırın (örneğin translations/)
- Eski çeviri dosyalarını silerek temiz bir başlangıç yapın
- Bu, yeni çeviri süreciyle çakışmaları önler

Hızlı Başlangıç: Komut Satırı

Komut satırı ile hızlı başlamak için:

Sanal ortam oluşturun:
```
 python -m venv .venv
```
Sanal ortamı etkinleştirin:
- Windows üzerinde:
```
 .venv\scripts\activate
```
- Linux/macOS üzerinde:
```
 source .venv/bin/activate
```
Paketi yükleyin:
```
 pip install co-op-translator
```
Kimlik Bilgilerini Yapılandırın:
- Bir .env file in your project’s root directory.
- Copy the contents from the .env.template file into your new .env file.
- Fill in the required API keys and endpoint information in your .env file.
Run Translation:
- Navigate to your project’s root directory in your terminal.
- Execute the translate command, specifying target languages with the -l bayrağı oluşturun:
```
 translate -l "ko ja fr"
```

(Devam eden metin görünmüyor, ancak isterseniz devamını da çevirebilirim.)

Reponuzdaki "ko ja fr" with your desired space-separated language codes)_

Detailed Usage Guides

Choose the approach that best fits your workflow:

1. Using the Command Line (CLI)

Best for: One-time translations, manual control, or integration into custom scripts.
Requires: Local installation of Python and the co-op-translator package.
Guide: Command Line Guide

2. Using GitHub Actions (Automation)

Best for: Automatically translating content whenever changes are pushed to your repository. Keeps translations consistently up-to-date.
Requires: Setting up a workflow file (.github/workflows) dosyasını değiştirin. Yerel kurulum gerekmez.
Kılavuzlar:
- GitHub Actions Guide (Public Repositories & Standard Secrets) - Standart depo gizli anahtarları kullanan çoğu genel veya kişisel depo için bunu kullanın.
- GitHub Actions Guide (Microsoft Organization Repos & Org-Level Setups) - Microsoft GitHub organizasyonu içinde çalışıyorsanız veya organizasyon seviyesinde gizli anahtarlar veya koşucular kullanmanız gerekiyorsa bu kılavuzu takip edin.

Sorun Giderme ve İpuçları

Sorun Giderme Kılavuzu

Ek Kaynaklar

Komut Referansı: Mevcut tüm komutlar ve seçenekler için detaylı kılavuz.
Desteklenen Diller: Desteklenen diller listesi ve yeni diller ekleme talimatları.
Markdown-Only Modu: Sadece metin çevirisi, resim çevirisi olmadan nasıl yapılır.

Video Sunumları

Co-op Translator hakkında daha fazla bilgi edinmek için sunumlarımızı izleyin (YouTube’da izlemek için aşağıdaki görsele tıklayın.):

Open at Microsoft: Co-op Translator kullanımına dair kısa 18 dakikalık tanıtım ve hızlı rehber.

Bizi Destekleyin ve Küresel Öğrenmeyi Teşvik Edin

Eğitim içeriklerinin dünya çapında paylaşım şeklini değiştirmemize katılın! Co-op Translator projesine GitHub’da bir ⭐ verin ve öğrenme ile teknolojide dil engellerini kaldırma misyonumuzu destekleyin. İlginiz ve katkılarınız büyük fark yaratıyor! Kod katkıları ve özellik önerileri her zaman memnuniyetle karşılanır.

Katkıda Bulunma

Bu proje katkı ve önerilere açıktır. Azure Co-op Translator’a katkıda bulunmak ister misiniz? Co-op Translator’ı daha erişilebilir hale getirmek için nasıl yardımcı olabileceğinizi öğrenmek üzere lütfen CONTRIBUTING.md dosyasına bakın.

Katkıda Bulunanlar

Davranış Kuralları

Bu proje, Microsoft Open Source Code of Conduct kurallarını benimsemiştir. Daha fazla bilgi için Code of Conduct FAQ sayfasını ziyaret edebilir veya ek soru ya da yorumlarınız için opencode@microsoft.com adresiyle iletişime geçebilirsiniz.

Sorumlu Yapay Zeka

Microsoft, müşterilerimizin yapay zeka ürünlerimizi sorumlu şekilde kullanmalarına yardımcı olmaya, öğrendiklerimizi paylaşmaya ve Transparency Notes ve Impact Assessments gibi araçlarla güvene dayalı ortaklıklar kurmaya kararlıdır. Bu kaynakların çoğuna https://aka.ms/RAI adresinden ulaşabilirsiniz.
Microsoft’un sorumlu yapay zeka yaklaşımı, adalet, güvenilirlik ve güvenlik, gizlilik ve emniyet, kapsayıcılık, şeffaflık ve hesap verebilirlik gibi yapay zeka ilkelerimize dayanmaktadır.

Bu örnekte kullanılanlar gibi büyük ölçekli doğal dil, görsel ve konuşma modelleri, haksız, güvenilmez veya rahatsız edici davranışlar sergileyerek zarar verebilir. Riskler ve sınırlamalar hakkında bilgi edinmek için lütfen Azure OpenAI hizmeti Transparency note sayfasına bakın.

Bu riskleri azaltmak için önerilen yöntem, mimarinizde zararlı davranışları tespit edip önleyebilen bir güvenlik sistemi bulundurmaktır. Azure AI Content Safety, uygulamalarda ve hizmetlerde zararlı kullanıcı ve yapay zeka üretimi içerikleri tespit edebilen bağımsız bir koruma katmanı sunar. Azure AI Content Safety, zararlı materyalleri tespit etmek için metin ve görsel API’leri içerir. Ayrıca, farklı modalitelerde zararlı içeriği tespit etmek için örnek kodları görüntüleyip deneyebileceğiniz etkileşimli bir Content Safety Studio da bulunmaktadır. Aşağıdaki hızlı başlangıç dokümantasyonu hizmete istek yapmanızı adım adım yönlendirir.

Bir diğer önemli husus ise genel uygulama performansıdır. Çok modlu ve çok modeller içeren uygulamalarda performans, sistemin sizin ve kullanıcılarınızın beklentilerine uygun şekilde çalışması, zararlı çıktılar üretmemesi anlamına gelir. Uygulamanızın genel performansını değerlendirmek için üretim kalitesi ve risk ile güvenlik metrikleri kullanılmalıdır.

Yapay zeka uygulamanızı geliştirme ortamınızda prompt flow SDK kullanarak değerlendirebilirsiniz. Test veri seti veya hedef verildiğinde, üretici yapay zeka uygulamanızın çıktıları yerleşik ya da sizin seçtiğiniz özel değerlendiricilerle nicel olarak ölçülür. Prompt flow SDK ile sisteminizi değerlendirmeye başlamak için hızlı başlangıç rehberini takip edebilirsiniz. Değerlendirme çalışmasını tamamladıktan sonra, sonuçları Azure AI Studio’da görselleştirebilirsiniz.

Ticari Markalar

Bu proje, projeler, ürünler veya hizmetler için ticari marka ya da logolar içerebilir. Microsoft ticari markalarının veya logolarının yetkili kullanımı, Microsoft’un Ticari Marka ve Marka Kılavuzları kurallarına tabidir ve bunlara uyulmalıdır.
Microsoft ticari markalarının veya logolarının bu projenin değiştirilmiş sürümlerinde kullanımı, karışıklığa yol açmamalı veya Microsoft’un sponsorluğunu ima etmemelidir.
Üçüncü taraf ticari marka veya logolarının kullanımı ise ilgili üçüncü taraf politikalarına tabidir.

Feragatname:
Bu belge, AI çeviri hizmeti Co-op Translator kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hatalar veya yanlışlıklar içerebileceğini lütfen unutmayınız. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucunda ortaya çıkabilecek yanlış anlamalar veya yanlış yorumlamalar nedeniyle sorumluluk kabul edilmemektedir.

This site is open source. Improve this page.