python/python-docs-tr

Turkish Translation of the Python Documentation

Python Dokümantasyonu Türkçe Çevirisi

Dokümantasyon Katkı Anlaşması

Bu proje gönüllü çevirmenler ve python-docs-tr ekibi iş birliğinde sürdürülmektedir. Bu anlaşma, çeviri sürecindeki tüm katılımcıların haklarını ve sorumluluklarını tanımlamaktadır. Projeyi GitHub ve diğer halka açık mecralarda yayınlayarak ve projeye katkı veya iyileştirme yaparak, katkılarınızı CC0 lisansı altında PSF'in kullanımına sunmuş olursunuz. Karşılığında, çeviri yaptığınız kısım için halka açık olarak övgü toplayabilirsiniz. Eğer çeviriniz PSF tarafından kabul edilirse, (eğer isterseniz) TRANSLATORS dosyasına isminizi ekleyerek bir yama gönderebilirsiniz. Yaptığınız katkı metinsel olmasa bile Python topluluğuna katılımınızı memnuniyetle karşılıyor ve herkesi katkı sağlamaya davet ediyoruz.

Çalışmanızı dokümantasyona dahil edilmek üzere PSF'e göndererek bu anlaşmayı kabul etmiş sayılırsınız.

Çeviriye Katkıda Bulunmak

Gereklilikler

• Bir GitHub hesabı
• Yüklü bir Git istemcisi
• .po dosyalarını düzenlemek için poedit gibi bir program
• Yüklü bir Python ve pip versiyonu (en son stabil olan versiyon önerilir)

Adımlar

Rezervasyon

Çeviri yapmak istediğiniz bir dosyaya rezervasyon oluşturmak için şu adımları izleyin:

1. Issues > New Issue > Get started düğmelerini takip ederek rezervasyon formunu açın.
2. foo/bar.po taslağını, çalışmak istediğiniz dosyanın yolu ile değiştirin.
   • Örnegin, "library/functions.po üzerinde çalışmak istiyorum".
3. Submit new issue düğmesine tıklayarak rezervasyonunuzu oluşturun ve çeviriyi üstlenin.

Projeye ilk başlarken

1. Projeyi GitHub üzerinden forklayın.
2. Forkladığınız projeyi bilgisayarınıza klonlayın.
   • git clone https://github.com/<kullaniciadi>/python-docs-tr.git
3. Çevirmek istediğiniz dosyanın ismiyle bir branch oluşturun.
   • Örneğin, library/functions.po dosyasını çevirmek istiyorsanız, library-functions adında bir branch oluşturun.
   • git checkout -b library-functions
4. Gerekli paketleri yükleyin.
   • python -m pip install --upgrade -r requirements-dev.txt
5. Syntax hatalarını commit öncesi otomatik kontrol eden pre-commit 'i kurun.
   • pre-commit install

Çalışma döngüsü

1. Doğru branchte olduğunuzdan emin olun.
   • git checkout library-functions
2. Çevirmek istediğiniz dosyayı poedit ile açın.
3. Çevirilerinizi yapın ve kaydedin.
4. Çevirilerinizi kendi forkunuza yükleyin.
   • git add library/functions.po
   • git commit -m "Çeviri tamamlandı."
   • git push origin library-functions

Çeviri tamamlandıktan sonra

1. TRANSLATORS dosyasına isminizi ekleyin. (Çeviri kabul edilirse yaptığınız katkı için övgü toplayabilirsiniz.)
2. GitHub üzerinden çevirilerinizi göndermek için bir pull request oluşturun.
3. Çevirilerinizin kabul edilmesini bekleyin.
   • Bu süreçte çevirileriniz, uygunluğunu ve yazım hatalarını değerlendirmek için birkaç kişi tarafından incelenecektir.
   • İncelemenin sonucunda bazı değişiklikler yapmanız istenebilir.

Dikkat Etmeniz Gerekenler

1. Çeviri yaparken yararlanabileceğiniz kaynaklar:
   • İmla kuralları ve Türkçe anlamlar: Türk Dil Kurumu
   • İngilizce-Türkçe terim çevirileri: Bilkent Üniversitesi Bilişim Sözlüğü
   • İngilizce-Türkçe sözlük: Tureng
2. Çevirilerinizde terimlerin doğru kullanılmasına dikkat edin. Örneğin:
   • string ve str terimleri aynı şeyi temsil etmemektedir.
   • string terimi, Python'da metinleri temsil etmek için kullanılan bir veri tipi olup, str ise bu veri tipiyle ilgili fonksiyonlar ve metotlarda kullanılan bir kısaltmadır.
3. Çevirilerinizde bir terimin birden fazla çevirisi olması durumunda, önceki çevirilerde kullanılan çeviriyi kullanın.
   • Örneğin, string terimi için dize ve metin çevirileri kullanılmıştır. Bu durumda dize terimini tercih edin.

python-docs-tr's Issues

library/venv.po üzerinde çalışmak istiyorum.

howto/clinic.po üzerinde çalışmak istiyorum.

test

Backtick issue in tutorial

Around those lines:

