Ag cur tús le cód rannchuidithe le Weblate¶

Tuig cód foinse Weblate trí dhul trí: Cód foinse gréasáin, Comhéadan gréasáin agus Inmheánach láithreán gréasáin.

Ag tosú leis an codebase¶

Cuir tú féin ar an eolas faoi bhunachar cód Weblate, trí thriail a dhéanamh ar na fabhtanna a bhfuil an lipéad orthu good first issue.

Tá fáilte romhat tosú ag obair ar na saincheisteanna seo gan ceist a chur. Díreach é sin a fhógairt san eagrán, ionas go mbeidh sé soiléir go bhfuil duine éigin ag obair ar an gceist sin.

Weblate a rith go háitiúil¶

Is é an cur chuige is compordaí chun tús a chur le forbairt Weblate ná Suiteáil ó fhoinsí a leanúint. Gheobhaidh tú timpeallacht Python le foinsí Weblate in-eagarthóireachta leis.

Clón an cód foinse Weblate:

git clone https://github.com/WeblateOrg/weblate.git
cd weblate

Install Weblate and all dependencies useful for development:
```
uv sync --all-extras --dev
```
Tosaigh freastalaí forbartha:
```
uv run weblate runserver
```
Ag brath ar do chumraíocht, b'fhéidir gur mhaith leat oibrithe Soilire a thosú freisin:
```
uv run ./weblate/examples/celery start
```
To run tests (see Tástáil áitiúil ar Weblate for more details):
```
. scripts/test-database.sh
uv run pytest
```

Weblate a rith go háitiúil i Docker¶

Má tá Docker agus an breiseán docker-compose suiteáilte agat, beidh uirlis bhreise darb ainm jq uait ar féidir leat a shuiteáil trí do bhainisteoir pacáiste is fearr leat. Ansin, is féidir leat an timpeallacht forbartha a chur ar bun trí na nithe seo a leanas a rith:

./rundev.sh

Cruthóidh sé íomhá forbartha Docker agus cuirfidh sé tús leis. Tá Weblate ag rith ar <http://127.0.0.1:8080/> agus is féidir leat síniú isteach mar an t-úsáideoir admin ag baint úsáide as admin mar an focal faire. Tá an suiteáil nua folamh, mar sin b'fhéidir gur mhaith leat leanúint ar aghaidh le Tionscadail agus comhpháirteanna aistriúcháin a chur leis.

Tá Weblate cumraithe chun coimeádán maildev a úsáid mar fhreastalaí ríomhphoist. Is féidir na ríomhphoist a sheachadtar a fheiceáil ag <http://127.0.0.1:1080/>.

Tá na Dockerfile agus docker-compose.yml le haghaidh seo suite sa chomhadlann dev-docker. Chun rochtain níos éasca a fháil ar an mbunachar sonraí le linn na forbartha, tá an coimeádán a ritheann PostgreSQL nochta ar phort 5433.

Glacann an script le roinnt paraiméadair freisin, chun tástálacha a dhéanamh, rith leis an bparaiméadar test é agus ansin sonraigh aon pharaiméadair test, mar shampla trialacha amháin a rith sa mhodúl weblate.machine :

./rundev.sh test --exitfirst weblate/machine

Note

Bí cúramach go bhfuil do choimeádáin Docker ag feidhmiú sula ndéanann tú na tástálacha. Is féidir leat é sin a sheiceáil tríd an ordú docker ps a rith.

Chun na logaí a thaispeáint:

./rundev.sh logs

Chun na coimeádáin chúlra a stopadh, rith:

./rundev.sh stop

Má ritheann tú an script gan argóintí, athchruthófar an coimeádán Docker agus atosóidh sé é.

Warning

Níl an coimeádán seo oiriúnach le húsáid táirgthe. Déantar slándáil a íobairt chun an fhorbairt a dhéanamh níos éasca.

Bootstrapping do shampla forbartha¶

Seans gur mhaith leat import_demo a úsáid chun aistriúcháin taispeána a chruthú agus createadmin chun úsáideoir riaracháin a dhéanamh.

Más rud é go bhfuil Billeáil suiteáilte agat chomh maith, is féidir leat billing_demo a úsáid chun tionscadal billeála taispeána a chruthú.

Códú Gréasán le PyCharm¶

Is IDE aitheanta é PyCharm do Python, seo roinnt treoirlínte chun cabhrú leat do thionscadal Weblate a chur ar bun ann.

Ós rud é go bhfuil tú díreach tar éis an stór GitHub a chlónáil go fillteán, níl le déanamh ach é a oscailt le PyCharm. Nuair a bheidh an IDE oscailte, is é an chéad chéim ná an ateangaire a theastaíonn uait a úsáid a shonrú:

Select the .venv environment created by uv sync --all-extras --dev to match the command-line development setup. You can also let PyCharm create a Python environment for you, but the uv-managed environment is preferred:

Don't forget to install the dependencies once the interpreter is set. When using the preferred uv-managed environment, run uv sync --all-extras --dev from the console.

Is é an dara céim ná an fhaisnéis cheart a shocrú chun Django a úsáid go dúchais taobh istigh de PyCharm: Is é an smaoineamh a bheith in ann na tástálacha aonaid sa IDE a spreagadh láithreach. Chuige sin ní mór duit bunchosán an tionscadail Django agus an cosán chuig a chuid socruithe a shonrú:

Bí cúramach, is é fréamh iarbhír an stór an Django project root, ní fo-eolaire Weblate. Maidir leis na socruithe, d'fhéadfá an weblate/settings_test.py a úsáid ón stór, ach d'fhéadfá do shuíomh féin a chruthú agus é a shocrú ansin.

Is í an chéim dheireanach ná an freastalaí a rith agus brisphointí a chur sa chód le bheith in ann é a dhífhabhtú. Déantar é seo trí chumraíocht nua Freastalaí Django a chruthú:

Hint

Bí cúramach leis an maoin ar a dtugtar Gan athlódáil: Cuireann sé cosc ar an bhfreastalaí a athlódáil beo má athraíonn tú comhaid. Ligeann sé seo do na brisphointí dífhabhtóra atá ann cheana féin leanúint ar aghaidh, nuair a bheadh siad curtha i leataobh de ghnáth ar athlódáil an fhreastalaí.