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/'

Note

Freastalaíonn Weblate ar an stórlann Git féin, ach ní fhreastalaíonn sé ar réada Git LFS. I gcás stórlanna a úsáideann Git LFS, clónáil ón stórlann suas an sruth agus cuir Weblate leis mar chianrialtán eile. Mura bhfuil uait ach comhaid atá rianaithe ag Git, is féidir leat clónáil ó Weblate le GIT_LFS_SKIP_SMUDGE=1 chun íoslódáil réada Git LFS a sheachaint.

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.

The billing module additionally allows users to create new projects and components without being superusers (see Tionscadail agus comhpháirteanna aistriúcháin a chur leis). This is possible when following conditions are met:

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)
The user has Add projects to workspace permission for the workspace covered by the billing plan.

Upon project creation user is able to choose which workspace should contain the project. Projects created in a workspace with billing count against the billing plan assigned to that workspace. Users with the Edit workspace settings permission can view and pay the billing plan; billing notification e-mails are sent to these users. See Billeáil for details.

Modúl dlí¶

Ú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 Óstáilte Weblate atá á reáchtáil ag Weblate s.r.o. ar fáil sa stór Git seo: <https://github.com/WeblateOrg/wllegal/tree/main/wllegal/templates/legal/documents>.

Tá na téarmaí seirbhíse pacáilte agus na doiciméid dhlíthiúla gaolmhara sainiúil don tseirbhís sin agus níl siad beartaithe le haghaidh úsáide ginearálta. D’fhéadfadh siad a bheith úsáideach fós mar phointe tosaigh má dhéantar iad a choigeartú chun freastal ar do riachtanais.

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.

Hint

I gcás imscaradh Docker, cumasaigh an modúl dlíthiúil ag baint úsáide as WEBLATE_LEGAL_INTEGRATION in ionad settings.py a chur in eagar. Bain úsáid as tos-confirm chun an modúl dlíthiúil agus forfheidhmiú dearbhaithe téarmaí seirbhíse a chumasú, nó wllegal chun na teimpléid doiciméad dlíthiúil óstáilte a úsáideann seirbhísí arna n-oibriú ag Weblate s.r.o. a luchtú freisin. Níl na teimpléid seo beartaithe le haghaidh úsáide ginearálta. Chun do theimpléid féin a sholáthar i Docker, cuir iad i /app/data/python/customize/templates/legal/documents, féach Lógó agus comhaid statacha eile a athsholáthar.

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

See also

Logánú CDN¶

Scríobhann na breiseáin Logánú JavaScript CDN agus Comhaid aistriúcháin CDN comhaid chuig LOCALIZE_CDN_PATH; ní fhreastalaíonn Weblate orthu. Cumraigh an freastalaí gréasáin nó an CDN a fhreastalaíonn ar LOCALIZE_CDN_URL mar óstach comhad statach poiblí, inléite amháin.

Déan gach comhad CDN foilsithe a láimhseáil mar chomhad poiblí. Ní meicníocht rialaithe rochtana é an UUID breiseáin shonrach san URL. Ná cumasaigh breiseáin CDN do chomhpháirteanna ina bhfuil teaghráin phríobháideacha, téacs táirgí neamheisithe, sonraí custaiméirí, URLanna inmheánacha, samplaí API, cosáin stórtha, tuairimí aistritheora, nó meiteashonraí formáid comhaid nár cheart a nochtadh.

Foilsíonn an breiseán Comhaid aistriúcháin CDN comhaid aistriúcháin amha i bhformáidí a dtacaíonn Weblate leo. Is féidir le brabhsálaithe nó le cliaint eile roinnt formáidí a léirmhíniú mar HTML, SVG, XML, JavaScript, YAML, nó cumraíocht atá sainiúil don fheidhmchlár. Freastalaíonn an CDN ó fhearann tiomnaithe atá scartha ó Weblate agus ón bhfeidhmchlár a úsáideann na haistriúcháin. Ná roinn fianáin fíordheimhnithe leis an bhfearann CDN.

Cumraíocht freastalaí molta:

Ná fóin ach an t-eolaire atá cumraithe ag LOCALIZE_CDN_PATH; ná nocht stórtha Weblate, cúltacaí, meáin, cumraíocht, ná an t-eolaire sonraí iomlán.
Díchumasaigh liostú eolaire.
Bain úsáid as HTTPS agus déan an t-óstach CDN inléite amháin ón bhfreastalaí gréasáin.
Seol X-Content-Type-Options le nosniff.
Cumraigh cineálacha MIME coimeádacha. Freastal ar fhormáidí aistriúcháin anaithnide mar text/plain nó application/octet-stream; ná fhreastal ach ar weblate.js mar JavaScript.
I gcás formáidí aistriúcháin amha nach bhfuil beartaithe a rindreáil i mbrabhsálaí, smaoinigh ar Content-Disposition a chur leis le attachment.
Cumraigh Access-Control-Allow-Origin do shuíomhanna a bhfuil rochtain brabhsálaí ag teastáil uathu ar na comhaid amháin.
Socraigh saolréanna taisce a chomhlíonann d’ionchais nuashonraithe, agus glan taiscí CDN nuair a chaithfidh aistriúcháin atá seanchaite imeacht go tapa.

Ní fhreastalaíonn an blúire nginx seo a leanas ach ar an eolaire CDN cumraithe agus cuireann sé réamhshocruithe coimeádacha i bhfeidhm le haghaidh comhaid aistriúcháin amha:

weblate/examples/weblate.nginx.cdn.conf¶

#
# nginx configuration for the Weblate localization CDN
#
# You will want to change:
#
# - server_name to match the host configured in LOCALIZE_CDN_URL
# - root to match LOCALIZE_CDN_PATH
# - Access-Control-Allow-Origin to the sites that need browser access
# - TLS configuration if HTTPS is not terminated before nginx
#
server {
    listen 80;
    server_name cdn.example.com;

    # LOCALIZE_CDN_PATH
    root /home/weblate/data/l10n-cdn;

    autoindex off;
    disable_symlinks on;

    location = / {
        return 404;
    }

    # The JavaScript localization add-on publishes this loader.
    location ~ "^/[0-9a-f]{32}/weblate\.js$" {
        try_files $uri =404;

        types {
            application/javascript js;
        }
        default_type application/javascript;

        add_header X-Content-Type-Options nosniff always;
        # add_header Access-Control-Allow-Origin "https://www.example.com" always;

        expires 1h;
    }

    # Other CDN files are translation files. Serve them conservatively so raw
    # formats are not interpreted as active browser content.
    location / {
        try_files $uri =404;

        types {
        }
        default_type text/plain;

        add_header X-Content-Type-Options nosniff always;
        add_header Content-Disposition "attachment" always;
        # add_header Access-Control-Allow-Origin "https://www.example.com" always;

        expires 1h;
    }
}

See also

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 ar logáil isteach	`LOGIN`	5	300	600
Fíordheimhniú dara fachtóir	`SECOND_FACTOR`	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.

See also