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í. Gheobhaidh sé virtualenv duit le foinsí in eagar Weblate.

Clón an cód foinse Weblate:

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

Cruthaigh virtualenv:

uv venv .venv
source .venv/bin/activate

Suiteáil Weblate (le haghaidh seo beidh roinnt spleáchais córais uait, féach Suiteáil ó fhoinsí) agus gach spleáchas atá úsáideach le haghaidh forbartha:
```
uv pip install -e '.[dev]'
```

Tosaigh freastalaí forbartha:
```
weblate runserver
```
Ag brath ar do chumraíocht, b'fhéidir gur mhaith leat oibrithe Soilire a thosú freisin:
```
./weblate/examples/celery start
```
Chun triail a rith (féach Tástáil áitiúil ar Weblate le haghaidh tuilleadh sonraí):
```
. scripts/test-database.sh
pytest
```

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

Má tá Docker agus an breiseán docker-compose-plugin suiteáilte agat, beidh uirlis bhreise uait ar a dtugtar `` jq`` ar féidir leat a shuiteáil trí do bhainisteoir pacáiste is fearr leat. Ansin, is féidir leat an timpeallacht forbartha a shníomh suas trí:

./rundev.sh

Cruthóidh sé íomhá Docker forbartha 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 tsuiteá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 ar bun agus 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.

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

Is féidir leat rogha a dhéanamh ligean do PyCharm an virtualenv a chruthú duit, nó ceann atá ann cheana féin a roghnú:

Ná déan dearmad na spleáchais a shuiteáil nuair a bheidh an ateangaire socraithe: Tríd an gconsól (úsáidfidh an consól ón IDE do virtualenv go díreach de réir réamhshocraithe), nó tríd an gcomhéadan nuair a fhaigheann tú rabhadh faoi spleáchais atá ar iarraidh.

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