$ git grep -C5 'd->insert(`'
tutorial/datastructures.po-#: tutorial/datastructures.rst:734
tutorial/datastructures.po-msgid ""
tutorial/datastructures.po-"Other languages may return the mutated object, which allows method chaining, "
tutorial/datastructures.po-"such as ``d->insert(\"a\")->remove(\"b\")->sort();``."
tutorial/datastructures.po-msgstr ""
tutorial/datastructures.po:"Diğer diller, ``d->insert(``a``)->sove(``b``)->sort();``. gibi yöntem "
tutorial/datastructures.po-"zincirlemesine izin veren değiştirilmiş nesneyi döndürebilir."

It gets rendered at the very bottom of this page like this:

Diğer diller, d->insert(``a)->sove(b)->sort();``. gibi yöntem zincirlemesine izin veren değiştirilmiş nesneyi döndürebilir.

howto/regex.po üzerinde çalışmak istiyorum.

ACİL DOSYA LAZIM AAACİL

foo/bar.po üzerinde çalışmak istiyorum.

library/collections.po üzerinde çalışmak istiyorum.

library/abc.po üzerinde çalışmak istiyorum.

tutorial/introduction.po üzerinde çalışmak istiyorum.

Yeni sürümlerle beraber gelen kısımları çevirmek istiyorum.( tutorial/introduction.po)

whatsnew/3.7.po üzerinde çalışmak istiyorum.

howto/annotations.po üzerinde çalışmak istiyorum.

howto/curses.po üzerinde çalışmak istiyorum.

Localde değişiklikleri görmek

Yaptığımız çevirileri localimizde hızlı bir şekilde görmek çok güzel olur. Bunun için bir rehber hazırlanabilir.

• Projeye hız kazandırır.
• Çevirilerimizde bir hata varsa bunları localimizde görüp daha rahat fixleyebiliriz.

tutorial/stdlib2

library/math.po üzerinde çalışmak istiyorum.

Tüm çeviri sürecini ve döngüsünü adım adım gösteren bir video hazırlanmalı

Yeni başlayanlar ve teknik kısmı bilmeyenler için yapılması gerekenleri adım adım gösteren öğretici bir video hazırlanmalı.

library/turtle.po üzerinde çalışmak istiyorum.

library/datetime.po üzerinde çalışmak istiyorum.

library/asyncio.po üzerinde çalışmak istiyorum.

library/urllib.po üzerinde çalışmak istiyorum.

Merhaba library/urllib.po dosyası üzerinde çalışmak istiyorum. library/urllib.po dosyasını rezerve ettim herhangi bir çakışma olmaması açısından daha önce düzenlemezseniz sevinirim. Eğer benimle aynı dosya üzerinde çalışmak isteyen varsa buradan yazıp beni etiketlemesi yeterlidir.

library/datetime.po üzerinde çalışmak istiyorum.

glossary.po üzerinde çalışmak istiyorum.

test

library/stdtypes.po üzerinde çalışmak istiyorum.

library/time.po üzerinde çalışmak istiyorum.

howto/ipaddress.po üzerinde çalışmak istiyorum

tutorial/classes üzerinde çalışmak istiyorum.

Eksik olan kısımları çevirmek isterim.

foo/bar.po üzerinde çalışmak istiyorum.

extending/windows.po üzerinde çalışmak istiyorum.

tutorial/controlflow.po üzerinde çalışmak istiyorum.

howto/sorting.po üzerinde çalışmak istiyorum.

tutorial/modules üzerinde çalışmak istiyorum

tutorial/modules.po yeni sürümle gelen kısımların çevirisini yapmak isterim.😊

library/exceptions.po üzerinde çalışmak istiyorum.

library/exceptions.po çevirisi yapmak istiyorum

library/collections üzerinde çalışmak istiyorum.

foo/bar.po üzerinde çalışmak istiyorum.

library/tk.po üzerinde çalışmak istiyorum.

library/tk.po dosyası üzerinde çevirme yapmak istiyorum. Daha önce çevirmesini yapan veya beraber yapmak isteyenler beni bu issue üzerinden etiketleyerek iletişime geçebilir.

README'ye rezervasyon adimlarinin eklenmesi

Ceviri surecininin daha iyi takip edilebilmesi ve olasi ceviri cakismalarinin onlenmesi icin ceviri dosyalarinin rezerve edilmesi README dosyasina dahil edilebilir.

Older versions will no longer be maintained

EN:

Maintaining older versions of the documentation is challenging with very limited resources. Any inaccuracies or outdated information in those older versions will no longer be corrected.

We can only ensure the accuracy and upkeep of the latest stable version of our documentation. Currently, the latest stable version is version 3.11. This will be updated to version 3.12 on October 2023 when it is released, and so on.

You can always check the latest stable version from the left panel at docs.python.org:

TR:

Dokümantasyonun eski versiyonlarını devam ettirmek, çok sınırlı kaynaklar nedeniyle bizim için oldukça zor oluyor. Bu sebeple eski sürümlerdeki herhangi bir yanlışlık veya güncel olmayan bilgi artık düzeltilmeyecektir.

Dokümantasyonun yalnızca en son kararlı sürümünün doğruluğundan ve devam ettirilmesini üstleneceğiz. Şu anda en son kararlı sürüm 3.11 sürümü olmakla beraber, Ekim 2023'te 3.12 sürümüne güncellenecektir.

En son kararlı sürümü, docs.python.org adresindeki sol panelden kontrol edebilirsiniz:

Originally posted by @egeakman in #86 (comment)