Suiteáil ar macOS

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í):

brew install python pango cairo gobject-introspection glib libyaml pkgconf zstd lz4 xxhash libxmlsec1 librsvg uv

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
brew install nginx uwsgi

# Web server option 2: Apache with ``mod_wsgi``
brew install httpd

# Caching backend: Valkey
brew install valkey

# Database server: PostgreSQL
brew install postgresql

# Gettext for the msgmerge add-on
brew install gettext

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

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. Comhbhrúigh na comhaid JavaScript agus CSS (roghnach, féach Sócmhainní cliaint a chomhbhrú):

    weblate compress
    
  7. 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
    
  8. 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 stringsdictFormá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ú.