macOS üzerine kurulum

Donanım gereksinimleri

Weblate, herhangi bir çağdaş donanımda sorunsuz çalışmalıdır, Tek bir sunucuda Weblate bileşenlerini (Weblate, veri tabanı ve site sunucusu) çalıştırmak için gerekli en az yapılandırma şu şekildedir:

  • 3 GB RAM bellek

  • 2 işlemci çekirdeği

  • 1 GB depolama alanı

Not

Weblate kurulumunuz için gerçek gereksinimler, üzerinde bulunacak çevirilerin boyutuna bağlı olarak büyük ölçüde değişiklik gösterebilir.

Bellek kullanımı

Bellek ne kadar çok olursa o kadar iyidir. Tüm düzeylerde (dosya sistemi, veri tabanı ve Weblate) ön bellek için kullanılır. Yüzlerce çeviri bileşeni için en az 4 GB RAM bellek önerilir.

İpucu

Önerilenden daha az bellek bulunan sistemler için Tek işlemli Celery kurulumu önerilir.

İşlemci kullanımı

Eşzamanlı bulunacak kullanıcı sayısı, gerekli işlemci çekirdeği sayısını artırır.

Depolama alanı kullanımı

Tipik veri tabanı depolama alanı gereksinimi, barındırılacak 1 milyon sözcük için yaklaşık 300 MB olarak düşünebilir.

Kopyalanmış depolar için gereken depolama alanı değişiklik gösterir. Ancak Weblate sığ kopyalama ile depo boyutlarını en az düzeyde tutmaya çalışır.

Düğümler

Küçük ve orta ölçekli siteler (milyonlarca barındırılan sözcük) için, tüm Weblate bileşenleri (ayrıntılı bilgi almak için: Mimari özeti) tek bir düğümde çalıştırılabilir.

Yüz milyonlarca barındırılan sözcüğe ulaştığınızda, veri tabanı için özel bir düğüm kullanmanız önerilir (ayrıntılı bilgi almak için: Weblate için veri tabanı kurulumu).

Kurulum

Sistem gereksinimleri

Python modüllerini oluşturmak için gereken bağımlılıkları kurun (ayrıntılı bilgi almak için: Yazılım gereksinimleri):

brew install python pango cairo gobject-introspection glib libyaml pkgconf zstd lz4 xxhash libxmlsec1 librsvg uv

İsteğe bağlı olarak üretim sunucusunu çalıştırmak için gereken yazılımı kurun. Ayrıntılı bilgi almak için: Sunucuyu çalıştırmak, Weblate için veri tabanı kurulumu, Celery ile arka plan görevlerini kullanmak. Kurulumunuzun boyutuna bağlı olarak, bu bileşenleri adanmış sunucular üzerinde çalıştırmak isteyebilirsiniz.

Yerel kurulum yönergesi:

# Web server option 1: NGINX and uWSGI
brew install nginx uwsgi

# Web server option 2: Apache with ``mod_wsgi``
brew install httpd

# Caching backend: Valkey
brew install valkey

# Database server: PostgreSQL
brew install postgresql

# Gettext for the msgmerge add-on
brew install gettext

Python modülleri

İpucu

Weblate kurulumunu ayrı bir Python ortamına yapıyoruz.

  1. Weblate için Python ortamını oluşturun:

    uv venv ~/weblate-env

  2. Weblate için Python ortamını etkinleştirin:

    . ~/weblate-env/bin/activate

  3. Tüm isteğe bağlı bağımlılıklar ile birlikte Weblate kurulumunu yapın:

    # Install Weblate with all optional dependencies
uv pip install "weblate[all]"

    İsteğe bağlı bağımlılıkları ayarlamak için lütfen Python bağımlılıkları seçeneğini denetleyin.

Ayrıca bakınız

Weblate platformunu yapılandırmak

Not

