Modúil Roghnacha Weblate¶

Tá roinnt modúl roghnach ar fáil le haghaidh do shocrú.

Onnmhaireoir Git¶

Soláthraíonn sé rochtain inléite amháin duit ar an stór Git bhunúsach trí úsáid a bhaint as HTTP(S).

Suiteáil¶

Cuir weblate.gitexport le feidhmchláir suiteáilte i settings.py:
```
INSTALLED_APPS += ("weblate.gitexport",)
```
Easpórtáil stórtha atá ann cheana féin trí do bhunachar sonraí a ascnamh tar éis é a shuiteáil:
```
weblate migrate
```

Hint

Tá onnmhaireoir Git ar siúl inár n-íomhá oifigiúil Docker. Chun é a chasadh as, úsáid:

WEBLATE_REMOVE_APPS=weblate.gitexport

Úsáid¶

Cuireann an modúl isteach i Weblate go huathoibríoch agus socraíonn an URL stórais onnmhairithe in Cumraíocht na Comhpháirte. Tá na stórais inrochtana faoin gcuid /git/ den URL Weblate, mar shampla https://example.org/git/weblate/main/.

Is féidir stórtha do thionscadail atá ar fáil go poiblí a chlónáil gan fíordheimhniú:

git clone 'https://example.org/git/weblate/main/'

Teastaíonn comhartha API chun na stórtha a bhrabhsáil le rochtain shrianta (le Private access control nó nuair atá REQUIRE_LOGIN) is féidir a fháil i do user profile:

git clone 'https://user:KEY@example.org/git/weblate/main/'

Hint

De réir réamhshocraithe baill nó Tá grúpa úsáideoirí agus úsáideoir gan ainm rochtain a fháil ar na stórtha do thionscadail phoiblí trí Rochtain ar stór agus Power user róil.

Billeáil¶

Úsáidtear é seo ar Hosted Weblate chun pleananna billeála, sonraisc agus teorainneacha úsáide a rianú.

Suiteáil¶

1. Add weblate.billing to installed apps in settings.py:

INSTALLED_APPS += ("weblate.billing",)

Rith an t-aistriú bunachar sonraí chun struchtúir bhunachar sonraí breise a shuiteáil go roghnach don mhodúl:

weblate migrate

Cruthú agus sannadh plean billeála¶

Ní mór duit plean billeála a chruthú ar dtús chun an bhilleáil a ghníomhachtú. Déan nascleanúint go dtí an rannán Riarachán (arna léiriú ag an deilbhín eochair) agus oscail an scáileán Tools. Ón áit sin, téigh ar aghaidh chuig comhéadan riaracháin Django.

I gcomhéadan riaracháin Django, aimsigh an rannán BILLING agus cuir plean billeála leis. Mar shampla, is féidir leat plean Saor in Aisce a chur leis gan aon chostas.

Más mian leat plean billeála a shannadh do thionscadal atá ann cheana féin, is féidir é seo a dhéanamh freisin laistigh den chomhéadan riaracháin Django ag baint úsáide as an rogha Billeálacha do chustaiméirí.

Ar deireadh, soláthraíonn an comhéadan riaracháin Django rogha Sonrasc chun d'íocaíochtaí custaiméara a logáil.

Úsáid¶

Tar éis suiteála is féidir leat billeáil a rialú sa chomhéadan riaracháin. Gheobhaidh úsáideoirí a bhfuil billeáil cumasaithe acu cluaisín nua Billing i Próifíl an úsáideora.

Ligeann an modúl billeála freisin do riarthóirí tionscadail agus comhpháirteanna nua a chruthú gan a bheith ina sárúsáideoirí (féach Tionscadail agus comhpháirteanna aistriúcháin a chur leis). Tá sé seo indéanta nuair a chomhlíontar na coinníollacha seo a leanas:

Tá an bhilleáil laistigh dá theorainneacha cumraithe (mar thoradh ar ró-úsáid ar bith go gcuirtear bac ar chruthú tionscadail/comhpháirt) agus íoctha (má tá a phraghas neamh-nialas)
Is é an t-úsáideoir atá i gceannas ar an tionscadal atá ann cheana féin le billeáil nó is é an t-úsáideoir úinéir an bhilleála (tá an dara ceann riachtanach agus billeáil nua á chruthú le go mbeidh úsáideoirí in ann tionscadail nua a allmhairiú).

