RedHat, Fedora ve CentOS üzerine kurulum¶
Donanım gereksinimleri¶
Weblate should run on any contemporary hardware without problems, the following is the minimal configuration required to run Weblate on a single host (Weblate, database and web server):
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.
Memory usage¶
The more memory the better - it is used for caching on all levels (file system, database and Weblate). For hundreds of translation components, at least 4 GB of RAM is recommended.
İpucu
Önerilenden daha az bellek bulunan sistemler için Tek işlemli Celery kurulumu önerilir.
CPU usage¶
Many concurrent users increase the amount of needed CPU cores.
Storage usage¶
The typical database storage usage is around 300 MB per 1 million hosted words.
Storage space needed for cloned repositories varies, but Weblate tries to keep their size minimal by doing shallow clones.
Nodes¶
For small and medium-sized sites (millions of hosted words), all Weblate components (see Mimari özeti) can be run on a single node.
When you grow to hundreds of millions of hosted words, it is recommended to have a dedicated node for database (see 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):
dnf install \
libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
libyaml-devel libffi-devel cairo-devel cairo-gobject-devel pango-devel \
gobject-introspection-devel libacl-devel python3-pip python3-virtualenv \
libtool-ltdl-devel python3-devel git
Kullanmak istediğiniz özelliklere bağlı olarak gereken isteğe bağlı bağımlılıkları kurun (ayrıntılı bilgi almak için: Python bağımlılıkları):
dnf install openldap-devel libsasl2-devel
dnf install xmlsec1-devel
İsteğe bağlı olarak üretim sunucusunu çalıştırmak için gereken yazılımı kurun. Ayrıntılı 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
dnf install nginx uwsgi uwsgi-plugin-python3
# Web server option 2: Apache with ``mod_wsgi``
dnf install apache2 apache2-mod_wsgi
# Caching backend: Redis
dnf install redis
# Database server: PostgreSQL
dnf install postgresql postgresql-contrib
# SMTP server
dnf install postfix
# Gettext for the msgmerge add-on
dnf install gettext
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 Python 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 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.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
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
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
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
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:
~/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, 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¶
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.
Ç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: Desteklenen dosya biçimleri.
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.