Çeviriyi özellikle maintain ederken kullandığımız, ama herkesin faydalanabileceği bazı araçlar/yöntemler var, bunlardan bahsetmek istiyorum.

Dikkat: Eğer Windows'ta çalışıyorsanız tüm make komutları için Git Bash veya Bash (wsl) kullanın. Linux'te çalışırken gettext paketini yüklemeniz gerekmektedir.

Çeviriyi Build Etmek

Çeviriyi kendiniz build ederek, çevirdiğiniz dosyanın yayınlandığı zaman nasıl görüneceği hakkında bir fikir edinebilirsiniz. Ayrıca çeviri sırasında meydana gelebilen syntax ve referans hataları gibi hataları da burada göreceksiniz. Build işlemi tamamlandıktan sonra tarayıcıda file://path/to/project/venv/cpython/Doc/build/html/index.html adresini açarak çeviriyi görüntüleyebilirsiniz.

Dikkat: Eğer Windows'ta çalışıyorsanız tüm make komutları için Git Bash veya Bash (wsl) kullanın.

Not: Aşağıdaki komutları çalıştırmak, path/to/project/venv/cpython/ yolunda CPython klonlu değilse otomatik olarak klonlayacaktır (yaklaşık 800 MB).

Komutlar:

• make: Hiçbir seçenek vermeden bu komutu çalıştırdığınız zaman, tüm gerekli paketler yüklenir ve çeviri build edilir. Herhangi bir hata yoksa, en sonda çeviriyi görüntülemek için kullanabileceğiniz bir link verir.

• make clean: Build ederken oluşturulan dosya ve klasörleri temizler.

• make wrap: Uzun olan satırları düzenleyerek daha okunur hâle getirir.

Diğer komutlar için Makefile dosyasını inceleyebilirsiniz.

Sphinx-Lint

Sphinx-Lint çeviriyi build ederken tespit edilemeyen bazı syntax ve referans hatalarını hızlı şekilde görmemiz için kullandığımız bir araç. Kullanımı:

• sphinx-lint klasor/dosya.po: klasor/dosya.po'daki hataları gösterir.

• sphinx-lint *.po */*.po: Tüm dosyalardaki hataları gösterir.

Devamı gelecek...