Weblate a uasghrádú¶

Uasghrádú ar íomhánna docker¶

Comhtháthaíonn íomhá oifigiúil Weblate Docker (féach Suiteáil ag baint úsáide as Docker) gach céim uasghrádaithe. De ghnáth, níl aon idirghníomhaíocht láimhe ag teastáil seachas an leagan is déanaí (nó níos nuaí ar a laghad).

Treoracha ginearálta uasghrádú¶

Cuardaigh i gcónaí athruithe nua ar Riachtanais bogearraí roimh uasghrádú. Nuair a bheidh na ceanglais go léir suiteáilte nó uasghrádaithe, cinntigh go bhfuil do settings.py ag teacht leis na hathruithe sa chumraíocht (féach settings_example.py le haghaidh luachanna cearta).

Seiceáil i gcónaí Treoracha leagan ar leith roimh uasghrádú. Má tá tú ag scipeáil aon leagan, bí cinnte go lean tú na treoracha maidir le gach leagan atá á scipeáil agat le linn uasghrádú den sórt sin. Is fearr uaireanta uasghrádú de réir a chéile go leagan idirmheánach chun ascnamh réidh a chinntiú. Ba cheart go n-oibreodh uasghrádú thar eisiúintí iolracha, ach ní dhéantar é a thástáil chomh maith le huasghráduithe aonleagan!

Note

Cuir cúltaca ar an mbunachar sonraí iomlán i gcónaí sula n-uasghrádú, ionas gur féidir leat an bunachar sonraí a rolladh ar ais má theipeann ar an uasghrádú, féach Weblate a thacú agus a bhogadh.

Fan go mbeidh na scuainí Celery folamh, ansin stop na próisis WSGI agus Celery chun cosc a chur ar sheanphróisis a bheith ag rith agus uasghrádú á dhéanamh. Seachas sin, d’fhéadfadh athruithe neamh-chomhoiriúnacha tarlú sa bhunachar sonraí.

Ní comhéadan cobhsaí é scuaine tascanna Celery trasna eisiúintí, mar sin níl aon ráthaíocht ann go n-oibreoidh tascanna scuaine ón seanleagan tar éis an uasghrádaithe. Is féidir leat fad na scuaine a mhonatóiriú sa Comhéadan bainistíochta nó trí celery_queues a úsáid.

Uasghrádú Weblate

I gcás suiteálacha pip is féidir é a bhaint amach trí:

uv pip install -U "weblate[all]==version"

Nó, más mian leat an leagan is déanaí a scaoileadh a fháil:

uv pip install -U "weblate[all]"

Mura dteastaíonn uait na spleáchais roghnacha go léir a shuiteáil déan:

uv pip install -U weblate

Ag baint úsáide as Git Seiceáil, ní mór duit cód foinse nua a fháil agus do shuiteáil a nuashonrú:

cd weblate-src
git pull
# Update Weblate inside your Python environment
. ~/weblate-env/bin/uv pip install -e '.[all]'
# Install dependencies directly when not using Python environment
uv pip install --upgrade -e .
# Install optional dependencies directly when not using a Python environment
uv pip install --upgrade -e '.[all]'

Seans go mbeidh Cleithiúlachtaí Python ag eisiúintí nua Weblate, seiceáil an gclúdaíonn siad na gnéithe atá uait.
Uasghrádaigh an comhad cumraíochta trí settings_example.py a leanúint, nó Treoracha leagan ar leith.
Uasghrádaigh an bunachar sonraí:
```
weblate migrate --noinput
```
Bailigh comhaid statacha nuashonraithe (féach Freastalaí ag rith agus Comhaid statacha a sheirbheáil):
```
weblate collectstatic --noinput --clear
```
Comhbhrúigh comhaid JavaScript agus CSS (roghnach, féach Sócmhainní cliaint a chomhbhrú):
```
weblate compress
```
Má tá suiteáil á rith agat ó Git, ba cheart duit comhaid locale a athghiniúint gach uair a uasghrádaíonn tú. Is féidir leat é seo a dhéanamh trí agairt a dhéanamh:
```
weblate compilemessages
```
Deimhnigh go bhfuil do shocrú slán (féach freisin Socrú táirgeachta):
```
weblate check --deploy
```
Athosaigh an t-oibrí Celery (féac Tascanna cúlra ag baint úsáide as Soilire).