Nuair a bheidh an tionscadal cruthaithe beidh an t-úsáideoir in ann a roghnú cén billeáil ar cheart a ghearradh as an tionscadal ar eagla go mbeidh rochtain aige ar níos mó acu.

Dlíthiúil¶

Úsáidtear é seo ar Hosted Weblate chun na doiciméid riachtanacha dlíthiúla a sholáthar. Cuirtear doiciméid bhána ar fáil dó, agus táthar ag súil go líonfaidh tú na teimpléid seo a leanas sna doiciméid:

legal/documents/tos.html: Doiciméad téarmaí seirbhíse
legal/documents/privacy.html: Doiciméad polasaí príobháideachta
legal/documents/summary.html: Forbhreathnú gairid ar théarmaí seirbhíse agus polasaí príobháideachta

Nuair a athraítear téarmaí na ndoiciméad seirbhíse, coigeartaigh LEGAL_TOS_DATE le do thoil ionas go mbeidh iallach ar úsáideoirí aontú leis na doiciméid nuashonraithe.

Note

Tá doiciméid dhlíthiúla don tseirbhís Gréasáin Óstach ar fáil sa stór Git seo <https://github.com/WeblateOrg/wllegal/tree/main/wllegal/templates/legal/documents>.

Is dócha nach mbeidh siad seo inúsáidte go díreach duit, ach d’fhéadfadh go mbeadh siad áisiúil mar phointe tosaigh má dhéantar iad a choigeartú chun freastal ar do chuid riachtanas.

Suiteáil¶

1. Add weblate.legal to installed apps in settings.py:

INSTALLED_APPS += ("weblate.legal",)

# Optional:

# Social auth pipeline to confirm TOS upon registration/subsequent sign in
SOCIAL_AUTH_PIPELINE += ("weblate.legal.pipeline.tos_confirm",)

# Middleware to enforce TOS confirmation of signed in users
MIDDLEWARE += [
    "weblate.legal.middleware.RequireTOSMiddleware",
]

Rith an t-aistriú bunachar sonraí chun struchtúir bhunachar sonraí breise a shuiteáil go roghnach don mhodúl:

weblate migrate

Cuir na doiciméid dhlíthiúla san fhillteán weblate/legal/templates/legal/ a chur in eagar chun do sheirbhís a mheaitseáil.

Úsáid¶

Tar éis suiteáil agus eagarthóireacht, taispeántar na doiciméid dhlíthiúla san Chomhéadain Weblate.

Abhatáir¶

Déantar avatars a íoslódáil agus a thaisceadh ar thaobh an fhreastalaí chun sceitheadh faisnéise chuig na suíomhanna a fhreastalaíonn orthu de réir réamhshocraithe a laghdú. Is féidir an tacaíocht ionsuite chun avatars a fháil ó sheoltaí ríomhphoist atá cumraithe dó a mhúchadh trí úsáid a bhaint as ENABLE_AVATARS.

Tacaíonn Weblate faoi láthair:

Cosaint spam¶

Is féidir leat cosaint a dhéanamh ar thurscar trí úsáid a bhaint as an tseirbhís Akismet.

Suiteáil an modúl Python akismet (tá sé seo san áireamh cheana féin san íomhá oifigiúil Docker).
Faigh eochair Akismet API.
Déan é a stóráil mar AKISMET_API_KEY nó WEBLATE_AKISMET_API_KEY in Docker.

Seoltar an t-ábhar seo a leanas chuig Akismet lena sheiceáil:

Moltaí ó úsáideoirí neamhdheimhnithe
Tionscadal agus cur síos a chomhdhéanann í agus naisc

Note

Braitheann sé seo (i measc rudaí eile) ar sheoladh IP an chliaint, féach le do thoil Rith taobh thiar seachfhreastalaí droim ar ais chun é sin a chumrú i gceart.

Tiomnaíonn síniú Git le GnuPG¶

Is féidir gach gealltanas a shíniú le heochair GnuPG an ásc Weblate.

Cuir ar siúl WEBLATE_GPG_IDENTITY. (Ginfidh Weblate eochair GnuPG nuair is gá agus úsáidfear í chun gach gealltanas aistriúcháin a shíniú.)

