İsteğe bağlı Weblate modülleri¶

Kurulumunuz için isteğe bağlı çeşitli modüller vardır.

Git dışa aktarıcı¶

HTTP(S) kullanarak temel alınan Git deposuna salt okunur erişim sağlar.

Kurulum¶

settings.py dosyasındaki kurulu uygulamalara weblate.gitexport ekleyin:
```
INSTALLED_APPS += ("weblate.gitexport",)
```
Kurulumdan sonra veri tabanınızı aktararak var olan depoları dışa aktarın:
```
weblate migrate
```

İpucu

Git dışa aktarıcısı resmi Docker kalıbımızda açıktır. Kapatmak için şu komutu kullanın:

WEBLATE_REMOVE_APPS=weblate.gitexport

Kullanım¶

Modül kendiliğinden Weblate bağlantısı kurar ve Bileşen yapılandırması içinde dışa aktarılan depo adresini ayarlar. Depolara Weblate adresinin /git/ bölümünden erişilebilir. Örneğin https://site.org/git/weblate/main/.

Herkese açık projelerin depoları kimlik doğrulaması olmadan kopyalanabilir:

git clone 'https://example.org/git/weblate/main/'

Sınırlanmış erişimi olan depolara göz atmak için erişim (Gizli erişim denetimi ile ya da REQUIRE_LOGIN seçeneği kullanıma alınarak), <user-profile> kullanıcı profilinizden alabileceğiniz bir API kodu ile sağlanır:

git clone 'https://user:KEY@example.org/git/weblate/main/'

İpucu

Varsayılan olarak, üyeler veya Kullanıcılar grubu ve anonim kullanıcı, herkese açık projeler için depolara Depo erişimi ve Uzman kullanıcı rolleri ile erişebilir.

Faturalama¶

Bu seçenek, faturalama tarifelerini tanımlamak, faturaları ve kullanım sınırlarını izlemek için Hosted Weblate üzerinde kullanılır.

Kurulum¶

1. Add weblate.billing to installed apps in settings.py:

INSTALLED_APPS += ("weblate.billing",)

İsteğe bağlı olarak modül için ek veri tabanı yapıları kurmak üzere veri tabanı aktarımını çalıştırın:

weblate migrate

Fatura tarifesi oluşturmak ve atamak¶

Faturalamayı kullanmak için öncelikle bir faturalama tarifesi oluşturmanız gerekir. Yönetim bölümüne gidin (somun anahtarı simgesiyle gösterilir) ve Araçlar sayfasını açın. Oradan Django yönetim arayüzü bölümüne geçin.

Django yönetim arayüzünde, FATURALAMA bölümünü bulun ve bir faturalama tarifesi ekleyin. Örneğin, herhangi bir maliyeti olmayan bir Ücretsiz tarife ekleyebilirsiniz.

Var olan bir projeye faturalama tarifesi atamak isterseniz, bunu Django yönetim arayüzü içinden Müşteri faturaları seçeneğini kullanarak da yapabilirsiniz.

Son olarak, Django yönetim arayüzü müşteri ödemelerinizi kaydetmek için bir Fatura seçeneği sunar.

Kullanım¶

Kurulumdan sonra faturalamayı yönetici arayüzünden yönetebilirsiniz. Faturalamanın kullanıma alındığı kullanıcılara Kullanıcı profili içinde Faturalama sekmesi görüntülenir.

Faturalama modülü ayrıca proje yöneticilerinin süper kullanıcı olmadan yeni projeler ve bileşenler oluşturmasını sağlar (ayrıntılı bilgi almak için: Çeviri projelerini ve bileşenleri eklemek). Bunun için şu koşullar yerine getirilmelidir:

Faturalama yapılandırılmış sınırlar içindedir (aşırı kullanım, proje/bileşen oluşturulmasını engeller) ve ödenmiştir (fiyatı sıfır değilse)
Kullanıcı, faturalama ile var olan projenin yöneticisidir ya da kullanıcı faturalamanın sahibidir (ikincisi, kullanıcıların yeni projeleri içe aktarabilmesi için yeni faturalama oluştururken gereklidir).

