Module Weblate opționale¶

Mai multe module opționale sunt disponibile pentru configurația dumneavoastră.

Exportator Git¶

Vă oferă acces numai pentru citire la depozitul Git subiacent folosind HTTP(S).

Instalare¶

Adăugați weblate.gitexport la aplicațiile instalate în settings.py:
```
INSTALLED_APPS += ("weblate.gitexport",)
```
Exportați depozitele existente prin migrarea bazei de date după instalare:
```
weblate migrate
```

Sugestie

Git exporter is turned on in our official Docker image. To turn it of, use:

WEBLATE_REMOVE_APPS=weblate.gitexport

Utilizare¶

Modulul se conectează automat la Weblate și setează URL-ul depozitului exportat în Configurația componentei. Depozitele sunt accesibile sub partea /git/ a URL-ului Weblate, de exemplu https://example.org/git/weblate/main/.

Depozitele pentru proiectele disponibile public pot fi clonate fără autentificare:

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

Accesul pentru a parcurge depozitele cu acces restricționat (cu Private access control <acl>` sau când REQUIRE_LOGIN este activat) necesită un token API care poate fi obținut în user profile:

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

Sugestie

În mod implicit, membrii grupului Users și utilizatorii anonimi au acces la depozitele pentru proiectele publice prin intermediul rolurilor Access repository și Power user.

Facturare¶

Aceasta este utilizată la Hosted Weblate pentru a defini planurile de facturare, pentru a urmări facturile și limitele de utilizare.

Instalare¶

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

INSTALLED_APPS += ("weblate.billing",)

Rulați migrarea bazei de date pentru a instala opțional structuri de baze de date suplimentare pentru modul:

weblate migrate

Billing plan creation and assignment¶

You first need to create a billing plan to activate billing. Navigate to the Administration section (represented by the wrench icon) and open the Tools screen. From there, proceed to the Django admin interface.

In the Django admin interface, locate the BILLING section and add a billing plan. For instance, you can add a Free plan with no cost.

If you wish to assign a billing plan to an existing project, this can also be done within the Django admin interface using the Customer billings option.

Lastly, the Django admin interface provides an Invoice option for logging your customer payments.

Utilizare¶

După instalare, puteți controla facturarea în interfața de administrare. Utilizatorii cu facturarea activată vor avea o nouă filă Billing în Profil utilizator.

Modulul de facturare permite în plus administratorilor de proiecte să creeze noi proiecte și componente fără a fi superutilizatori (a se vedea Adăugarea de proiecte și componente de traducere). Acest lucru este posibil atunci când sunt îndeplinite următoarele condiții:

Facturarea este în limitele configurate (orice suprautilizare duce la blocarea creării proiectului/componentei) și plătită (dacă prețul său este diferit de zero)
Utilizatorul este administrator al unui proiect existent cu facturare sau utilizatorul este proprietar al facturării (aceasta din urmă este necesară la crearea unei noi facturări pentru ca utilizatorii să poată importa proiecte noi).

La crearea proiectului, utilizatorul are posibilitatea de a alege ce factură trebuie să fie facturată pentru proiect, în cazul în care are acces la mai multe dintre ele.

Legal¶

Acesta este utilizat pe Hosted Weblate pentru a furniza documentele legale necesare. Acesta este furnizat cu documente în alb și se așteaptă să completați următoarele modele în documente:

legal/documents/tos.html: Documentul privind condițiile de serviciu
legal/documents/privacy.html: Documentul privind politica de confidențialitate
legal/documents/summary.html: Scurtă prezentare generală a condițiilor de utilizare și a politicii de confidențialitate

On changing the terms of service documents, please adjust LEGAL_TOS_DATE so that users are forced to agree with the updated documents.

Notă

Documentele legale pentru serviciul Hosted Weblate sunt disponibile în acest depozit Git <https://github.com/WeblateOrg/wllegal/tree/main/wllegal/templates/legal/documents>.

Cel mai probabil, acestea nu vă vor fi direct utilizabile, dar ar putea fi utile ca punct de plecare, dacă sunt adaptate pentru a răspunde nevoilor dumneavoastră.

Instalare¶

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",
]

Rulați migrarea bazei de date pentru a instala opțional structuri de baze de date suplimentare pentru modul:

weblate migrate

Modificați documentele juridice din dosarul weblate/legal/templates/legal/ pentru a corespunde serviciului dumneavoastră.

Utilizare¶

După instalare și editare, documentele juridice sunt afișate în Weblate UI.

Avataruri¶

Avatarurile sunt descărcate și stocate în memoria cache pe server pentru a reduce scurgerile de informații către site-urile care le oferă în mod implicit. Suportul încorporat pentru preluarea avatarurilor de la adresele de e-mail configurate în acest scop poate fi dezactivat cu ENABLE_AVATARS.

Weblate suportă în prezent:

`Gravatar <https://gravatar.com/>``_
Libravatar

Vezi și

Avatar în memoria cache, AVATAR_URL_PREFIX, ENABLE_AVATARS

Protecția împotriva spam-ului¶

Puteți să vă protejați împotriva spamming-ului din partea utilizatorilor prin utilizarea serviciului Akismet.

Instalați modulul Python akismet (acesta este deja inclus în imaginea oficială Docker).
Obțineți cheia API Akismet.
Stocați-o ca AKISMET_API_KEY sau WEBLATE_AKISMET_API_KEY în Docker.

Conținutul următor este trimis la Akismet pentru verificare:

Sugestii de la utilizatori neautentificați
Descrieri și link-uri pentru proiecte și componente

Notă

Acest lucru (printre altele) se bazează pe adresa IP a clientului, consultați Rularea în spatele unui proxy invers pentru configurarea corectă a acesteia.

Vezi și

Rularea în spatele unui proxy invers, AKISMET_API_KEY, WEBLATE_AKISMET_API_KEY

Semnarea comenzilor Git cu GnuPG¶

Toate angajamentele pot fi semnate de cheia GnuPG a instanței Weblate.

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

Această funcție necesită instalarea GnuPG 2.1 sau o versiune mai nouă.

Cheia poate fi găsită în DATA_DIR, iar cheia publică este afișată pe pagina „Despre”:

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

Sugestie

The key material is cached by Weblate for a long period. In case you let Weblate generate a key with WEBLATE_GPG_IDENTITY and then import key with the same identity to use an existing key, purging redis cache is recommended to see the effect of such change.

Notă

When sharing DATA_DIR between multiple hosts, please follow instructions at https://wiki.gnupg.org/NFS to make GnuPG signing work reliably.

Vezi și

WEBLATE_GPG_IDENTITY

Limitarea ratei¶

Schimbat în versiunea 4.6: Limitarea tarifelor nu se mai aplică superutilizatorilor.

Mai multe operații din Weblate sunt limitate de tarif. Sunt permise cel mult RATELIMIT_ATTEMPTS încercări în RATELIMIT_WINDOW secunde. Utilizatorul este apoi blocat pentru RATELIMIT_LOCKOUT. Există, de asemenea, setări specifice domeniilor, de exemplu RATELIMIT_CONTACT_ATTEMPTS sau RATELIMIT_TRANSLATE_ATTEMPTS. Tabelul de mai jos este o listă completă a domeniilor disponibile.

Următoarele operațiuni fac obiectul limitării ratei:

Nume	Domeniu de aplicare	Încercări permise	Fereastra Ratelimit	Perioada de blocare
Înregistrare	`REGISTRATION`	5	300	600
Trimiterea unui mesaj către administratori	`MESSAGE`	2	300	600
Autentificarea parolei la conectare	`LOGIN`	5	300	600
Căutare la nivelul întregului site	`SEARCH`	6	60	60
Traducerea	`TRANSLATE`	30	60	600
Adăugarea la glosar	`GLOSSARY`	30	60	600
Începerea traducerii într-o limbă nouă	`LANGUAGE`	2	300	600
Crearea unui nou proiect	`PROJECT`	5	600	600

Dacă un utilizator nu reușește să se conecteze AUTH_LOCK_ATTEMPTS de mai multe ori, autentificarea prin parolă va fi dezactivată pentru contul respectiv până când va trece prin procesul de resetare a parolei.

Setările pot fi, de asemenea, aplicate în containerul Docker prin adăugarea prefixului WEBLATE_ la numele setării, de exemplu RATELIMIT_ATTEMPTS devine WEBLATE_RATELIMIT_ATTEMPTS.

API are setări separate de limitare a ratei, a se vedea Limitarea ratei API.

Vezi și

Limitarea ratei, Rularea în spatele unui proxy invers, Limitarea ratei API

Integrarea Fedora Messaging¶

Fedora Messaging este un editor bazat pe AMQP pentru toate modificările care se produc în Weblate. Puteți agăța servicii suplimentare pe modificările care se produc în Weblate folosind acest lucru.

Integrarea Fedora Messaging este disponibilă ca un modul Python separat weblate-fedora-messaging. Vă rugăm să consultați <https://github.com/WeblateOrg/fedora_messaging/> pentru instrucțiuni de configurare.