Debian ve Ubuntu üzerine kurmak

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 web 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ı

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.

Eşzamanlı bulunacak kullanıcı sayısı, gerekli işlemci çekirdeği sayısını artırır. Yüzlerce bileşenden oluşan çevirler için en az 4 GB RAM bellek bulunması önerilir.

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.

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.

Kurulum

Sistem gereksinimleri

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

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev libcairo-dev gir1.2-pango-1.0 libgirepository1.0-dev \
   libacl1-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev python3-pip python3-virtualenv virtualenv git

Kullanmak istediğiniz özelliklere bağlı olarak gereken isteğe bağlı bağımlılıkları kurun (bilgi almak için: İsteğe bağlı bağımlılıklar):

apt install -y \
   tesseract-ocr libtesseract-dev libleptonica-dev \
   libldap2-dev libldap-common libsasl2-dev \
   libxmlsec1-dev

İsteğe bağlı olarak üretim sunucusunu çalıştırmak için gereken yazılımı kurun. Bilgi almak için: sunucu, 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önergeleri:

# Web server option 1: NGINX and uWSGI
apt install -y nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
apt install -y apache2 libapache2-mod-wsgi-py3

# Caching backend: Redis
apt install -y redis-server

# Database server: PostgreSQL
apt install -y postgresql postgresql-contrib

# SMTP server
apt install -y exim4

Python modülleri

İpucu

Sisteminizden ayrı bir ortama Weblate kurmak için virtualenv kullanıyoruz. Bu konuda bilginiz yoksa, virtualenv User Guide bölümüne bakabilirsiniz.

Weblate için virtualenv oluşturun:
```
virtualenv ~/weblate-env
```
Weblate için virtualenv etkinleştirin:
```
. ~/weblate-env/bin/activate
```
Tüm isteğe bağlı bağımlılıklar ile birlikte Weblate kurulumunu yapın:
```
# Install Weblate with all optional dependencies
pip install "Weblate[all]"
```
İsteğe bağlı bağımlılıkları ayarlamak için lütfen İsteğe bağlı bağımlılıklar seçeneğini denetleyin.
Not

Bazı Linux dağıtımlarında Weblate çalıştırıldığında libffi hatasıyla karşılaşılabilir:
```
ffi_prep_closure(): bad user_data (it seems that the version of the libffi library seen at runtime is different from the 'ffi.h' file seen at compile-time)
```
Bu durum, PyPI ile dağıtılan binary paketlerinin dağıtımla uyumsuz olmasından kaynaklanır. Bu sorunu gidermek için, paketi sisteminizde yeniden oluşturmanız gerekir:
```
pip install --force-reinstall --no-binary :all: cffi
```

Weblate platformunu yapılandırmak

Not

Aşağıdakiler, Weblate için virtualenv kullanımının etkinleştirilmiş olduğunu varsayar (. ~/weblate-env/bin/activate komutu yürütülerek). Virtualenv etkin değilse, weblate komutunun tam yolunu ~/weblate-env/bin/weblate olarak belirtin.

~/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.
Yeni settings.py dosyasındaki değerleri istediğiniz gibi ayarlayın. En azından veritabanı kimlik doğrulama bilgilerini ve Django gizli anahtarını belirtmeniz gerekir. Ancak üretim kurulumu için daha fazla değişiklik yapmak isteyeceksiniz. Bilgi almak için: Yapılandırmayı ayarlama.
Weblate için veritabanı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
```
Yönetici için bir hesap oluşturun ve parolasını panoya kopyalayıp daha sonra kullanmak üzere kaydedin:
```
weblate createadmin
```
Web sunucunuz için durağan dosyaları derleyin (bilgi almak için: Sunucuyu çalıştırmak ve Durağan dosyalar sunmak):
```
weblate collectstatic
```
JavaScript ve CSS dosyalarını sıkıştırın (isteğe bağlı, bilgi almak için: İstemci varlıklarının sıkıştırılması):
```
weblate compress
```
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. Bilgi almak için Celery ile arka plan görevlerini kullanmak:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
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 virtualenv etkinleştirildiğinde weblate komutunu kullanarak Weblate komutlarını yürütebilirsiniz, Bilgi almak için: Yönetim komutları.
Deneme sunucusunu Ctrl+C tuşlarıyla durdurabilirsiniz.
Kurulumunuzla ilgili olası sorunları /manage/performance/ adresinden (bilgi almak için: Yönetim arayüzü) ya da weblate check --deploy komutundan görebilirsiniz. Bilgi almak için: Üretim kurulumu.

Çeviri eklemek

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

Burada yalnızca proje adı ve web sitesini belirtmeniz gerekir.
Create a component which is the real object for translation - it points to the VCS repository, and selects which files to translate. See Bileşen yapılandırması for more details.

The important fields here are: Bileşen adı, Kaynak kod deposu, and Dosya maskesi for finding translatable files. Weblate supports a wide range of formats including GNU gettext, Android string resources, Apple iOS dizgeleri, Java özellikleri, Stringsdict biçimi or Fluent biçimi, see Desteklenen dosya biçimleri for more details.
Once the above is completed (it can be lengthy process depending on the size of your VCS repository, and number of messages to translate), you can start translating.