Giter VIP home page Giter VIP logo

python-docs-tr's Introduction

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.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:
  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 People

Contributors

egeakman avatar ardasak avatar bengisuyarbas avatar irfan-karabacak avatar github-actions[bot] avatar morphaxthedeveloper avatar keronar avatar sefikaozturk avatar cvrnk avatar eylulye avatar ahmetveburak avatar egebatu81 avatar jrambrosia avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.