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.

Weblate 2026.8 introduced NumPy as a required dependency. On x86-64 systems, the optimized NumPy build bundled in the Docker image requires an x86-64-v2 compatible CPU. Without the required CPU features, NumPy fails to load and Weblate cannot start.

Before upgrading, check for the required SSE4.2 CPU feature on the Linux system running Docker:

grep sse4_2 /proc/cpuinfo

Empty output indicates that a required CPU feature is unavailable. This is a preliminary check; finding SSE4.2 does not verify all x86-64-v2 CPU features.

If Docker runs in a virtual machine, run the check inside the guest. Virtual machines can hide CPU features supported by the host. Configure the virtual machine to expose the required host CPU features, then reboot the guest. If the physical CPU lacks the required features, upgrade the hardware.

Ú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.

Feidhmíocht stórála

Déanann oibríochtaí rialaithe leaganacha go leor cuardaigh meiteashonraí córas comhad. Dá bhrí sin, ní mór don fho-eolaire vcs i DATA_DIR moill íseal léitheoireachta a bheith aige; is féidir le stóráil le rochtain mall ar mheiteashonraí oibríochtaí ar nós git status a thógáil i bhfad fiú nuair a bhíonn a tháirgeacht mórchóir maith. Coinnigh CACHE_DIR ar stóráil áitiúil nó sealadach íseal-mhoill nuair is féidir.

Déanann na seiceálacha imscartha moill chuardaigh meiteashonraí a thomhas don dá shuíomh agus tugann siad rabhadh nuair a sháraíonn an mhoill mheánach 10 milleasoicind. Is tomhas garbh pointe in am é seo a mbíonn tionchar ag an gcóras comhad agus ualach an chórais air. Athrith weblate check --deploy sula n-athraítear an chumraíocht stórála.

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

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 tools for gettext POT/PO update add-ons
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

See also

Suiteáil uv

Modúil Python

Hint

Táimid ag suiteáil Weblate i dtimpeallacht Python ar leith.

1. Cruthaigh an timpeallacht Python do Weblate:

   uv venv ~/weblate-env
   

2. Gníomhachtaigh an timpeallacht Python do Weblate:

   . ~/weblate-env/bin/activate
   

3. 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ú.

See also

• Ag baint úsáide as timpeallachtaí Python

• Fabhtcheartú suiteála pip

Gréasáin a chumrú

Note

Glactar leis sa mhéid seo a leanas go bhfuil an timpeallacht Python a úsáideann Weblate gníomhachtaithe (trí . ~/weblate-env/bin/activate a fhorghníomhú). Mura bhfuil, sonraigh an cosán iomlán chuig an ordú weblate mar ~/weblate-env/bin/weblate.

1. 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.

2. 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ú.

3. 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

4. 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

5. Bailigh na comhaid statacha le do fhreastalaí gréasáin (féach Freastalaí ag rith agus Comhaid statacha a sheirbheáil):

   weblate collectstatic
   

6. 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:

   celery --app=weblate.utils worker --beat \
       --queues=celery,notify,memory,translate,backup \
       --prefetch-multiplier=1
   

7. 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.

• Is féidir leat orduithe Weblate a rith anois ag baint úsáide as an ordú weblate nuair a bhíonn timpeallacht Python Weblate gníomhach, féach 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

1. 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.

2. 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í.

3. 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ú.