Weblate yazılımını güncellemek¶

Docker kalıbı güncellemeleri¶

Resmi Docker kalıbına (ayrıntılı bilgi almak için: Docker ile kurmak) tüm Weblate yükseltme adımları bütünleştirilmiştir. Genellikle güncel (ya da en azından daha yeni) sürümü çekmenin dışında el ile yapılması gereken bir adım bulunmaz.

Ayrıca bakınız

Docker kapsayıcısını yükseltmek

Genel yükseltme yönergesi¶

Yükseltmeden önce her zaman, değişiklikler için Yazılım gereksinimleri bölümüne bakın. Tüm gereksinimler kurulduktan ya da güncellendikten sonra, lütfen settings.py dosyasını yapılandırmadaki değişikliklere uygun şekilde ayarlayın (doğru değerler için settings_example.py bölümüne bakabilirsiniz).

Yükseltmeden önce her zaman Sürüme özel yönergeler bölümüne bakın. Bazı sürümleri atlamanız durumunda, lütfen yükseltmede atladığınız tüm sürümlerin yönergelerini izleyin. Bazen sorunsuz bir aktarım yapmak için önce bazı ara sürümlere yükseltmek daha iyidir. Bir seferde birkaç sürüm yukarı yükseltilebilir. Ancak bu durum tek sürüm yükseltmeleri kadar iyi denenmemiştir!

Not

Yükseltmenin yapılamaması durumunda veri tabanını önceki sürüme döndürebilmeniz için yükseltmeden önce her zaman veri tabanının tam yedeğini alın. Ayrıntılı bilgi almak için: Weblate yedeğini alma ve taşıma.

Yükseltme sırasında eski işlemlerin çalışmasını önlemek için WSGI ve Celery işlemlerini durdurun. Yoksa veri tabanında uyumsuz değişiklikler yapılabilir.

Weblate yazılımını yükseltmek

Pip kurulumları için şöyle yapılabilir:

uv pip install -U "weblate[all]==version"

Ya da yalnızca güncel sürümü edinmek istiyorsanız:

uv pip install -U "weblate[all]"

İsteğe bağlı bağımlılıkların tümünü kurmak istemiyorsanız şunu yapın:

uv pip install -U weblate

Git checkout ile yeni kaynak kodunu almanız ve kurulumunuzu yükseltmeniz gerekir:

cd weblate-src
git pull
# Update Weblate inside your virtualenv
. ~/weblate-env/bin/uv pip install -e '.[all]'
# Install dependencies directly when not using virtualenv
uv pip install --upgrade -e .
# Install optional dependencies directly when not using virtualenv
uv pip install --upgrade -e '.[all]'

Yeni Weblate sürümünde yeni Python bağımlılıkları bulunabilir. İstediğiniz özellikleri kapsayıp kapsamadığını denetleyin.
Yapılandırma dosyasını yükseltmek için settings_example.py ya da Sürüme özel yönergeler yardımcı olur.
Veri tabanını yükseltin:
```
weblate migrate --noinput
```
Güncellenmiş durağan dosyaları derleyin (ayrıntılı bilgi almak için: Sunucuyu çalıştırmak ve Durağan dosyalar sunmak):
```
weblate collectstatic --noinput --clear
```
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
```
Git üzerindeki bir kurulumu çalıştırıyorsanız, her yükseltme yaptığınızda yerel dosyalarını da yeniden oluşturmanız gerekir. Bu işlemi şu şekilde yapabilirsiniz:
```
weblate compilemessages
```
Kurulumunuzun doğru olduğunu doğrulayın (ayrıntılı bilgi almak için: Üretim kurulumu):
```
weblate check --deploy
```
Celery işlemini yeniden başlatın (ayrıntılı bilgi almak için: Celery ile arka plan görevlerini kullanmak).

Sürüme özel yönergeler¶

5.0 sürümünde değişti: Sürüme özel yönergeler sürüm notlarına eklendi. Ayrıntılı bilgi almak için: Weblate 5.10.2.

Eski bir büyük sürümden yükseltme¶

Yükseltmelerde büyük sürümler atlanamaz. Her zaman ilk işlem olarak büyük sürümün son yama düzeyine yükseltin. Bu adımı atlayan yükseltme işlemleri desteklenmez ve bozulur.

2.x sürümünden yükseltiyorsanız, her zaman ilk olarak 3.0.1 sürümüne yükseltin.
3.x sürümünden yükseltme yapıyorsanız, her zaman ilk olarak 4.0.4 sürümüne yükseltin.
4.x sürümünden yükseltme yapıyorsanız, her zaman ilk olarak 5.0.2 sürümüne yükseltin.

Ayrıca bakınız

Weblate 3.0 belgelerinde 2.20 sürümünden 3.0 sürümüne yükseltmek, Weblate 4.0 belgelerinde 3.11 sürümünden 4.0 sürümüne yükseltmek, Weblate 5.0 belgelerinde 4.x sürümünden 5.0.2 sürümüne yükseltmek

Diğer veri tabanlarından PostgreSQL üzerine aktarmak¶

Weblate için PostgreSQL dışında başka bir veri tabanı kullanıyorsanız, Aşağıdaki adımları izleyerek daha iyi başarım gösteren PostgreSQL kullanmaya geçmeyi düşünün. Aktarımdan önce hem site hem de Celery sunucularını durdurmayı unutmayın, yoksa tutarsız verilerle karşılaşabilirsiniz.

PostgreSQL üzerinde bir veri tabanı oluşturmak¶

Weblate için ayrı bir veri tabanı ve ayrı bir kullanıcı hesabı kullanmak genellikle iyi bir fikirdir:

# If PostgreSQL was not installed before, set the main password
sudo -u postgres psql postgres -c "\password postgres"

# Create a database user called "weblate"
sudo -u postgres createuser -D -P weblate

# Create the database "weblate" owned by "weblate"
sudo -u postgres createdb -E UTF8 -O weblate weblate

Pgloader ile PostgreSQL üzerine aktarmak¶

pgloader, verileri PostgreSQL üzerine taşımak için kullanılan bir genel aktarım aracıdır. Weblate veri tabanını aktarmak için kullanabilirsiniz.

Veri tabanı olarak PostgreSQL kullanmak için settings.py dosyanızı ayarlayın.

Şemayı PostgreSQL veri tabanına aktarın:

weblate migrate
weblate sqlflush | weblate dbshell

3. Run the pgloader to transfer the data. The following script can be used to migrate the database, but you might want to learn more about pgloader to better understand what it does, and tweak it to match your setup:

LOAD DATABASE
     FROM mysql://weblate:password@localhost/weblate
     INTO postgresql://weblate:password@localhost/weblate

WITH include no drop, truncate, create no tables, create no indexes, no foreign keys, disable triggers, reset sequences, data only

ALTER SCHEMA 'weblate' RENAME TO 'public'
;

Pootle üzerinden aktarmak¶

Weblate başlangıçta Pootle uygulamasının yerini almak için yazıldığından, Pootle kullanıcı hesaplarının aktarılmasını destekler. Kullanıcıları Pootle üzerinden indirip ve importusers ile içe aktarabilirsiniz.