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.

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.

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¶

The Logánú JavaScript CDN and Translation files CDN add-ons write files to LOCALIZE_CDN_PATH; Weblate does not serve them. Configure the web server or CDN serving LOCALIZE_CDN_URL as a public, read-only static file host.

Treat every published CDN file as public. The add-on specific UUID in the URL is not an access-control mechanism. Do not enable CDN add-ons for components that contain private strings, unreleased product text, customer data, internal URLs, API examples, repository paths, translator comments, or file-format metadata that should not be exposed.

The Translation files CDN add-on publishes raw translation files in formats supported by Weblate. Some formats can be interpreted by browsers or other clients as HTML, SVG, XML, JavaScript, YAML, or application-specific configuration. Serve the CDN from a dedicated domain that is separate from Weblate and from the application consuming the translations. Do not share authentication cookies with the CDN domain.

Recommended server configuration:

Serve only the directory configured by LOCALIZE_CDN_PATH; do not expose Weblate repositories, backups, media, configuration, or the whole data directory.
Disable directory listing.
Use HTTPS and make the CDN host read-only from the web server.
Send X-Content-Type-Options with nosniff.
Configure conservative MIME types. Serve unknown translation formats as text/plain or application/octet-stream; only serve weblate.js as JavaScript.
For raw translation formats that are not intended to be rendered in a browser, consider adding Content-Disposition with attachment.
Configure Access-Control-Allow-Origin only for sites that need browser access to the files.
Set cache lifetimes that match your update expectations, and purge CDN caches when stale translations must disappear quickly.

The following nginx snippet serves only the configured CDN directory and applies conservative defaults for raw translation files:

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