Suiteáil ar Debian agus Ubuntu¶

Riachtanais crua-earraí¶

Ba cheart go n-oibreodh Weblate ar aon chrua-earraí comhaimseartha gan fadhbanna, seo a leanas an chumraíocht íosta a theastaíonn chun Weblate a rith ar óstach amháin (Weblate, bunachar sonraí agus freastalaí gréasáin):

3 GB RAM
2 chroílár LAP
1 GB de spás stórála

Note

Bíonn éagsúlacht mhór ag baint le riachtanais iarbhír do shuiteáil Weblate bunaithe ar mhéid na n-aistriúchán a bhainistítear ann.

Úsáid cuimhne¶

An níos mó cuimhne is amhlaidh is fearr - úsáidtear é le haghaidh taisceadh ar gach leibhéal (córas comhaid, bunachar sonraí agus Weblate). Maidir leis na céadta comhpháirteanna aistriúcháin, moltar 4 GB RAM ar a laghad.

Hint

Maidir le córais a bhfuil níos lú cuimhne acu ná mar a mholtar, moltar Socrú Soilire aonphróisis.

Úsáid LAP¶

Méadaíonn go leor úsáideoirí comhthráthacha an méid croíleacáin LAP atá ag teastáil.

Úsáid stórála¶

Is é an gnáthúsáid stórála bunachar sonraí ná thart ar 300 MB in aghaidh an 1 milliún focal óstaithe.

Ní hionann an spás stórála a theastaíonn le haghaidh stórtha clónáilte, ach déanann Weblate iarracht a méid a choinneáil íosta trí chlóin éadomhain a dhéanamh.

Nóid¶

Maidir le suíomhanna beaga agus meánmhéide (na milliúin focal óstáilte), is féidir gach comhpháirteanna Weblate (féach Forbhreathnú ar ailtireacht) a reáchtáil ar nód amháin.

Nuair a fhásann tú go dtí na céadta milliún focal óstaithe, moltar nód tiomnaithe a bheith agat don bhunachar sonraí (féach Socrú bunachar sonraí le haghaidh Weblate).

Suiteáil¶

Riachtanais chórais¶

Suiteáil na spleáchais a theastaíonn chun na modúil Python a thógáil (féach Riachtanais bogearraí):

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 libgirepository-2.0-dev \
   libacl1-dev liblz4-dev libzstd-dev libxxhash-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev git

Hint

Níl libgirepository-2.0-dev ag dáiltí níos sine, bain úsáid as libgirepository1.0-dev ina ionad. Féach freisin Fabhtcheartú suiteála pip.

Suiteáil spleáchais roghnacha atá ag teastáil ag brath ar ghnéithe atá ar intinn agat a úsáid (féach Cleithiúlachtaí Python):

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

Suiteáil go roghnach bogearraí chun freastalaí táirgthe a rith, féach Freastalaí ag rith, Socrú bunachar sonraí le haghaidh Weblate, Tascanna cúlra ag baint úsáide as Soilire. Ag brath ar mhéid do shuiteáil b'fhéidir gur mhaith leat na comhpháirteanna seo a rith ar fhreastalaithe tiomnaithe.

Na treoracha suiteála áitiúla:

# 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: Valkey
apt install -y valkey-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

Bainisteoir pacáiste uv¶

Hint

Táimid ag baint úsáide as bainisteoir pacáiste uv chun Weblate a shuiteáil.

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

Modúil Python¶

Hint

We're installing Weblate in a separate Python environment.

Create the Python environment for Weblate:
```
uv venv ~/weblate-env
```
Activate the Python environment for Weblate:
```
. ~/weblate-env/bin/activate
```
Suiteáil Weblate lena n-áirítear gach spleáchas roghnach:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Seiceáil le do thoil Cleithiúlachtaí Python chun spleáchais roghnacha a mhionchoigeartú.

Gréasáin a chumrú¶

Note

The following assumes the Python environment used by Weblate is activated (by executing . ~/weblate-env/bin/activate). If not, specify the full path to the weblate command as ~/weblate-env/bin/weblate.

