Installation på SUSE och openSUSE¶

Hårdvarukrav¶

Weblate bör fungera utan problem på all modern hårdvara. Nedan anges den minimikonfiguration som krävs för att köra Weblate på en enda värd (Weblate, databas och webbserver):

3 GB RAM-minne
2 CPU-kärnor
1 GB lagringsutrymme

Observera

De faktiska kraven för din installation av Weblate varierar kraftigt beroende på storleken på de översättningar som hanteras i den.

Använt minne¶

Ju mer minne desto bättre – det används för caching på alla nivåer (filsystem, databas och Weblate). För hundratals översättningskomponenter rekommenderas minst 4 GB RAM-minne.

Råd

För system med mindre minne än rekommenderat rekommenderas Enkelprocess-konfiguration av Celery.

CPU-användning¶

Många samtidiga användare ökar behovet av CPU-kärnor.

Lagringsutnyttjande¶

Den typiska databaslagringsanvändningen är cirka 300 MB per 1 miljon lagrade ord.

Lagringsutrymmet som behövs för klonade arkiv varierar, men Weblate försöker hålla storleken minimal genom att göra ytliga kloner.

Noder¶

För små och medelstora webbplatser (miljoner värdord) kan alla Weblate-komponenter (se Arkitekturöversikt) köras på en enda nod.

När du växer till hundratals miljoner lagrade ord rekommenderas det att ha en dedikerad nod för databasen (se Databasinställningar för Weblate).

Installation¶

Systemkrav¶

Installera de beroenden som behövs för att bygga Python-modulerna (se Programvarukrav):

zypper install \
   libxslt-devel libxml2-devel freetype-devel libjpeg-devel zlib-devel \
   libyaml-devel libffi-devel cairo-devel pango-devel \
   gobject-introspection-devel libacl-devel liblz4-devel libzstd-devel libxxhash-devel \
   python3-devel git

Installera önskade valfria beroenden beroende på vilka funktioner du avser att använda (se Python-beroenden):

zypper install libldap2-devel libsasl2-devel
zypper install libxmlsec1-devel

Installera valfritt programvara för att köra produktionsservern, se Körande server, Databasinställningar för Weblate, Bakgrundsuppgifter med Celery. Beroende på storleken på din installation kanske du vill köra dessa komponenter på dedikerade servrar.

Lokala installationsanvisningar:

# Web server option 1: NGINX and uWSGI
zypper install nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
zypper install apache2 apache2-mod_wsgi

# Caching backend: Valkey
zypper install valkey-server

# Database server: PostgreSQL
zypper install postgresql postgresql-contrib

# SMTP server
zypper install postfix

# Gettext for the msgmerge add-on
zypper install gettext

uv-pakethanterare¶

Råd

Vi använder uv package manager för att installera Weblate.

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

Se även

Installera uv

Python-moduler¶

Råd

Vi använder virtualenv för att installera Weblate i en separat miljö från ditt system. Om du inte är bekant med det, kolla in virtualenv User Guide.

Skapa virtualenv för Weblate:
```
uv venv ~/weblate-env
```
Aktivera virtualenv för Weblate:
```
. ~/weblate-env/bin/activate
```
Installera Weblate inklusive alla valfria beroenden:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Se Python-beroenden för finjustering av valfria beroenden.

Se även

Felsökning av pip-installation beskriver vanliga problem vid installation av Python-beroenden.

Konfigurera Weblate¶

Observera

Följande förutsätter att virtualenv som används av Weblate är aktiverat (genom att köra . ~/weblate-env/bin/activate). Om inte, ange den fullständiga sökvägen till kommandot weblate som ~/weblate-env/bin/weblate.

Kopiera filen ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py till ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
Justera värdena i den nya filen settings.py efter eget tycke. Du måste ange åtminstone databasens inloggningsuppgifter och Djangos hemliga nyckel, men du kommer att behöva göra fler ändringar för produktionskonfigurationen, se Justera konfigurationen.
Skapa databasen och dess struktur för Weblate (exempelinställningarna använder PostgreSQL, se Databasinställningar för Weblate för en produktionsklar installation):
```
weblate migrate
```
Se även

migrate
Skapa ett administratörskonto med namnet admin, generera ett lösenord och kopiera det till urklipp. Kom ihåg att spara det för senare användning:
```
weblate createadmin
```
Råd

Om du tidigare har tappat bort/glömt administratörslösenordet kan du skapa ett nytt med följande kommando:
```
weblate createadmin --update
```
Se även

createadmin
Samla in de statiska filerna för din webbserver (se Körande server och Servering av statiska filer):
```
weblate collectstatic
```
Komprimera JavaScript- och CSS-filerna (valfritt, se Komprimering av klientresurser):
```
weblate compress
```
Starta Celery-arbetarna. Detta är inte nödvändigt för utvecklingsändamål, men rekommenderas starkt i övriga fall. Bakgrundsuppgifter med Celery har mer information:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Starta utvecklingsservern (Körande server beskriver en produktionskonfiguration):
```
weblate runserver
```

Efter installationen¶

Grattis, din Weblate-server är nu igång och du kan börja använda den.

Du kan nu komma åt Weblate på http://localhost:8000/.
Logga in med administratörsuppgifter som erhållits under installationen eller registrera dig med nya användare.
Du kan nu köra Weblate-kommandon med kommandot weblate när Weblate virtualenv är aktivt, se Ledningskommandon.
Du kan stoppa testservern med Ctrl+C.
Granska eventuella problem med din installation antingen på URL:en /manage/performance/ (se Prestandarapport) eller med hjälp av weblate check --deploy, se Produktionsuppsättning.

Lägg till översättning¶

Öppna administratörsgränssnittet (http://localhost:8000/create/project/) och skapa det projekt du vill översätta. Se Projektkonfiguration för mer information.

Allt du behöver ange här är projektets namn och dess webbplats.
Skapa en komponent som är det verkliga objektet för översättning – den pekar på VCS-arkivet och väljer vilka filer som ska översättas. Se Komponentkonfiguration för mer information.

De viktiga fälten här är: Komponentnamn, Källkodsarkiv och Filmask för att hitta översättningsbara filer. Weblate stöder ett brett utbud av format, inklusive GNU gettext PO (Portable Object), Android-strängresurser, Apple iOS-strängar, Java-egenskaper, Stringsdict-format eller Fluent-format. Se Lokalisering filformat för mer information.
När ovanstående är klart (det kan ta lång tid beroende på storleken på ditt VCS-arkiv och antalet meddelanden som ska översättas) kan du börja översätta.