Proje oluşturulduktan sonra kullanıcı, daha fazla özelliğe erişebilmesi durumunda proje için hangi fatura ücretlendirmesinin uygulanacağını seçebilir.

Yasal¶

Bu seçenek, gerekli yasal belgeleri sağlamak için Hosted Weblate üzerinde kullanılır. Boş belgelerle gelir ve belgelerde aşağıdaki kalıpları doldurmanız beklenir:

legal/documents/tos.html: Hizmet koşulları belgesi
legal/documents/privacy.html: Gizlilik ilkesi belgesi
legal/documents/summary.html: Hizmet koşulları ve gizlilik ilkeleri metinlerinin özeti

Hizmet koşulları belgelerini değiştirirken, lütfen LEGAL_TOS_DATE ayarını yapın, böylece kullanıcılara güncellenmiş belgeleri kabul etmeleri dayatılır.

Not

Hosted Weblate hizmeti için yasal belgeler <https://github.com/WeblateOrg/wllegal/tree/main/wllegal/templates/legal/documents> Git deposunda bulunabilir.

Büyük olasılıkla bunları olduğu gibi kullanamazsınız. Ancak gereksinimlerinize uygun olarak ayarlamakta başlangıç noktası olarak yararlı olabilir.

Kurulum¶

1. Add weblate.legal to installed apps in settings.py:

INSTALLED_APPS += ("weblate.legal",)

# Optional:

# Social auth pipeline to confirm TOS upon registration/subsequent sign in
SOCIAL_AUTH_PIPELINE += ("weblate.legal.pipeline.tos_confirm",)

# Middleware to enforce TOS confirmation of signed in users
MIDDLEWARE += [
    "weblate.legal.middleware.RequireTOSMiddleware",
]

İsteğe bağlı olarak modül için ek veri tabanı yapıları kurmak üzere veri tabanı aktarımını çalıştırın:

weblate migrate

weblate/legal/templates/legal/ klasöründeki yasal belgeleri size uygun şekilde düzenleyin.

Kullanım¶

Kurulum ve düzenlemeden sonra, yasal belgeler Weblate arayüzünde görüntülenir.

Avatarlar¶

Avatarlar, varsayılan olarak hizmet verdikleri sitelerden bilgi sızıntılarını azaltmak için sunucu tarafına indirilir ve ön belleğe alınır. Bunun için yapılandırılmış e-posta adreslerinden avatarları almayı sağlama özelliği ENABLE_AVATARS seçeneği ile kullanımdan kaldırılabilir.

Weblate şu anda şunları destekliyor:

Ayrıca bakınız

Avatar ön belleği, AVATAR_URL_PREFIX, ENABLE_AVATARS

İstenmeyen gönderim koruması¶

Akismet hizmetiyle kullanıcıların istenmeyen gönderimler yapmasını engelleyebilirsiniz.

Akismet Python modülünü kurun (resmi Docker kalıbında zaten vardır).
Akismet API anahtarını edinin.
WEBLATE_AKISMET_API_KEY ayarına ya da Docker üzerinde AKISMET_API_KEY ayarına ekleyin.

Şu içerikler denetlenmesi için Akismet üzerine gönderilir:

Kimliği doğrulanmamış kullanıcılardan öneriler
Proje ve bileşen açıklamaları ve bağlantıları

Not

Bu (diğer şeylerin yanında) istemcinin IP adresini kullanır. Bu yapılandırmayı düzgün bir şekilde yapmak için Ters vekil sunucu arkasında çalıştırmak bölümüne bakabilirsiniz.

Ayrıca bakınız

Ters vekil sunucu arkasında çalıştırmak, AKISMET_API_KEY, WEBLATE_AKISMET_API_KEY

Git işlemelerini GnuPG ile imzalamak¶

Tüm işlemeler Weblate kopyasının GnuPG anahtarı tarafından imzalanabilir.