Aşağıdakiler, Weblate tarafından kullanılan Python ortamının etkinleştirildiğini varsayar (. ~/weblate-env/bin/activate yürütülerek). Yoksa, weblate komutunun tam yolunu ~/weblate-env/bin/weblate olarak belirtin.

  1. ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py dosyasını ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py dosyası olarak kopyalayın.

  2. Yeni settings.py dosyasındaki değerleri istediğiniz gibi ayarlayın. En azından veri tabanı kimlik doğrulama bilgilerini ve Django gizli anahtarını belirtmeniz gerekir. Ancak üretim kurulumu için daha fazla değişiklik yapmak isteyeceksiniz. Ayrıntılı bilgi almak için: Yapılandırmayı ayarlama.

  3. Weblate için veri tabanını ve yapısını oluşturun (örnek ayarlar PostgreSQL kullanır, üretime hazır bir kurulum için Weblate için veri tabanı kurulumu bölümüne bakabilirsiniz):

    weblate migrate

    Ayrıca bakınız

    migrate

  4. Yönetici için bir admin hesabı oluşturun, parolasını oluşturun ve panoya kopyalayarak daha sonra kullanmak üzere kaydedin:

    weblate createadmin

    İpucu

    Yönetici parolasını daha önce unuttuysanız ya da kaybettiyseniz şu komutla yeni bir parola oluşturabilirsiniz:

    weblate createadmin --update

    Ayrıca bakınız

    createadmin

  5. Site sunucunuz için durağan dosyaları derleyin (ayrıntılı bilgi almak için: Sunucuyu çalıştırmak ve Durağan dosyalar sunmak):

    weblate collectstatic

  6. JavaScript ve CSS dosyalarını sıkıştırın (isteğe bağlı. Ayrıntılı bilgi almak için: İstemci varlıklarının sıkıştırılması):

    weblate compress

  7. Celery işlemlerini başlatın. Bu adım, geliştirme ortamları için gerekli değildir. Ancak üretim ortamlarında yapılması önemle önerilir. Ayrıntılı bilgi almak için: Celery ile arka plan görevlerini kullanmak:

    celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup

  8. Geliştirme sunucusunu başlatın (Sunucuyu çalıştırmak bölümünden üretim kurulumunun ayrıntılarına bakabilirsiniz):

    weblate runserver

Kurulum sonrası

Tebrikler, Weblate sunucunuz artık çalışıyor ve kullanmaya başlayabilirsiniz.

  • Weblate arayüzüne http://localhost:8000/ adresinden erişebilirsiniz.

  • Kurulum sırasında belirtilen yönetici kimlik doğrulama bilgileriyle oturum açın ya da yeni kullanıcı hesapları açın.

  • Weblate Python ortamı etkinleştirildiğinde weblate komutunu kullanarak Weblate komutlarını yürütebilirsiniz. Ayrıntılı bilgi almak için: Yönetim komutları.

  • Deneme sunucusunu Ctrl+C tuşlarıyla durdurabilirsiniz.

  • Kurulumunuzla ilgili olası sorunları /manage/performance/ adresinden (ayrıntılı bilgi almak için: Başarım raporu) ya da weblate check --deploy komutundan görebilirsiniz. Ayrıntılı bilgi almak için: Üretim kurulumu.

Çeviri eklemek

  1. Yönetim arayüzünü açın (http://localhost:8000/create/project/) ve çevirmek istediğiniz bir proje oluşturun. Ayrıntılı bilgi almak için: Proje yapılandırması.

    Burada yalnızca proje adını ve sitesini belirtmeniz gerekir.

  2. Çeviri için gerçek nesne olan bir bileşen oluşturun. Sürüm denetimi sistemi deposunu yönlenir ve hangi dosyaların çevrileceğini seçer. Ayrıntılı bilgi almak için: Bileşen yapılandırması.

    Buradaki önemli alanlar şunlardır: Bileşen adı, Kaynak kod deposu ve çevrilebilir dosyaları bulmak için Dosya maskesi. Weblate, GNU gettext PO (Portable Object), Android dizge kaynakları, Apple iOS dizgeleri, Java özellikleri, Stringsdict biçimi veya Fluent biçimi ile birlikte çok çeşitli biçimleri destekler. Ayrıntılı bilgi almak için: Yerelleştirme dosyası biçimleri.

  3. Yukarıdakiler tamamlandıktan sonra (sürüm denetimi sistemi deponuzun boyutuna ve çevrilecek ileti sayısına bağlı olarak uzun bir süreç olabilir), çeviri yapmaya başlayabilirsiniz.