Installeren op Debian en Ubuntu¶

Hardware vereisten¶

Weblate zou zonder problemen moeten kunnen worden uitgevoerd op elke hedendaagse hardware, het volgende is de minimale configuratie die is vereist om Weblate uit te voeren als een enkele host (Weblate, database en webserver):

3 GB RAM
2 CPU-bronnen
1 GB opslagruimte

Notitie

Feitelijke vereisten voor uw installatie van Weblate kunnen enorm variëren, gebaseerd op de grootte van de vertalingen die erin beheerd moeten worden.

Geheugengebruik¶

Hoe meer geheugen hoe beter - het wordt gebruikt voor cachen op alle niveaus (bestandssysteem, database en Weblate). Voor honderden vertaalonderdelen wordt ten minste 4 GB RAM aanbevolen.

Hint

Voor systemen met minder geheugen dan aanbevolen, wordt Opstelling een-proces Celery aanbevolen.

CPU-gebruik¶

Veel gelijktijdige gebruikers verhogen het aantal benodigde CPU-bronnen.

Opslaggebruik¶

Het gewoonlijke gebruik voor opslag van de database ligt rond de 300 MB per 1 miljoen gehoste woorden.

Opslagruimte die nodig is voor gekloonde opslagruimten varieert, maar Weblate probeert hun grootte minimaal te houden door oppervlakkig te klonen.

Knooppunt¶

Voor kleine en gemiddelde sites (miljoenen gehoste woorden), kunnen alle onderdelen van Weblate (bekijk Overzicht architectuur) worden uitgevoerd op ene enkel knooppunt.

Wanneer u groeit naar honderden miljoenen gehoste woorden, wordt aanbevolen om een toegewezen knooppunt voor de database te hebben (bekijk Instellingen database voor Weblate).

Installatie¶

Systeemvereisten¶

Installeer de afhankelijkheden die nodig zijn om de modules voor Python te bouwen (bekijk Software vereisten):

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

Installeer de gewenste optionele afhankelijkheden, afhankelijk van de mogelijkheden die u wilt gaan gebruiken (bekijk Python afhankelijkheden):

apt install -y \
   libldap2-dev libldap-common libsasl2-dev \
   libxmlsec1-dev

Installeer optioneel software voor het uitvoeren van de productieserver, bekijk Server uitvoeren, Instellingen database voor Weblate, Achtergrondtaken met Celery. Afhankelijk van de grootte van uw installatie zou u deze onderdelen misschien willen uitvoeren op toegewezen servers.

De lokale installatie-instructies:

# 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

# Gettext for the msgmerge add-on
apt install -y gettext

uv pakketbeheerder¶

Hint

We gebruiken de uv package manager om Weblate te installeren.

curl -LsSf https://astral.sh/uv/install.sh | sh

Zie ook

Installeren van uv

Modules voor Python¶

Hint

We zullen virtualenv gebruiken om Weblate te installeren in een afzonderlijke omgeving op uw systeem. Als u er niet bekend mee bent, bekijk de virtualenv User Guide.

Maak de virtualenv voor Weblate:
```
uv venv ~/weblate-env
```
Activeer de virtualenv voor Weblate:
```
. ~/weblate-env/bin/activate
```
Installeer Weblate inclusief alle optionele afhankelijkheden:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Bekijk Python afhankelijkheden voor het fijn afstemmen van optionele afhankelijkheden.
Notitie

Op sommige distributies van Linux mislukt het uitvoeren van Weblate met de fout libffi:
```
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)
```
Dat wordt veroorzaakt door incompatibiliteit van de binaire pakketten die worden gedistribueerd via PyPI met de distributie. U zou, om dit aan te pakken, het pakket op uw systeem opnieuw moeten bouwen:
```
uv pip install --force-reinstall --no-binary :all: cffi
```

Weblate configureren¶

Notitie

Het volgende gaat ervan uit dat de virtualenv, die wordt gebruikt door Weblate, is geactiveerd (door . ~/weblate-env/bin/activate uit te voeren). Indien niet, specificeer het volledige pad naar de opdracht weblate als ~/weblate-env/bin/weblate.

Kopieer het bestand ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py naar ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
Pas de waarden in het nieuwe bestand settings.py aan naar uw wensen. U zult ten minste de inloggegevens voor de database en de geheime sleutel van Django moeten opgeven, maar voor een opstelling als productie zult u meer wijzigingen willen, bekijk Configuratie aanpassen.
Maak de database en zijn structuur voor Weblate (de voorbeeldinstellingen gebruiken PostgreSQL, bekijk Instellingen database voor Weblate voor een opstelling die klaar voor productie is):
```
weblate migrate
```
Zie ook

migrate
Maak een beheeraccount voor de gebruiker admin, genereer het wachtwoord daarvoor en kopieer het naar het klembord; vergeet niet om het voor later gebruik op te slaan:
```
weblate createadmin
```
Hint

Als u eerder het wachtwoord voor admin niet opgaf/verloor, kunt u een nieuw genereren met de volgende opdracht:
```
weblate createadmin --update
```
Zie ook

createadmin
Verzamel de statische bestanden voor uw webserver (bekijk Server uitvoeren en Statische bestanden serveren):
```
weblate collectstatic
```
Comprimeer de bestanden met JavaScript en CSS (optioneel, bekijk Comprimeren toebehoren cliënt):
```
weblate compress
```
Start de werkers voor Celery. Dit is niet noodzakelijk voor ontwikkelingsdoeleinden, maar wordt anders sterk aangeraden. Achtergrondtaken met Celery heeft meer informatie:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Start de ontwikkelingsserver (Server uitvoeren details voor een opstelling voor productie):
```
weblate runserver
```

Na installeren¶

Gefeliciteerd, uw server voor Weblate wordt nu uitgevoerd en u kunt hem gaan gebruiken.

U krijgt toegang tot Weblate op http://localhost:8000/.
Log in met de inloggegevens voor admin, die zijn verkregen bij het installeren of registreer met nieuwe gebruikers.
U kunt nu opdrachten voor Weblate uitvoeren met de opdracht weblate als de virtualenv van Weblate actief is, bekijk Opdrachten voor beheer.
U kunt de testserver stoppen met Ctrl+C.
Bekijk potentiële problemen met uw installatie, ofwel op de URL /manage/performance/ (bekijk Prestatieverslag) of met weblate check --deploy, bekijk Productie opstelling.

Vertaling toevoegen¶

Open de beheerinterface (http://localhost:8000/create/project/) en maak het project dat u wilt vertalen. Bekijk Configuratie project voor meer details.

Alles wat u hier hoeft te doen is de naam voor het project en zijn website.
Maak een onderdeel dat het echte object voor de vertaling is - het wijst naar de opslagruimte van het VCS en selecteert welke bestanden vertaald moeten worden. Bekijk Configuratie onderdeel voor meer details.

De belangrijke velden hier zijn: Naam van onderdeel, Broncode-opslagruimte en Bestandsmasker voor het zoeken naar vertaalbare bestanden. Weblate ondersteunt ene groot bereik aan indelingen, inclusief GNU gettext PO (Portable Object), Android bronnen tekenreeksen, Apple iOS tekenreeksen, Java eigenschappen, Stringsdict indeling of Indeling Fluent, bekijk Bestandsindelingen voor vertalen voor meer details.
Als het bovenstaande eenmaal is voltooid (het kan een langdurig proces zijn, afhankelijk van de grootte van uw opslagruimte in VCS en het aantal te vertalen eenheden), kunt u beginnen met vertalen.