Cóipeáil an comhad ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py chuig ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
Coigeartaigh na luachanna sa chomhad nua settings.py de réir do thaitneamh. Beidh ort dintiúir bunachar sonraí agus eochair rúnda Django a sholáthar ar a laghad, ach beidh níos mó athruithe ag teastáil uait maidir le socrú táirgeachta, féach Cumraíocht a choigeartú.
Cruthaigh an bunachar sonraí agus a struchtúr do Weblate (úsáideann na socruithe samplacha PostgreSQL, seiceái Socrú bunachar sonraí le haghaidh Weblate le haghaidh socrú réidh le táirgeadh):
```
weblate migrate
```
See also

migrate
Cruthaigh cuntas úsáideora riarthóra admin, gin a phasfhocal, agus cóipeáil chuig an ngearrthaisce é; cuimhnigh é a shábháil le húsáid níos déanaí:
```
weblate createadmin
```
Hint

Má chaill tú / má chaill tú an pasfhocal riaracháin roimhe seo, is féidir leat ceann nua a ghiniúint leis an ordú seo a leanas:
```
weblate createadmin --update
```
See also

createadmin
Bailigh na comhaid statacha le do fhreastalaí gréasáin (féach Freastalaí ag rith agus Comhaid statacha a sheirbheáil):
```
weblate collectstatic
```
Comhbhrúigh na comhaid JavaScript agus CSS (roghnach, féach Sócmhainní cliaint a chomhbhrú):
```
weblate compress
```
Tosaigh na hoibrithe Soilire. Níl sé seo riachtanach chun críocha forbartha, ach moltar go láidir a mhalairt. Tá tuilleadh eolais ag Tascanna cúlra ag baint úsáide as Soilire:
```
~/weblate-env/lib/python3.9/site-packages/weblate/examples/celery start
```
Cuir tús leis an bhfreastalaí forbartha (Freastalaí ag rith sonraíonn socrú táirgeachta):
```
weblate runserver
```

Tar éis a shuiteáil¶

Comhghairdeas, tá do fhreastalaí Weblate ag rith anois agus is féidir leat tosú á úsáid.

Is féidir leat rochtain a fháil anois ar Weblate ar http://localhost:8000/.
Sínigh isteach le dintiúir riaracháin a fuarthas le linn na suiteála nó cláraigh le húsáideoirí nua.
You can now run Weblate commands using weblate command when Weblate Python environment is active, see Orduithe bainistíochta.
Is féidir leat an freastalaí tástála a stopadh le Ctrl+C.
Déan athbhreithniú ar shaincheisteanna féideartha le do shuiteáil ar URL /manage/performance/ (féach Tuarascáil feidhmíochta) nó ag baint úsáid weblate check --deploy, féach Socrú táirgeachta.

Aistriúchán á chur leis¶

Oscail an comhéadan riaracháin (http://localhost:8000/create/project/) agus cruthaigh an tionscadal is mian leat a aistriú. Féach Cumraíocht tionscadail le haghaidh tuilleadh sonraí.

Níl le déanamh ach ainm an tionscadail agus a shuíomh Gréasáin a shonrú anseo.
Cruthaigh comhpháirt arb é an réad ceart é le haistriú - díríonn sé ar an stór VCS, agus roghnaíonn sé na comhaid le haistriú. Féach Cumraíocht na Comhpháirte le haghaidh tuilleadh sonraí.

Is iad na réimsí tábhachtacha anseo: Ainm an chomhpháirte, Stór cód foinse, and Masc comhaid chun comhaid inaistrithe a aimsiú. Tacaíonn Weblate le raon leathan formáidí lena n-áirítear PO gettext GNU (Réad Inaistrithe), Acmhainní sreang Android, Teaghráin Apple iOS, Java airíonna, Formáid stringsdict nó Formáid líofa, see Formáidí comhaid logánaithe le haghaidh tuilleadh sonraí.
Nuair a bheidh an méid thuas curtha i gcrích (féadann próiseas fada a bheith i gceist ag brath ar mhéid do stór VCS, agus ar líon na dteachtaireachtaí atá le haistriú), is féidir leat tosú ag aistriú.