1. Turn on WEBLATE_GPG_IDENTITY. (Weblate will generate a GnuPG key when needed and will use it to sign all translation commits.)

Bu özellik için GnuPG 2.1 ya da üzerindeki bir sürüm kurulu olmalıdır.

Anahtarı DATA_DIR içinde bulabilirsiniz. Herkese açık anahtar “Hakkında” sayfasında görüntülenir:

2. Alternatively you can also import existing keys into Weblate, just set HOME=$DATA_DIR/home when invoking gpg.

İpucu

Weblate anahtar materyalini uzun süreyle ön belleğe alır. WEBLATE_GPG_IDENTITY seçeneği ile Weblate tarafından bir anahtar oluşturmasına izin veriyorsanız ve var olan bir anahtarı kullanmak için aynı kimlikli anahtarı Weblate içine aktarırsanız, bu tür bir değişikliğin etkisini görmek için redis ön belleğini temizlemeniz önerilir.

Not

Birkaç sunucu arasında DATA_DIR paylaşırken, GnuPG imzalamasının düzgün çalışabilmesi için lütfen https://wiki.gnupg.org/NFS adresindeki yönergeyi izleyin.

Ayrıca bakınız

WEBLATE_GPG_IDENTITY

Hızı sınırlaması¶

4.6 sürümünde değişti: Hız sınırlaması artık süper kullanıcılara uygulanmıyor.

Weblate üzerinde bazı işlemlere hız sınırlaması uygulanır. RATELIMIT_WINDOW saniye içinde en fazla RATELIMIT_ATTEMPTS girişim yapılmasına izin verilir. Kullanıcı daha sonra RATELIMIT_LOCKOUT süreyle engellenir. Kapsamlara özgü ayarlar da vardır. Örneğin RATELIMIT_CONTACT_ATTEMPTS ya da RATELIMIT_TRANSLATE_ATTEMPTS. Aşağıdaki tabloda, kullanılabilecek kapsamların tam listesini görebilirsiniz.

Hız sınırlaması uygulanan işlemler şunlardır:

Ad	Kapsam	İzin verilen girişimler	Hız sınırlaması aralığı	Kilitleme süresi
Hesap açılışı	`REGISTRATION`	5	300	600
Yöneticilere ileti göndermek	`MESSAGE`	2	300	600
Oturum açarken parola kimlik doğrulaması	`LOGIN`	5	300	600
Site genelinde arama	`SEARCH`	6	60	60
Çeviri	`TRANSLATE`	30	60	600
Sözlüğe ekleme	`GLOSSARY`	30	60	600
Yeni bir dil çevirisi başlatma	`LANGUAGE`	2	300	600
Yeni proje oluşturma	`PROJECT`	5	600	600

Bir kullanıcı AUTH_LOCK_ATTEMPTS kez oturum açamazsa, parola sıfırlama işlemini yapana kadar hesabın parola kimlik doğrulaması kapatılır.

Ayarlar, seçenek adına WEBLATE_ ön eki eklenerek Docker kapsayıcısına da uygulanabilir. Örneğin RATELIMIT_ATTEMPTS seçeneği WEBLATE_RATELIMIT_ATTEMPTS olur.

API için ayrı hız sınırlama ayarları vardır. Ayrıntılı bilgi almak için: API hız sınırlaması.

Ayrıca bakınız

Hızı sınırlaması, Ters vekil sunucu arkasında çalıştırmak, API hız sınırlaması

Fedora iletileri bütünleştirmesi¶

Fedora Messaging, Weblate üzerinde yapılan tüm değişiklikleri ileten AMQP temelli bir yayınlayıcıdır. Bunu kullanarak Weblate üzerindeki değişikliklere ek hizmetler bağlayabilirsiniz.

Fedora Messagin bütünleştirmesi, weblate-fedora-messaging ile ayrı bir Python modülü olarak kullanılabilir. Kurulum yönergesi için <https://github.com/WeblateOrg/fedora_messaging/> adresine bakabilirsiniz.