GitHub’a Çok Dilli Python Projesi Nasıl Yüklenir?

🌍 GitHub’a Çok Dilli Python Projesi Nasıl Yüklenir?

Uluslararası kullanıcı kitlesine hitap eden Python projelerinde çoklu dil desteği önemli bir rol oynar. GitHub üzerinde bu tür projeleri paylaşırken dosya yapısından README düzenine kadar dikkat edilmesi gereken birçok detay vardır. Bu yazıda, çok dilli bir Python projesinin GitHub’da nasıl en doğru şekilde yapılandırılacağını öğreneceksiniz.

✅ Örnek GitHub Dosya Yapısı

multi-lang-python-project/
├── src/
│   ├── main_tr.py
│   ├── main_en.py
│   └── utils.py
├── locales/
│   ├── tr/
│   │   └── messages.json
│   └── en/
│       └── messages.json
├── README.md
├── LICENSE
├── requirements.txt
├── .gitignore
└── setup.py
            

📌 Temel Bileşenler

• src/: Python kaynak dosyalarının bulunduğu ana klasör
• locales/: Dil dosyalarının yer aldığı yapı (JSON, gettext, YAML vb.)
• main_tr.py: Türkçe kullanıcı arayüzü veya çıktılar
• main_en.py: İngilizce kullanıcı arayüzü veya çıktılar
• README.md: Projenin detaylı açıklaması, çok dilli olabilir
• requirements.txt: Gerekli bağımlılıkların listesi
• setup.py: Paketleme ve dağıtım için yapılandırma

📝 README.md Dosyasında Çok Dilli İçerik

# Multi-Language Python Project

## 🇹🇷 Türkçe Açıklama

Bu proje Python kullanılarak geliştirilmiş çok dilli bir uygulamadır. Kullanıcı arayüzü hem Türkçe hem de İngilizce olarak sunulmaktadır.

## 🇬🇧 English Description

This is a multilingual Python application that supports both Turkish and English user interfaces.
            

🔧 requirements.txt Örneği

PyPDF2
Babel
            

🚀 GitHub’a Projeyi Yükleme Adımları

1. git init ile yerel bir depo oluşturun
2. git add . komutu ile tüm dosyaları ekleyin
3. git commit -m "İlk çok dilli sürüm" ile commit yapın
4. GitHub’da yeni bir depo oluşturun
5. git remote add origin https://github.com/kullaniciadi/proje-adi.git
6. git push -u origin main komutu ile projeyi yayınlayın

🌐 SEO ve Erişilebilirlik İpuçları

• README dosyasını hem Türkçe hem İngilizce yazın
• .gitignore kullanarak gereksiz dosyaları dışlayın
• LICENSE dosyası ile açık kaynak lisans belirtin
• Proje açıklaması ve etiketlerinde hem Türkçe hem İngilizce anahtar kelimelere yer verin
• topics kısmında python, multilingual, open-source gibi etiketler ekleyin

🧩 Opsiyonel: i18n (Internationalization) Kullanımı

from babel import Locale

lang = input("Dil seçin / Choose language (tr/en): ").lower()

if lang == "tr":
    print("Merhaba! Bu çok dilli bir uygulamadır.")
elif lang == "en":
    print("Hello! This is a multilingual application.")
else:
    print("Geçersiz dil / Invalid language")
            

🏁 Sonuç

GitHub’da çok dilli bir Python projesi paylaşırken doğru klasör yapısı, net bir README ve iyi organize edilmiş dosyalar büyük fark yaratır. Bu yapı sayesinde projeniz sadece geliştiricilere değil, çok dilli son kullanıcılara da kolayca ulaşır.