Teastaíonn GnuPG 2.1 nó níos nuaí a shuiteáil ón ngné seo.

Is féidir leat an eochair a fháil i DATA_DIR agus taispeántar an eochair phoiblí ar an leathanach “Maidir”:
Nó is féidir leat eochracha atá ann cheana a iompórtáil isteach i Weblate, níl le déanamh ach HOME=$DATA_DIR/home a shocrú agus gpg á agairt agat.

Hint

Tá an t-ábhar lárnach i dtaisce ag Weblate ar feadh tréimhse fada. Ar eagla go ligeann tú do Weblate eochair a ghiniúint le WEBLATE_GPG_IDENTITY agus ansin eochair a iompórtáil leis an aitheantas céanna chun eochair atá ann cheana a úsáid, moltar an taisce redis a ghlanadh chun éifeacht an athraithe sin a fheiceáil.

Note

Agus DATA_DIR á roinnt idir óstach iolrach, lean na treoracha ag https://wiki.gnupg.org/NFS le go n-oibreoidh síniú GnuPG go hiontaofa.

See also

WEBLATE_GPG_IDENTITY

Teorainn rátaí¶

Changed in version 4.6: Ní bhaineann an teorannú rátaí a thuilleadh le sárúsáideoirí sínithe isteach.

Tá roinnt oibríochtaí i Weblate teoranta ó thaobh rátaí. Ar a mhéad socrú ceadaítear iarrachtaí RATELIMIT_ATTEMPTS laistigh de RATELIMIT_WINDOW soicind. Cuirtear bac ar an úsáideoir ansin le haghaidh RATELIMIT_LOCKOUT. Tá socruithe ann freisin a bhaineann go sonrach le scóip, mar shampla RATELIMIT_CONTACT_ATTEMPTS nó RATELIMIT_TRANSLATE_ATTEMPTS. Tá liosta iomlán de na scóip atá ar fáil sa tábla thíos.

Tá na hoibríochtaí seo a leanas faoi réir teorannú rátaí:

Ainm	Raon feidhme	Iarrachtaí ceadaithe	Fuinneog teorainn ráta	Tréimhse frithdhúnadh
Clárú	`REGISTRATION`	5	300	600
Teachtaireacht á seoladh chuig riarthóirí	`MESSAGE`	2	300	600
Fíordheimhniú pasfhocail agus síniú isteach	`LOGIN`	5	300	600
Cuardach ar fud an tsuímh	`SEARCH`	6	60	60
Ag aistriú	`TRANSLATE`	30	60	600
Ag cur leis an ngluais	`GLOSSARY`	30	60	600
Tús á chur le haistriúchán go teanga nua	`LANGUAGE`	2	300	600
Tionscadal nua a chruthú	`PROJECT`	5	600	600

Tá an teorannú rátaí bunaithe ar sheisiúin nuair a bhíonn an t-úsáideoir sínithe isteach agus ar an seoladh IP mura bhfuil.

Má theipeann ar úsáideoir síniú isteach AUTH_LOCK_ATTEMPTS amanna, múchfar fíordheimhniú pasfhocail ar an gcuntas go dtí go mbeidh an próiseas athshocraithe pasfhocail imithe tríd.

Is féidir na socruithe a chur i bhfeidhm sa choimeádán Docker freisin trí réimír WEBLATE_ a chur leis an ainm socraithe, mar shampla RATELIMIT_ATTEMPTS déantar WEBLATE_RATELIMIT_ATTEMPTS.

Tá socruithe teorannú rátaí ar leith ag an API, féach Teorainn ráta API.

Comhtháthú Teachtaireachtaí Fedora¶

Is foilsitheoir é Fedora Messaging atá bunaithe ar AMQP maidir le gach athrú a tharlaíonn ar Weblate. Is féidir leat seirbhísí breise a chuimsiú ar athruithe atá ag tarlú ar Weblate agus é seo á úsáid agat.

Tá comhtháthú Teachtaireachtaí Fedora ar fáil mar mhodúl Python ar leith `` weblate-fedora-messaging``. Féach <https://github.com/WeblateOrg/fedora_messaging/> le haghaidh treoracha socraithe.

See also

Teachtaireachtaí Gréasáin