Treoracha leagan ar leith¶

Changed in version 5.0: Tá treoracha a bhaineann go sonrach le leagan san áireamh anois sna nótaí eisiúna, féach Weblate 2026.5.

Upgrade from an older unsupported release¶

Direct upgrades are only supported for releases from the current or previous calendar year. If you need to upgrade across this boundary, upgrade first to an intermediate version as listed below. Upgrades skipping this step are not supported and will break.

Má tá tú ag uasghrádú ón scaoileadh 2.x, déan uasghrádú go 3.0.1 ar dtús i gcónaí.
Má tá tú ag uasghrádú ón scaoileadh 3.x, déan uasghrádú go 4.0.4 ar dtús i gcónaí.
Má tá tú ag uasghrádú ón scaoileadh 4.x, déan uasghrádú go 5.0.2 ar dtús i gcónaí.
If you are upgrading from 5.0.x-5.9.x, always first upgrade to 5.10.4.
Upgrades from 5.10.x and newer are currently directly supported.

Aistriú ó bhunachair shonraí eile go PostgreSQL¶

Warning

Ní thacaítear le MySQL ná MariaDB a thuilleadh i Weblate. Ní mór duit aistriú go PostgreSQL sula ndéanann tú uasghrádú.

Más rud é go bhfuil Weblate á rith agat le MySQL nó MariaDB, smaoinigh ar aistriú go PostgreSQL le haghaidh feidhmíocht níos fearr trí na céimeanna seo a leanas a dhéanamh. Cuimhnigh an dá fhreastalaí gréasáin agus Celery a stopadh roimh ré, nó d'fhéadfadh sonraí neamhréireach a bheith agat.

Bunachar sonraí a chruthú i PostgreSQL¶

De ghnáth is smaoineamh maith é Weblate a rith i mbunachar sonraí ar leith, agus cuntas úsáideora ar leith:

# If PostgreSQL was not installed before, set the main password
sudo -u postgres psql postgres -c "\password postgres"

# Create a database user called "weblate"
sudo -u postgres createuser -D -P weblate

# Create the database "weblate" owned by "weblate"
sudo -u postgres createdb -E UTF8 -O weblate weblate

Aistriú go PostgreSQL le pgloader¶

Is uirlis chineálach imirce é an pgloader chun sonraí a aistriú go PostgreSQL. Is féidir leat é a úsáid chun do bhunachar sonraí Weblate a aistriú.

Coigeartaigh do settings.py chun PostgreSQL a úsáid mar bhunachar sonraí.

Aistrigh an scéimre sa bhunachar sonraí PostgreSQL:

weblate migrate
weblate sqlflush | weblate dbshell

3. Run the pgloader to transfer the data. The following script can be used to migrate the database, but you might want to learn more about pgloader to better understand what it does, and tweak it to match your setup:

LOAD DATABASE
     FROM mysql://weblate:password@localhost/weblate
     INTO postgresql://weblate:password@localhost/weblate

WITH include no drop, truncate, create no tables, create no indexes, no foreign keys, disable triggers, reset sequences, data only

ALTER SCHEMA 'weblate' RENAME TO 'public'
;

Imirce ó Pootle¶

Toisc gur scríobhadh Weblate ar dtús in ionad Pootle, tacaítear leis na cuntais úsáideora a aistriú uaidh. Is féidir leat na húsáideoirí a dhumpáil ó Pootle agus iad a allmhairiú ag baint úsáide as importusers.