Cumraíocht

Stóráiltear na socruithe go léir in settings.py (mar is gnách do Django).

Note

Tar éis duit aon cheann de na socruithe seo a athrú, ní mór duit Weblate a atosú - próisis WSGI agus Soilire araon.

Sa chás go bhfuil sé á reáchtáil mar mod_wsgi, ní mór duit Apache a atosú chun an chumraíocht a athlódáil.

See also

Seiceáil freisin Django's documentation le haghaidh paraiméadair a chumraíonn Django féin.

ADMINS_CONTACT

Cumraíonn sé an áit a seolann an fhoirm teagmhála r-phoist. Mura bhfuil siad cumraithe, úsáidtear seoltaí ríomhphoist ó ADMINS.

Cumraigh é seo mar liosta seoltaí ríomhphoist:

ADMINS_CONTACT = ["admin@example.com", "support@example.com"]

See also

ALLOWED_ASSET_DOMAINS

Added in version 5.14.

Cumraíonn sé cé na fearainn a bhfuil cead acu sócmhainní a aisghabháil i Weblate.

Feabhsaíonn sé seo slándáil trí chosc a chur ar shócmhainní a luchtú ó fhoinsí neamhiontaofa. Íoslódálann freastalaí Weblate na sócmhainní uair amháin agus stóráiltear iad go háitiúil, seachas iad a sheirbheáil go díreach ó fhearainn sheachtracha chuig úsáideoirí.

Cuirtear an liosta ceadanna i bhfeidhm ar an URL tosaigh agus ar gach sprioc atreoraithe HTTP sula leanann Weblate é. Diúltaítear d’atreoruithe chuig óstaigh lasmuigh den liosta ceadanna seo.

Tá sé ag súil le liosta d'ainmneacha óstach/fearainn. Is féidir leat ainmneacha láncháilithe a úsáid (m.sh. www.example.com) nó ponc a chur leo mar shiombail fhiáin chun gach fo-fhearainn a mheaitseáil (m.sh. comhoiriúnóidh .example.com le cdn.example.com nó le static.example.com).

Is é ["*"] an réamhshocrú, rud a cheadaíonn gach fearann.

Sampla

ALLOWED_ASSET_DOMAINS = [
    # Allows only cdn.anotherdomain.org
    "cdn.anotherdomain.org",
    # Allows example.com and all its subdomains
    ".example.com",
]

Úsáidtear é seo sna háiteanna seo a leanas faoi láthair:

See also

ALLOWED_MACHINERY_DOMAINS

Cumraíonn sé cé na fearainn innealra saincheaptha a cheadaítear go sainráite i gcumraíocht aistriúcháin meaisín ar leibhéal tionscadail.

Ní bhaineann an socrú seo ach le seirbhísí innealra agus ní dhéanann sé difear do ALLOWED_ASSET_DOMAINS.

Tá sé ag súil le liosta d'ainmneacha óstach/fearainn. Is féidir leat ainmneacha láncháilithe a úsáid nó ponc a chur leo mar shiombail fhiáin chun gach fo-fhearainn a mheaitseáil.

Réamhshocrú go [].

Bíonn tionchar ag an liosta ceadanna ar innealra bainistithe tionscadail ar dhá bhealach: ceadaíonn sé an críochphointe cumraithe le linn bailíochtú amach, agus marcálann sé óstaigh mheaitseála mar iontaofa agus cinneadh á dhéanamh an féidir sonraí earráide soláthraí cianda nó comhlachtaí freagartha a thaispeáint don úsáideoir. I gcás naisc dhíreacha, diúltaíonn seiceálacha rith-ama fós do cheann scríbe a réitíonn chuig seoltaí príobháideacha nó neamhphoiblí ar shlí eile. Nuair a úsáidtear seachfhreastalaí HTTP(S), titeann bailíochtú rith-ama ar ais go bailíochtú ainm óstach agus ní dhéanann sé na seiceálacha DNS nó piar-IP áitiúla céanna.

ALLOWED_ASSET_SIZE

Added in version 5.14.

Cumraíonn sé teorainn méide le haghaidh sócmhainní a aisghabháil i Weblate. Is é 10 MB an réamhshocrú.

See also

ASSET_PRIVATE_ALLOWLIST

Added in version 2025.5.

Defines hostnames or domains exempt from ASSET_RESTRICT_PRIVATE for remote asset downloads that enforce private-target checks. Entries follow Django host matching semantics, so values such as assets.internal.example or .internal.example can be used.

This does not replace ALLOWED_ASSET_DOMAINS; remote assets must still match the asset domain allowlist.

Cumraíocht réamhshocraithe:

ASSET_PRIVATE_ALLOWLIST = []

See also

ASSET_RESTRICT_PRIVATE

Added in version 2025.5.

Reject remote asset URLs pointing to internal or non-public addresses unless the target host is included in ASSET_PRIVATE_ALLOWLIST. On by default.

When enabled, hostnames that cannot be resolved during validation are rejected unless they are explicitly included in ASSET_PRIVATE_ALLOWLIST. This currently applies to screenshot URL uploads and remote HTML downloads for the Logánú JavaScript CDN add-on.

See also

ALTCHA_COST

Added in version 5.18.

Argon2id time cost for the ALTCHA proof-of-work challenge. Defaults to 3.

Replaces ALTCHA_MAX_NUMBER, which applied to the removed ALTCHA widget v2.

ALTCHA_MEMORY_COST

Added in version 5.18.

Argon2id memory cost in KiB. Defaults to 65536.

ALTCHA_PARALLELISM

Added in version 5.18.

Argon2id parallelism factor. Defaults to 1.

See also

Meicníocht Cruthúnas Oibre ALTCHA

ANONYMOUS_USER_NAME

Ainm úsáideora na n-úsáideoirí nach bhfuil sínithe isteach.

See also

Rialú rochtana

AUDITLOG_EXPIRY

An t-uaslíon laethanta a choinneoidh Weblate logaí iniúchta ina mbeidh faisnéis faoi ghníomhaíocht an chuntais.

Réamhshocrú go 180 lá.

AUTH_LOCK_ATTEMPTS

Uaslíon iarrachtaí fíordheimhnithe ar theip orthu sula gcuirtear teorannú rátaí i bhfeidhm.

Cuirtear é seo i bhfeidhm sna háiteanna seo a leanas faoi láthair:

  • Sínigh isteach. Scrios pasfhocal an chuntais, rud a chuireann cosc ar an úsáideoir síniú isteach gan pasfhocal nua a iarraidh.

  • Athshocrú pasfhocal. Cuireann sé cosc ar r-phoist nua a sheoladh, ag seachaint úsáideoirí turscair a bhfuil an iomarca iarrachtaí athshocrú pasfhocail acu.

Réamhshocruithe go dtí 10.

See also

Teorainn rátaí

AUTO_UPDATE

Nuashonraítear gach stór ar bhonn laethúil.

Hint

Úsáideach mura bhfuil tú ag úsáid Crúcaí fógra chun stórais Weblate a nuashonrú go huathoibríoch.

Note

Tá roghanna ar/as ann chomh maith le roghnú teaghrán le haghaidh comhoiriúnacht siar.

Is iad na roghanna:

"none"

Gan nuashonruithe laethúla.

"iargúlta" freisin Bréagach

Nuashonraigh cianrialtáin amháin.

"lán" freisin Fíor

Nuashonraigh ciandaí agus cumasc cóip oibre.

Note

Éilíonn sé seo go bhfuil Tascanna cúlra ag baint úsáide as Soilire ag obair, agus go dtiocfaidh sé i bhfeidhm tar éis é a atosú.

AVATAR_URL_PREFIX

Réimír chun URLanna abhatár a thógáil mar: ${AVATAR_URL_PREFIX}/avatar/${MAIL_HASH}?${PARAMS}. Is eol go n-oibríonn na seirbhísí seo a leanas:

Gravatar (réamhshocraithe), de réir https://gravatar.com/

AVATAR_URL_PREFIX = 'https://www.gravatar.com/'

Libravatar, de réir https://www.libravatar.org/

AVATAR_URL_PREFIX = 'https://www.libravatar.org/'

See also

AUTH_TOKEN_VALID

Cé chomh fada is atá an comhartha fíordheimhnithe agus an focal faire sealadach ó ríomhphoist athshocraithe pasfhocail bailí. Socraithe i roinnt soicind, réamhshocraithe go 172800 (2 lá).

AUTH_PASSWORD_DAYS

Cé mhéad lá a dhiúltaíonn Weblate pasfhocal a úsáideadh roimhe seo d’úsáideoir a athúsáid.

Tá an tseiceáil bunaithe ar loga an iniúchta, ní mór don AUDITLOG_EXPIRY a bheith mar a chéile ar a laghad.

Note

Ní thabharfar cuntas sa pholasaí seo ar athruithe pasfhocail a rinneadh roimh Weblate 2.15.

Réamhshocrú go 180 lá.

AUTOFIX_LIST

Liosta de na réitigh uathoibríocha le cur i bhfeidhm agus sreang á shábháil.

Note

Cuir cosán láncháilithe ar fáil chuig an rang Python a chuireann an comhéadan uath-leasaithe i bhfeidhm.

Déantar cur síos ar na réitigh atá ar fáil ag Ceartúcháin uathoibríoch.

Is féidir leat na cinn a úsáidfidh tú a roghnú:

AUTOFIX_LIST = (
    "weblate.trans.autofixes.whitespace.SameBookendingWhitespace",
    "weblate.trans.autofixes.chars.ReplaceTrailingDotsWithEllipsis",
)

See also

BACKGROUND_TASKS

Added in version 4.5.2.

Sainmhíníonn sé cé chomh minic is cóir tascanna cothabhála fada a chur i bhfeidhm do chomhpháirt.

Faoi láthair rialaíonn sé seo:

Roghanna féideartha:

  • míosúil (seo an réamhshocrú)

  • weekly

  • daily

  • never

Note

Ní mholtar an mhinicíocht a mhéadú nuair a bhíonn na mílte comhpháirt ag Weblate.

BASIC_LANGUAGES

Added in version 4.4.

Liosta teangacha le tairiscint d'úsáideoirí chun aistriúchán nua a thosú. Nuair nach sonraítear é, úsáidtear liosta ionsuite (lena n-áirítear na teangacha go léir a úsáidtear go coitianta, ach gan leaganacha a bhaineann go sonrach le tír).

Ní chuireann sé seo teorainn ach le húsáideoirí neamhphribhléideach teangacha nach dteastaíonn a chur leis. Cuirtear rogha iomlán na dteangacha atá sainmhínithe in Weblate i láthair fós do riarthóirí tionscadail.

Note

Ní shainíonn sé seo teangacha nua do Weblate — ní dhéanann sé ach na cinn atá sa bhunachar sonraí a scagadh.

Sampla:

BASIC_LANGUAGES = {"cs", "it", "ja", "en"}

See also

Sainmhínithe teanga

BORG_EXTRA_ARGS

Added in version 4.9.

Is féidir leat argóintí breise a chur ar aghaidh chuig borg create nuair a spreagtar cúltacaí ionsuite.

Sampla:

BORG_EXTRA_ARGS = ["--exclude", "vcs/"]

See also

CACHE_DIR

Added in version 4.16.

Eolaire ina stórálann Weblate comhaid taisce. Réamhshocraithe chuig fo-fhillteán cache in DATA_DIR.

Athraigh é seo go córas comhaid áitiúil nó sealadach má tá DATA_DIR ar chóras comhaid líonra.

Weblate stores generated helper files here and executes some of them, so CACHE_DIR has to be writable and mounted on a filesystem that allows execution. Avoid using noexec mount options for this directory.

Úsáideann an coimeádán Docker imleabhar ar leith chuige seo, féach Toirteanna coimeádán docker.

Is iondúil go mbíonn na fochomhadlanna seo a leanas ann:

ssh

Generated helper files used for VCS access.

fonts

font-config le haghaidh Clónna a bhainistiú.

avatar

Abhatáranna úsáideora i dtaisce, féach Abhatáir.

static

Suíomh réamhshocraithe do chomhaid statacha Django, sonraithe ag STATIC_ROOT. Féach Comhaid statacha a sheirbheáil.

tesseract

Sonraí oiliúnaithe OCR le haghaidh Scáileáin agus comhthéacs amhairc.

CSP_SCRIPT_SRC, CSP_IMG_SRC, CSP_CONNECT_SRC, CSP_STYLE_SRC, CSP_FONT_SRC, CSP_FORM_SRC

Saincheap an ceanntásc Content-Security-Policy do Weblate. Gintear an ceanntásc go huathoibríoch bunaithe ar chomhtháthú cumasaithe le seirbhísí tríú páirtí (Matomo, Google Analytics, Sentry, …).

De réir réamhshocraithe, bíonn liosta folamh ann.

Sampla:

# Enable Cloudflare Javascript optimizations
CSP_SCRIPT_SRC = ["ajax.cloudflare.com"]

See also

CHECK_LIST

Liosta de na seiceálacha cáilíochta atá le déanamh ar aistriúchán.

Note

Cosán láncháilithe a sholáthar don rang Python a chuireann an comhéadan seiceála i bhfeidhm.

Coigeartaigh liosta na seiceálacha chun cinn a bhaineann leat a chur san áireamh.

Tá na seiceanna ionsuite go léir Seiceálacha cáilíochta casadh air de réir réamhshocraithe, ón áit ar féidir leat na socruithe seo a athrú. De réir réamhshocraithe déantar trácht orthu in Cumraíocht samplach ionas go n-úsáidtear luachanna réamhshocraithe. Déantar seiceálacha nua ansin do gach leagan nua Weblate.

Is féidir leat gach seiceáil a mhúchadh:

CHECK_LIST = ()

Ní féidir leat ach cúpla ceann a chur ar siúl:

CHECK_LIST = (
    "weblate.checks.chars.BeginNewlineCheck",
    "weblate.checks.chars.EndNewlineCheck",
    "weblate.checks.chars.MaxLengthCheck",
)

Note

Ní bheidh tionchar ag athrú an tsocraithe seo ach ar aistriúcháin nua-athraithe. Stórálfar seiceálacha atá ann cheana sa bhunachar sonraí. Chun athruithe a chur i bhfeidhm ar na haistriúcháin stóráilte freisin, rith updatechecks.

See also

COMMIT_PENDING_HOURS

Líon na n-uaireanta idir athruithe ar feitheamh a dhéanamh mar gheall ar an tasc cúlra.

See also

COMPONENT_ZIP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Cumraíonn sé an méid uasta, i mbéiteanna, do chomhaid ZIP comhpháirte uaslódáilte. Is é 50 MB an réamhshocrú.

In Docker, cumraigh é seo ag baint úsáide as an athróg comhshaoil WEBLATE_COMPONENT_ZIP_UPLOAD_MAX_SIZE.

See also

CONTACT_FORM

Added in version 4.6.

Cumraíonn sé an chaoi a bhfuil ríomhphost ón bhfoirm teagmhála á sheoladh. Roghnaigh cumraíocht a mheaitseálann cumraíocht do fhreastalaí ríomhphoist.

"reply-to"

The sender is used as Reply-To, this is the default behaviour.

"from"

The sender is used as From. Your mail server needs to allow sending such e-mails.

"disabled"

Díchumasaíonn sé an fhoirm teagmhála go hiomlán.

Added in version 5.15.

See also

ADMINS_CONTACT

DATA_DIR

Stórálann an fillteán Weblate na sonraí go léir. Tá naisc ann le stórtha VCS, innéacs lántéacs agus comhaid chumraíochta éagsúla le haghaidh uirlisí seachtracha.

Is iondúil go mbíonn na fochomhadlanna seo a leanas ann:

home

Eolaire baile a úsáidtear chun scripteanna a agairt.

ssh

Eochracha SSH agus cumraíocht.

media

Suíomh réamhshocraithe do chomhaid meán Django, sonraithe ag MEDIA_ROOT. Tá screenshots uaslódáilte ann, féach Scáileáin agus comhthéacs amhairc.

vcs

Taisclanna rialaithe leagan le haghaidh aistriúcháin.

backups

Sonraí cúltaca laethúla. Seiceáil le do thoil Sonraí dumpáilte le haghaidh cúltacaí le haghaidh sonraí.

clónna:

Clónna uaslódála úsáideoirí, féach Clónna a bhainistiú.

cache

caches éagsúla. Is féidir é a chur in áit eile trí CACHE_DIR a úsáid.

Úsáideann an coimeádán Docker imleabhar ar leith chuige seo, féach Toirteanna coimeádán docker.

Note

Caithfidh Weblate a bheith inscríofa san eolaire seo. Má ritheann tú é mar WSGI, ba cheart go mbeadh rochtain scríbhneoireachta ag an úsáideoir www-data air.

Is é an bealach is éasca chun é seo a bhaint amach ná an t-úsáideoir a dhéanamh ina úinéir ar an eolaire:

sudo chown www-data:www-data -R $DATA_DIR

Réamhshocruithe chuig /home/weblate/data, ach táthar ag súil go mbeidh sé cumraithe.

See also

DATABASE_BACKUP

Cibé ar cheart cúltacaí an bhunachair shonraí a stóráil mar ghnáth-théacs, iad a chomhbhrú nó a scipeáil. Is iad na luachanna údaraithe:

  • "plain"

  • "compressed"

  • "none"

See also

Weblate a thacú agus a bhogadh

DEFAULT_ACCESS_CONTROL

An socrú rialaithe rochtana réamhshocraithe do thionscadail nua:

0

Poiblí

1

Cosanta

100

Private

200

Saincheaptha

Úsáid Custom má tá tú ag bainistiú ACL de láimh, rud a chiallaíonn nach bhfuil tú ag brath ar bhainistíocht inmheánach Weblate.

See also

DEFAULT_AUTO_WATCH

Added in version 4.5.

Cumraítear ar cheart Féach go huathoibríoch ar thionscadail ar ranníocaíocht a chur ar siúl d'úsáideoirí nua. Réamhshocrú go True.

See also

Fógraí

DEFAULT_RESTRICTED_COMPONENT

Added in version 4.1.

An luach réamhshocraithe le haghaidh srianadh comhpháirte.

See also

DEFAULT_ADD_MESSAGE, DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE, DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE

Teachtaireachtaí tiomnaithe réamhshocraithe le haghaidh oibríochtaí éagsúla, seiceáil le do thoil Cumraíocht na Comhpháirte le haghaidh sonraí.

See also

DEFAULT_ADDONS

Breiseáin réamhshocraithe le suiteáil do gach comhpháirt cruthaithe.

Note

Ní bhíonn tionchar ag an socrú seo ach ar chomhpháirteanna nuachruthaithe.

Sampla:

DEFAULT_ADDONS = {
    # Add-on with no parameters
    "weblate.flags.target_edit": {},
    # Add-on with parameters
    "weblate.autotranslate.autotranslate": {
        "mode": "suggest",
        "filter_type": "todo",
        "auto_source": "mt",
        "component": "",
        "engines": ["weblate-translation-memory"],
        "threshold": "80",
    },
}

See also

DEFAULT_COMMITER_EMAIL

Seoladh r-phoist an choimisinéara, ag dul chuig noreply@weblate.org réamhshocraithe.

See also

DEFAULT_COMMITER_NAME

DEFAULT_COMMITER_NAME

Ainm an choimisinéara, ag éirí as Weblate.

See also

DEFAULT_COMMITER_EMAIL

DEFAULT_LANGUAGE

Added in version 4.3.2.

Teanga foinse le haghaidh aon chomhpháirteanna nua.

Réamhshocruithe le en. Ní mór go mbeadh an oibiacht teanga chomhoiriúnaithe sa bhunachar sonraí.

See also

DEFAULT_MERGE_STYLE

Cumasc stíl le haghaidh aon chomhpháirteanna nua.

  • sionnach - réamhshocraithe

  • cumasc

See also

DEFAULT_SHARED_TM

Cumraíonn sé an luach réamhshocraithe de Úsáid cuimhne aistriúcháin roinnte agus Cuir le cuimhne aistriúcháin roinnte.

DEFAULT_TRANSLATION_REVIEW

Added in version 5.16.

Cumraíonn sé an luach réamhshocraithe do Cumasaigh léirmheasanna, múchta de réir réamhshocraithe.

DEFAULT_SOURCE_REVIEW

Added in version 5.16.

Cumraíonn sé an luach réamhshocraithe le haghaidh Cumasaigh léirmheasanna foinse, múchta de réir réamhshocraithe.

DEFAULT_AUTOCLEAN_TM

Added in version 5.13.

Cumraíonn sé an luach réamhshocraithe de Cuimhne aistriúcháin uathghlanadh.

DEFAULT_TRANSLATION_PROPAGATION

Socrú réamhshocraithe le haghaidh bolscaireachta aistriúcháin, réamhshocraithe go True.

See also

DEFAULT_PULL_MESSAGE

Cumraíonn sé an teideal réamhshocraithe agus an teachtaireacht le haghaidh iarratais tarraingthe.

ENABLE_AVATARS

Cibé ar cheart avatars bunaithe ar Gravatar a chur ar siúl d'úsáideoirí. Ar de réir réamhshocraithe.

Faightear avatars agus déantar iad a thaisceadh ar an bhfreastalaí, rud a íslíonn an baol go scaoilfí eolas príobháideach, rud a chuireann dlús leis an eispéireas úsáideora.

See also

ENABLE_HOOKS

Cibé ar cheart crúcaí cianda gan ainm a chur ar siúl.

See also

Crúcaí fógra

ENABLE_HTTPS

Changed in version 5.7: Tá https ag teastáil ó Weblate anois le haghaidh tacaíochta WebAuthn.

Cibé ar cheart naisc a sheoladh chuig Weblate mar HTTPS nó HTTP. Bíonn tionchar ag an socrú seo ar ríomhphoist seolta agus ar URLanna absalóideacha ginte.

Sa chumraíocht réamhshocraithe úsáidtear é seo freisin le haghaidh roinnt socruithe Django a bhaineann le HTTPS - cuireann sé ar chumas fianáin slán, scoránaigh HSTS nó cumasaíonn sé atreorú chuig URL HTTPS.

D'fhéadfadh go mbeadh fadhbanna ag an athatreorú HTTPS i roinnt cásanna agus d'fhéadfá fadhb a bhualadh le hathreorú gan teorainn i gcás go bhfuil seachfhreastalaí droim á úsáid agat ag déanamh foirceannadh SSL nach gcuireann ceannteidil prótacail ar Django i gceart. Athraigh do chumraíocht seachfhreastalaí droim le heastó X-Forwarded-Proto nó Forwarded ceannteidil nó cumraithe SECURE_PROXY_SSL_HEADER chun ligean do Django an stádas SSL a bhrath i gceart.

Sa chás go bhfuil sé seo díchumasaithe, ní thosóidh Weblate le hearráid otp_webauthn.E031. Is féidir leat an earráid seo a chur ina thost ach é a chur le SILENCED_SYSTEM_CHECKS, ach fós ní oibreoidh WebAuthn do shuíomhanna gan HTTPS.

See also

ENABLE_SHARING

Cas air/as an roghchlár Community ionas gur féidir le húsáideoirí dul chun cinn an aistriúcháin a roinnt ar líonraí sóisialta.

See also

Ag tógáil an phobail aistriúcháin

EXTRA_HTML_HEAD

Added in version 4.15.

Cuir marcáil bhreise isteach sa cheanntásc HTML. Is féidir é a úsáid chun úinéireacht suímh a fhíorú, mar shampla:

EXTRA_HTML_HEAD = '<link href="https://fosstodon.org/@weblate" rel="me">'

Warning

Ní dhéantar aon sláintíocht ar an sreang. Cuirtear isteach é mar atá sa cheanntásc HTML.

GET_HELP_URL

Added in version 4.5.2.

URL áit ar féidir tacaíocht a fháil do shampla Weblate.

GITEA_CREDENTIALS

Added in version 4.12.

Liosta dintiúir do fhreastalaithe Gitea.

GITEA_CREDENTIALS = {
    "try.gitea.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Is éard atá sa fhoclóir cumraíochta dintiúir atá sainmhínithe do gach óstach API Tá an leagan amach mar an gcéanna le haghaidh beagnach gach comhtháthú rialaithe leagan agus déantar cur síos air ag Dintiúir rialaithe leagan a chumrú.

See also

GITLAB_CREDENTIALS

Added in version 4.3.

Liosta dintiúir do fhreastalaithe GitLab.

GITLAB_CREDENTIALS = {
    "gitlab.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Note

Teastaíonn an raon feidhme api ón gcomhartha rochtana pearsanta le go mbeidh sé in ann an API a úsáid.

Is éard atá sa fhoclóir cumraíochta dintiúir atá sainmhínithe do gach óstach API Tá an leagan amach mar an gcéanna le haghaidh beagnach gach comhtháthú rialaithe leagan agus déantar cur síos air ag Dintiúir rialaithe leagan a chumrú.

See also

GITHUB_CREDENTIALS

Added in version 4.3.

Liosta le haghaidh dintiúir do fhreastalaithe GitHub.

GITHUB_CREDENTIALS = {
    "api.github.com": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Note

Is féidir comharthaí rochtana pearsanta mínmhionsonraithe agus comharthaí rochtana pearsanta clasaiceacha araon a úsáid. Tá na comharthaí mínmhionsonraithe teoranta d'eagraíocht amháin, mar sin ní oibreoidh sé más mian leat go ndéanfadh Weblate forc ar stór lasmuigh den eagraíocht (de ghnáth chuig ainmspás an úsáideora).

Chun iarratais a chlónáil, a bhrú agus a tharraingt a chruthú, tá rochtain léite agus scríofa ar Contents agus Pull requests ag teastáil.

Administration B'fhéidir go mbeadh 'riarachán' riachtanach freisin chun stór a fhorcáil má tá sé ar intinn agat forcáil a úsáid agus nach bhfuil an stór bunaidh poiblí.

Hint

Use api.github.com as an API host for https://github.com/.

Is éard atá sa fhoclóir cumraíochta dintiúir atá sainmhínithe do gach óstach API Tá an leagan amach mar an gcéanna le haghaidh beagnach gach comhtháthú rialaithe leagan agus déantar cur síos air ag Dintiúir rialaithe leagan a chumrú.

See also

BITBUCKETSERVER_CREDENTIALS

Added in version 4.16.

Liosta le haghaidh dintiúir le haghaidh Ionad Sonraí Bitbucket.

BITBUCKETSERVER_CREDENTIALS = {
    "git.self-hosted.com": {
        "username": "weblate",
        "token": "http-access-token",
    },
}

Is éard atá sa fhoclóir cumraíochta dintiúir atá sainmhínithe do gach óstach API Tá an leagan amach mar an gcéanna le haghaidh beagnach gach comhtháthú rialaithe leagan agus déantar cur síos air ag Dintiúir rialaithe leagan a chumrú.

See also

BITBUCKETCLOUD_CREDENTIALS

Added in version 5.8.

Liosta le haghaidh dintiúir do fhreastalaithe Bitbucket Cloud.

BITBUCKETCLOUD_CREDENTIALS = {
    "bitbucket.org": {
        "username": "your-email",
        "workspace": "your-workspace-slug",
        "token": "your-api-token",
    },
}

Tá an foclóir cumraíochta comhdhéanta de dhintiúir sainithe do gach óstach API. D'fhéadfadh go mbeadh an t-óstach API difriúil ón méid a úsáideann tú sa bhrabhsálaí gréasáin, mar shampla tá rochtain ag GitHub API mar api.github.com.

Tá an chumraíocht seo a leanas ar fáil do gach óstach:

username

Úsáideoir API.

workspace

An seilide spás oibre úsáideora.

token

An comhartha API le cead pullrequest:write.

Is féidir socruithe breise nach gcuirtear síos orthu anseo a fháil ag Dintiúir rialaithe leagan a chumrú.

See also

AZURE_DEVOPS_CREDENTIALS

Added in version 5.2.

Liosta le haghaidh dintiúir do fhreastalaithe Azure DevOps.

AZURE_DEVOPS_CREDENTIALS = {
    "dev.azure.com": {
        "username": "project-name",
        "token": "your-api-token",
        "organization": "organization-name",
    },
}

Tá an foclóir cumraíochta comhdhéanta de dhintiúir sainithe do gach óstach API. D'fhéadfadh go mbeadh an t-óstach API difriúil ón méid a úsáideann tú sa bhrabhsálaí gréasáin, mar shampla tá rochtain ag GitHub API mar api.github.com.

Tá an chumraíocht seo a leanas ar fáil do gach óstach:

username

Ainm an tionscadail Azure DevOps. Ní hé seo an t-ainm stór.

organization

Ainm eagraíocht an tionscadail.

workItemIds

Liosta roghnach d’aitheantais míreanna oibre ó d’eagraíocht. Nuair a sholáthraítear iarratais tarraingthe nua cuirfear iad seo i gceangal leis seo.

token

Comhartha API don úsáideoir API, riachtanach.

Is féidir socruithe breise nach gcuirtear síos orthu anseo a fháil ag Dintiúir rialaithe leagan a chumrú.

See also

GOOGLE_ANALYTICS_ID

Aitheantas Google Analytics chun monatóireacht ar Weblate a chur ar siúl ag baint úsáide as Google Universal Analytics.

Note

Níl comhtháthú Google Analytics 4 ar fáil do Weblate faoi láthair, féach https://github.com/WeblateOrg/weblate/issues/14015.

HIDE_REPO_CREDENTIALS

Folaigh dintiúir stórtha ón gcomhéadan gréasáin. Sa chás go bhfuil URL stórtha agat le húsáideoir agus pasfhocal, cuirfidh Weblate i bhfolach é nuair a thaispeánfar faisnéis ghaolmhar d'úsáideoirí.

Mar shampla, in ionad https://user:password@git.example.com/repo.git ní thaispeánfar ach https://git.example.com/repo.git. Déanann sé iarracht teachtaireachtaí earráide VCS a ghlanadh suas ar an mbealach céanna freisin.

Note

Ar de réir réamhshocraithe.

VERSION_DISPLAY

Added in version 5.17.

Rialaíonn sé cé chomh feiceálach is a nochtann Weblate a leagan féin.

Is iad seo a leanas na luachanna a dtacaítear leo:

show

Taispeáin an leagan i gcomhéadan úsáideora comhroinnte amhail an buntásc agus nochtaigh é i GET /api/metrics/.

soft

Folaigh an leagan ó chomhéadan úsáideora comhroinnte feiceálach, agus coinnigh infheicthe é ar an leathanach About agus i GET /api/metrics/.

hide

Folaigh an leagan ón gcomhéadan úsáideora comhroinnte agus GET /api/metrics/. Fágann sé seo freisin go bhfuil naisc dhoiciméadachta gan ainm ag pointeáil chuig an doiciméadacht is déanaí in ionad an leagan a mheaitseálann an scaoileadh suiteáilte.

Is cleachtas slándála molta i roinnt corparáidí é an leagan a cheilt, ach ní chuireann sé sin cosc ar ionsaitheoir an leagan a thuiscint trí iompar a fhiosrú.

Note

Is é taispeáin an réamhshocrú.

HIDE_VERSION

Added in version 4.3.1.

Deprecated since version 5.17.

Ailias comhoiriúnachta do VERSION_DISPLAY. Socraigh seo go True chun an t-iompar céanna a fháil agus atá ag VERSION_DISPLAY = "hide".

IP_BEHIND_REVERSE_PROXY

Léiríonn sé an bhfuil Weblate ag rith taobh thiar de sheachvótálaí droim ar ais.

Má tá sé socraithe go True, faigheann Weblate seoladh IP ó cheanntásc atá sainmhínithe ar IP_PROXY_HEADER.

Warning

Cinntigh go bhfuil tú ag baint úsáide as seachfhreastalaí droim ar ais agus go socraíonn sé an ceanntásc seo, nó beidh úsáideoirí in ann an seoladh IP a bhréagnú.

Note

Níl sé seo ar siúl de réir réamhshocraithe.

See also

IP_PROXY_HEADER

Léiríonn sé cén ceannteideal ba chóir do Weblate an seoladh IP a fháil nuair IP_BEHIND_REVERSE_PROXY a chasadh air.

Réamhshocrú le HTTP_X_FORWARDED_FOR.

See also

IP_PROXY_OFFSET

Changed in version 5.0.1: D'athraigh an réamhshocrú ó 1 go -1.

Léiríonn sé cén chuid de IP_PROXY_HEADER a úsáidtear mar sheoladh IP an chliaint.

Ag brath ar do shocrú, seans go mbeidh roinnt seoltaí IP sa cheanntásc seo, (mar shampla X-Forwarded-For: client-ip, proxy-a, proxy-b) agus is féidir leat a chumrú cén seoladh ón gceanntásc a úsáidtear mar sheoladh IP an chliaint anseo.

Warning

Bíonn tionchar ag an socrú seo ar shlándáil do shuiteála. Níor cheart duit é a chumrú ach chun seachfhreastalaithe iontaofa a úsáid chun an seoladh IP a chinneadh. Féach <https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/X-Forwarded-For#security_and_privacy_concerns> le haghaidh tuilleadh sonraí.

Réamhshocrú go -1.

See also

LICENSE_EXTRA

Ceadúnais bhreise le cur san áireamh sna roghanna ceadúnais.

Note

Each license definition should be a tuple of its short name, a long name, a URL and a boolean, indicating whether it is a libre license.

Mar shampla:

LICENSE_EXTRA = [
    (
        "AGPL-3.0",
        "GNU Affero General Public License v3.0",
        "https://www.gnu.org/licenses/agpl-3.0-standalone.html",
        True,
    ),
]

LICENSE_FILTER

Changed in version 4.3: Má shocraítear é seo ar luach bán díchumasaítear foláireamh ceadúnais anois.

Scag liosta na gceadúnas le taispeáint. Díchumasaíonn sé seo an foláireamh ceadúnais freisin nuair a shocraítear é a fholmhú.

Note

Úsáideann an scagaire seo na hainmneacha ceadúnais gairide.

Mar shampla:

LICENSE_FILTER = {"AGPL-3.0", "GPL-3.0-or-later"}

Díchumasaítear an foláireamh ceadúnais a leanas:

LICENSE_FILTER = set()

See also

Foláirimh comhpháirte aistriúcháin

LICENSE_REQUIRED

Sainmhíníonn sé cibé an bhfuil an aitreabúid ceadúnais in Cumraíocht na Comhpháirte ag teastáil.

Note

Tá sé seo múchta mar réamhshocrú.

LIMIT_TRANSLATION_LENGTH_BY_SOURCE_LENGTH

Ar cheart teorainn a chur le fad aistriúcháin ar leith. Is é an srian ná fad na teaghrán foinse × 10 gcarachtar.

Hint

Socraigh é seo go Bréagach chun aistriúcháin níos faide a cheadú (suas le 10,000 carachtar) beag beann ar fhad an téad foinse.

Note

Réamhshocrú go True.

LOCALIZE_CDN_URL agus LOCALIZE_CDN_PATH

These settings configure the CDN add-ons, including Logánú JavaScript CDN and Translation files CDN. LOCALIZE_CDN_URL defines root URL where the localization CDN is available and LOCALIZE_CDN_PATH defines path where Weblate should store generated files which will be served at the LOCALIZE_CDN_URL. The files are served by your web server or CDN, not by Weblate; see Logánú CDN for secure serving guidance.

Hint

Ar Weblate Óstáilte, úsáideann sé seo https://weblate-cdn.com/.

See also

MATOMO_SITE_ID

ID an tsuímh in Matomo (Pivik roimhe seo) is mian leat a úsáid chun Weblate a rianú.

Note

Ní thacaíonn an comhtháthú seo le Bainisteoir Clibeanna Matomo.

See also

MATOMO_URL

MATOMO_URL

URL iomlán (lena n-áirítear slaise rianaithe) de shuiteáil Matomo (Pivik roimhe seo) is mian leat a úsáid chun úsáid Weblate a rianú. Seiceáil le do thoil <https://matomo.org/> le haghaidh tuilleadh sonraí.

Hint

Ní thacaíonn an comhtháthú seo le Bainisteoir Clibeanna Matomo.

Mar shampla:

MATOMO_SITE_ID = 1
MATOMO_URL = "https://example.matomo.cloud/"

See also

MATOMO_SITE_ID

NEARBY_MESSAGES

Líon na teaghráin in aice láimhe le taispeáint i ngach treo san eagarthóir iomlán.

Níl anseo ach luach réamhshocraithe, is féidir le húsáideoirí é seo a choigeartú i Próifíl an úsáideora.

DEFAULT_PAGE_LIMIT

Added in version 4.7.

Líon réamhshocraithe na n-eilimintí le taispeáint nuair a bhíonn an leathanach gníomhach.

PAGURE_CREDENTIALS

Added in version 4.3.2.

Liosta dintiúir do fhreastalaithe Pagure.

PAGURE_CREDENTIALS = {
    "pagure.io": {
        "username": "weblate",
        "token": "your-api-token",
    },
}

Is éard atá sa fhoclóir cumraíochta dintiúir atá sainmhínithe do gach óstach API Tá an leagan amach mar an gcéanna le haghaidh beagnach gach comhtháthú rialaithe leagan agus déantar cur síos air ag Dintiúir rialaithe leagan a chumrú.

See also

PASSWORD_MINIMAL_STRENGTH

Added in version 5.10.2.

Íosscór focal faire arna mheas ag an meastóir láidreachta zxcvbn pasfhocail.

Réamhshocruithe go 0, rud a chiallaíonn go bhfuil seiceáil láidreachta díchumasaithe.

See also

PASSWORD_RESET_URL

Added in version 5.17.

URL le haghaidh athshocrú pasfhocail nuair a láimhseálann soláthraí aitheantais seachtrach an fíordheimhniú, amhail LDAP, SAML, nó OAuth.

Nuair a shocraítear é, nascann An ndearna tú dearmad ar do phasfhocal? ar an leathanach logála isteach chuig an URL seo seachas leathanach athshocraithe pasfhocail ionsuite Weblate.

PRIVACY_URL

Added in version 4.8.1.

URL a thaispeánann do chás Weblate a pholasaí príobháideachais.

Hint

Tá sé úsáideach má dhéanann tú do dhoiciméid dlí a óstáil lasmuigh de Weblate chun iad a leabú laistigh de Weblate, seiceáil le do thoil Modúl dlí le haghaidh sonraí.

Sampla:

PRIVACY_URL = "https://weblate.org/terms/"

See also

LEGAL_URL

PRIVATE_COMMIT_EMAIL_OPT_IN

Added in version 4.15.

Cumraíonn sé cibé an rogha an diúltaithe nó rogha an diúltaithe é an r-phost gealltanas príobháideach (de réir réamhshocraithe is rogha an diúltaithe é).

Hint

Ní bhaineann an socrú seo ach le húsáideoirí nach bhfuil r-phost gealltanais roghnaithe go sainráite acu.

See also

PRIVATE_COMMIT_EMAIL_TEMPLATE

Added in version 4.15.

Teimpléad chun ríomhphost tiomantais phríobháideach a ghiniúint d'úsáideoir. Is é "{username}@users.noreply.{site_domain}" an rogha réamhshocraithe.

Féadfaidh sé {user_id}, {username}, {site_title}, agus {site_domain} a bheith ann.

Socraigh go teaghrán bán chun é a dhíchumasú.

Note

Is rogha isteach é d'úsáideoirí ríomhphost tiomantais difriúil a úsáid mura bhfuil sé cumraithe ag PRIVATE_COMMIT_EMAIL_OPT_IN. Is féidir le húsáideoirí a ríomhphost tiomantais a chumrú sa Próifíl.

PRIVATE_COMMIT_NAME_OPT_IN

Added in version 5.16.

Cumraíonn sé seo an bhfuil an t-ainm tiomantais phríobháidigh rogha isteach nó rogha amach (is rogha isteach é de réir réamhshocraithe).

Hint

Ní bhaineann an socrú seo ach le húsáideoirí nár roghnaigh ainm tiomantais go sainráite.

See also

PRIVATE_COMMIT_NAME_TEMPLATE

Added in version 5.16.

Teimpléad chun ainm tiomantais phríobháidigh a ghiniúint d'úsáideoir. Is é "{site_title} úsáideoir {user_id}" an rogha réamhshocraithe.

Féadfaidh sé {user_id}, {username}, {site_title}, agus {site_domain} a bheith ann.

Socraigh go teaghrán bán chun é a dhíchumasú.

Note

Is rogha isteach é d'úsáideoirí ainm tiomantais difriúil a úsáid mura bhfuil sé cumraithe ag PRIVATE_COMMIT_NAME_OPT_IN. Is féidir le húsáideoirí a n-ainm tiomantais a chumrú sa Próifíl.

PROJECT_BACKUP_KEEP_COUNT

Added in version 4.14.

Sainmhíníonn sé cé mhéad cúltacaí in aghaidh an tionscadail a choimeádtar ar an bhfreastalaí. Réamhshocruithe go 3.

See also

Cúltacaí ag leibhéal an tionscadail

PROJECT_BACKUP_KEEP_DAYS

Added in version 4.14.

Sainmhíníonn sé cé chomh fada agus a choimeádfar cúltacaí an tionscadail ar an bhfreastalaí. Réamhshocrú go dtí 30 lá.

See also

Cúltacaí ag leibhéal an tionscadail

PROJECT_BACKUP_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Configures the maximum size, in bytes, for uploaded project backup ZIP files. Defaults to 536870912 bytes (512 MiB).

I Docker, cumraigh é seo ag baint úsáide as an athróg timpeallachta WEBLATE_PROJECT_BACKUP_UPLOAD_MAX_SIZE. Is féidir socruithe Docker a shrianadh freisin ag CLIENT_MAX_BODY_SIZE; is féidir imscaradh eile a shrianadh ag a dteorainn méide coirp iarrata seachfhreastalaí droim ar ais.

See also

Cúltacaí ag leibhéal an tionscadail

PROJECT_BACKUP_IMPORT_MAX_MEMBERS

Added in version 5.17.

Sainmhíníonn sé seo an líon uasta iontrálacha ZIP a cheadaítear agus cúltaca tionscadail á n-allmhairiú.

Is cosaint í seo i gcoinne cartlanna mífhoirmithe nó cartlanna atá ilroinnte d'aon ghnó. Is é 100,000 iontráil an réamhshocrú.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_MEMBERS environment variable.

See also

Cúltacaí ag leibhéal an tionscadail

PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE

Added in version 5.17.1.

Defines the maximum total uncompressed size, in bytes, for ZIP entries in an imported project backup. Defaults to 536870912 bytes (512 MiB).

Cuireann sé seo teorainn le cartlanna atá beag nuair a uaslódálfar iad ach a leathnaíonn chuig i bhfad níos mó sonraí le linn bailíochtaithe nó athchóirithe.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_TOTAL_UNCOMPRESSED_SIZE environment variable.

See also

Cúltacaí ag leibhéal an tionscadail

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE

Added in version 5.17.

Sainmhíníonn sé seo an uasmhéid neamh-chomhbhrúite, i mbéiteanna, le haghaidh iontráil ZIP aonair atá comhbhrúite go mór i gcúltaca tionscadail allmhairithe.

Ní chuirtear an teorainn seo i bhfeidhm ach ar iontrálacha atá mór go leor agus atá comhbhrúite go leor le go mbeadh cuma amhrasach orthu. Ceadaítear comhaid mhóra íseal-chomhbhrúite d'aon ghnó anseo agus meastar go mbeidh siad srianta ag an teorainn uaslódála HTTP. Is é 262144000 beart (250 MiB) an réamhshocrú.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE environment variable.

See also

Cúltacaí ag leibhéal an tionscadail

PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE

Added in version 5.17.

Sainmhíníonn sé an méid íosta neamh-chomhbhrúite, i mbéiteanna, ag a dtosaíonn Weblate ag cur an cóimheas comhbhrúite ZIP san áireamh le linn allmhairiú cúltaca tionscadail.

Déantar neamhaird de chomhaid níos lú le haghaidh bailíochtú bunaithe ar chóimheas comhbhrúite chun diúltú do chomhaid de mhéid réasúnta a chomhbhrúitear go maith. Is é 1048576 beart (1 MiB) an réamhshocrú.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE environment variable.

See also

Cúltacaí ag leibhéal an tionscadail

PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO

Added in version 5.17.

Sainmhíníonn sé seo an cóimheas uasta a cheadaítear idir an méid neamh-chomhbhrúite agus an méid comhbhrúite le haghaidh iontráil ZIP mhór le linn allmhairithe cúltaca tionscadail.

Úsáidtear é seo i dteannta PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_SIZE agus PROJECT_BACKUP_IMPORT_MIN_RATIO_SIZE chun iontrálacha atá comhbhrúite go hamhrasach a bhrath agus fós comhaid phacáiste stórais mhóra agus ábhar eile le comhbhrú íseal a cheadú. Is é 250 an réamhshocrú.

In Docker, configure this using the WEBLATE_PROJECT_BACKUP_IMPORT_MAX_COMPRESSED_ENTRY_RATIO environment variable.

See also

Cúltacaí ag leibhéal an tionscadail

PROJECT_NAME_RESTRICT_RE

Added in version 4.15.

Sainmhíníonn slonn rialta chun srian a chur ar ainmniú tionscadail. Diúltófar d’aon ainmneacha meaitseála.

See also

Ainm tionscadal

PROJECT_WEB_RESTRICT_HOST

Added in version 4.16.2.

Diúltaigh óstaigh áirithe a úsáid ar shuíomh Gréasáin an tionscadail. Déantar aon fhofhearann a mheaitseáil, mar sin san áireamh example.com cuirfear bac ar test.example.com freisin. Ba cheart go mbeadh teaghráin cháis íochtair amháin sa liosta, is cás íochtair an fearann parsáilte roimh mheaitseáil.

Cumraíocht réamhshocraithe:

PROJECT_WEB_RESTRICT_HOST = {"localhost"}

See also

PROJECT_WEB_RESTRICT_ALLOWLIST

Added in version 5.17.

Sainmhíníonn sé seo sraith de sheilidíní tionscadail atá díolmhaithe ó PROJECT_WEB_RESTRICT_HOST, PROJECT_WEB_RESTRICT_NUMERIC, PROJECT_WEB_RESTRICT_PRIVATE, agus PROJECT_WEB_RESTRICT_RE agus suíomh Gréasáin an tionscadail á bhailíochtú. Déantar seilidíní tionscadail a mheaitseáil gan cás a bheith íogair.

Caution

Laghdaíonn an díolúine seo cosaintí URL amach do thionscadail mheaitseála, lena n-áirítear an srianadh sprioc phríobháideach a fhorfheidhmítear ag PROJECT_WEB_RESTRICT_PRIVATE. Ná húsáid é ach amháin le haghaidh tionscadal iontaofa atá á mbainistiú ag riarthóir nuair a dhéantar seachaint ar na seiceálacha seo d'aon ghnó.

Cumraíocht réamhshocraithe:

PROJECT_WEB_RESTRICT_ALLOWLIST = set()

See also

PROJECT_WEB_RESTRICT_NUMERIC

Added in version 4.16.2.

Diúltaigh seoladh IP uimhriúil a úsáid ar shuíomh Gréasáin an tionscadail. Ar de réir réamhshocraithe.

See also

PROJECT_WEB_RESTRICT_PRIVATE

Added in version 5.17.

Diúltaigh ag baint úsáide as URLanna brabhsálaí láithreáin ghréasáin an tionscadail agus na stórtha a dhíríonn ar sheoltaí inmheánacha nó neamhphoiblí. Ar siúl de réir réamhshocraithe.

See also

PROJECT_WEB_RESTRICT_RE

Added in version 4.15.

Sainmhíníonn sé slonn rialta chun teorainn a chur leis an méid is féidir a chur isteach mar Láithreán gréasáin tionscadal. Diúltófar aon URLanna meaitseála.

See also

WEBHOOK_PRIVATE_ALLOWLIST

Added in version 5.17.

Sainmhíníonn sé seo ainmneacha óstach nó fearainn atá díolmhaithe ó WEBHOOK_RESTRICT_PRIVATE le haghaidh seachadadh webhook amach. Leanann iontrálacha séimeantaic mheaitseála óstach Django, mar sin is féidir luachanna ar nós hooks.internal.example nó .internal.example a úsáid.

Cumraíocht réamhshocraithe:

WEBHOOK_PRIVATE_ALLOWLIST = []

See also

WEBHOOK_RESTRICT_PRIVATE

Added in version 5.17.

Diúltaigh URLanna webhook a dhíríonn ar sheoltaí inmheánacha nó neamhphoiblí mura bhfuil an t-óstach sprice san áireamh i WEBHOOK_PRIVATE_ALLOWLIST. Ar siúl de réir réamhshocraithe.

Nuair a bhíonn sé cumasaithe, diúltaítear d'ainmneacha óstach nach féidir a réiteach le linn bailíochtaithe mura bhfuil siad san áireamh go sainráite i WEBHOOK_PRIVATE_ALLOWLIST.

See also

PUBLIC_ENGAGE

Added in version 5.16.2.

Ceadaíonn sé leathanach rannpháirtíochta poiblí fiú le REQUIRE_LOGIN.

See also

RATELIMIT_NOTIFICATION_LIMITS

Added in version 5.14.

Cuireann sé teorainn le líon na bhfógraí a sheolfar amach d'úsáideoir aonair.

Is é an socrú réamhshocraithe ná:

# Multi-level rate limiting for email notifications
# Each tuple contains (max_emails, time_window_seconds)
RATELIMIT_NOTIFICATION_LIMITS = [
    # Prevent burst sends - 3 emails per 2 minutes
    (3, 120),
    # Equalize to avoid getting blocked for too long - 10 emails per hour
    (10, 3600),
    # Daily limit: 50 emails per day
    (50, 86400),
]

RATELIMIT_ATTEMPTS

Uaslíon iarrachtaí fíordheimhnithe sula gcuirtear teorannú rátaí i bhfeidhm.

Réamhshocruithe go 5.

See also

RATELIMIT_WINDOW

Cé chomh fada is a ghlactar le fíordheimhniú tar éis teorannú rátaí a bheith i bhfeidhm.

Méid soicind, réamhshocraithe go 300 (5 nóiméad).

See also

RATELIMIT_LOCKOUT

Cé chomh fada is atá an fíordheimhnithe faoi ghlas tar éis teorannú rátaí a bheith i bhfeidhm.

Méid soicind réamhshocraithe go 600 (10 nóiméad).

See also

REGISTRATION_ALLOW_BACKENDS

Added in version 4.1.

Liosta na n-aisíní fíordheimhnithe chun clárú a cheadú ó. Ní chuireann sé seo teorainn le clárúcháin nua, ach is féidir le húsáideoirí fíordheimhniú a fhíordheimhniú agus a chur leis ag baint úsáide as gach inneall fíordheimhnithe cumraithe.

Moltar REGISTRATION_OPEN a choinneáil ar siúl agus cúlchríocha clárúcháin a theorannú, nó beidh úsáideoirí in ann clárú, ach ní thaispeánfaidh Weblate naisc chun clárú sa chomhéadan úsáideora.

Sampla:

REGISTRATION_ALLOW_BACKENDS = ["azuread-oauth2", "azuread-tenant-oauth2"]

Hint

Meaitseálann na hainmneacha inneall ainmneacha a úsáidtear san URL le haghaidh fíordheimhnithe.

See also

REGISTRATION_CAPTCHA

Cibé an bhfuil clárú cuntas nua cosanta ag CAPTCHA. Réamhshocruithe le cumasú.

If turned on, a CAPTCHA is added to all pages where a user enters their e-mail address:

  • Clárú cuntais nua.

  • Aisghabháil pasfhocal.

  • R-phost a chur le cuntas.

  • Foirm teagmhála d'úsáideoirí nach bhfuil sínithe isteach.

Tá na céimeanna seo a leanas sa chosaint faoi láthair:

REGISTRATION_EMAIL_MATCH

Ligeann sé duit na seoltaí ríomhphoist is féidir a chlárú a scagadh.

Réamhshocrú go .*, a cheadaíonn aon seoladh ríomhphoist a chlárú.

Is féidir leat é a úsáid chun clárú a shrianadh chuig fearann ríomhphoist amháin:

REGISTRATION_EMAIL_MATCH = r"^.*@weblate\.org$"

REGISTRATION_ALLOW_DISPOSABLE_EMAILS

Added in version 5.16.1.

Ceadaigh clárú le fearainn ríomhphoist indiúscartha. Nuair a bhíonn sé cumasaithe, seachnaítear an liosta blocála fearainn indiúscartha. Is é False an réamhshocrú.

See also

REGISTRATION_OPEN

Cibé an bhfuil clárú cuntas nua ceadaithe faoi láthair. Réamhshocruithe le cumasú.

Bíonn tionchar ag an socrú seo ar fhíordheimhniú ionsuite le seoladh ríomhphoist nó trí Python Social Auth (is féidir leat cúlchríocha áirithe a cheadú trí úsáid a bhaint as REGISTRATION_ALLOW_BACKENDS).

Note

Má tá modhanna fíordheimhnithe tríú páirtí á n-úsáid mar Fíordheimhniú LDAP, ní fholaíonn sé ach an fhoirm chlárúcháin, ach seans go mbeidh úsáideoirí nua fós in ann síniú isteach agus cuntais a chruthú.

See also

REGISTRATION_REBIND

Added in version 4.16.

Ceadaigh inneall fíordheimhnithe a athcheangal d'úsáideoirí reatha. Cuir é seo ar siúl agus tú ag aistriú idir soláthraithe fíordheimhnithe.

Note

Múchta de réir réamhshocraithe chun nach bhféadfar inneall fíordheimhnithe eile a chur le cuntas reatha. D’fhéadfadh comhréiteach cuntais a bheith mar thoradh ar athcheangal nuair a úsáidtear tuilleadh inneall fíordheimhnithe tríú páirtí.

REPOSITORY_ALERT_THRESHOLD

Added in version 4.0.2.

Tairseach chun foláireamh a chur ar bun maidir le stórtha atá as dáta, nó cinn a bhfuil an iomarca athruithe iontu. Réamhshocrú go dtí 25.

See also

Foláirimh comhpháirte aistriúcháin

REQUIRE_LOGIN

Added in version 4.1.

Cumasaíonn sé seo django.contrib.auth.middleware.LoginRequiredMiddleware agus cumraíonn sé creat REST chun fíordheimhniú a éileamh do gach críochphointe API.

Changed in version 5.15: Braitheann Weblate anois ar mheán-bhogearraí ionsuite Django.

Note

Cuirtear é seo i bhfeidhm sa Cumraíocht samplach. Le haghaidh Docker, úsáid WEBLATE_REQUIRE_LOGIN.

SENTRY_DSN

Sentry DSN le húsáid le haghaidh Tuarascálacha earráide a bhailiú agus monatóireacht a dhéanamh ar fheidhmíocht.

See also

Comhtháthú Django do Sentry

SENTRY_ENVIRONMENT

Cumraigh timpeallacht do Sentry. Réamhshocruithe le forbairt.

SENTRY_MONITOR_BEAT_TASKS

Added in version 5.13.

Cumraigh an ndéanfar monatóireacht ar thascanna Celery Beat le Sentry. Is é True an rogha réamhshocraithe.

SENTRY_PROFILES_SAMPLE_RATE

Cumraigh ráta samplála le haghaidh monatóireachta feidhmíochta. Socraigh go 1 chun gach imeacht a rianú, díchumasaítear 0 (an réamhshocrú) an rianú.

See also

Faireachán Feidhmíochta Sentry

SENTRY_SEND_PII

Lig do Sentry faisnéis áirithe inaitheanta phearsanta a bhailiú. Múchta de réir réamhshocraithe.

Changed in version 5.7: Tá sé seo múchta de réir réamhshocraithe anois, a úsáidtear chun é a chur ar siúl de réir réamhshocraithe.

SENTRY_TRACES_SAMPLE_RATE

Cumraigh ráta samplála le haghaidh monatóireachta próifílithe. Socraigh go 1 chun gach imeacht a rianú, díchumasaítear 0 (an réamhshocrú) an rianú.

See also

Próifíl Sentry

SIMPLIFY_LANGUAGES

Úsáid cóid shimplí teanga le haghaidh teaglamaí réamhshocraithe teanga/tíre. Mar shampla úsáidfidh aistriúchán fr_FR an cód teanga fr. Is gnách gurb é seo an t-iompar a theastaíonn, mar go ndéanann sé liostú teangacha do na teaglamaí réamhshocraithe seo a shimpliú.

Múch é seo más mian leat aistriúcháin dhifriúla a dhéanamh do gach leagan.

HIDE_SHARED_GLOSSARY_COMPONENTS

Added in version 5.16.

De ghnáth, roinntear comhpháirteanna na glosaire le tionscadail eile le go mbeidh siad ar fáil le haghaidh oibre aistriúcháin. Nuair a bhíonn siad seo le feiceáil i liosta na gcomhpháirteanna de thionscadail atá á n-úsáid, is féidir leis mearbhall a chruthú nó aistritheoirí a chur ar seachrán ó na comhpháirteanna iarbhír atá ceaptha a aistriú.

Tá sé seo múchta de réir réamhshocraithe, rud a fhágann go bhfuil comhpháirteanna comhroinnte na nglór le feiceáil.

SITE_DOMAIN

Cumraíonn sé fearann an tsuímh. Is gá naisc chearta a sholáthar i go leor scóip (mar shampla r-phoist gníomhachtaithe, fógraí nó fothaí RSS).

Má tá Weblate ag rith ar phort neamhchaighdeánach, cuir san áireamh anseo é freisin.

Samplaí:

# Production site with domain name
SITE_DOMAIN = "weblate.example.com"

# Local development with IP address and port
SITE_DOMAIN = "127.0.0.1:8000"

Note

Níor cheart go mbeadh ach an t-ainm fearainn sa socrú seo. Chun prótacal a chumrú, (ag cur HTTPS ar siúl agus á fhorfheidhmiú) úsáid ENABLE_HTTPS agus chun an URL a athrú, úsáid URL_PREFIX.

Hint

Ar choimeádán Docker, déantar fearann an tsuímh a chumrú trí WEBLATE_ALLOWED_HOSTS.

See also

SITE_TITLE

Teideal an tsuímh le húsáid don suíomh Gréasáin agus seoladh ríomhphoist.

SPECIAL_CHARS

Carachtair bhreise le cur san áireamh sa mhéarchlár amhairc, Méarchlár amhairc.

Is é an luach réamhshocraithe:

SPECIAL_CHARS = ("\t", "\n", "\u00a0", "…")

SINGLE_PROJECT

Atreoraíonn sé úsáideoirí go díreach chuig tionscadal nó comhpháirt seachas an painéal a thaispeáint. Is féidir leat é a shocrú go True mar sin ní oibríonn sé ach amháin mura bhfuil ann i ndáiríre ach tionscadal amháin i Weblate. Mar mhalairt air sin, socraigh seilide an tionscadail, agus déanfaidh sé atreorú gan choinníoll chuig an tionscadal seo.

Sampla:

SINGLE_PROJECT = "test"

SSH_EXTRA_ARGS

Added in version 4.9.

Ceadaíonn sé paraiméadair saincheaptha a chur leis nuair atá Weblate ag agairt SSH. Úsáideach agus tú ag nascadh le freastalaithe ag baint úsáide as criptiú oidhreachta nó gnéithe neamhchaighdeánacha eile.

Mar shampla nuair a theipeann ar nasc SSH in Weblate le Ní féidir idirbheartaíocht a dhéanamh le legacyhost: níor aimsíodh modh malartaithe eochrach meaitseála. A dtairiscint: diffie-hellman-group1-sha1, is féidir leat é sin a chur ar siúl ag baint úsáide as:

SSH_EXTRA_ARGS = "-oKexAlgorithms=+diffie-hellman-group1-sha1"

Hint

Déantar an teaghrán a mheas de réir an bhlaosc, mar sin cinntigh go luaitear aon spás bán agus carachtair speisialta.

See also

Roghanna Oidhreacht OpenSSH

STATUS_URL

An URL ina dtuairiscíonn do shampla Weblate a stádas.

SUPPORT_STATUS_CHECK

Added in version 5.5.

Díchumasaítear seiceáil stádais tacaíochta leathbhliantúil agus sár-úsáideoirí a atreorú agus iad ag logáil isteach chuig an leathanach síntiús ar eagla nach bhfuil aon síntiús gníomhach tacaíochta ann.

Hint

Feabhsaigh d'eispéireas Weblate trí shíntiús tacaíochta a cheannach agus trí dhul chun cinn Weblate a threisiú seachas é seo a mhúchadh.

TRANSLATION_UPLOAD_MAX_SIZE

Added in version 5.17.1.

Cumraíonn sé an méid uasta, i mbéiteanna, le haghaidh comhad aistriúcháin uaslódáilte. Is é 50 MB an réamhshocrú.

In Docker, cumraigh é seo ag baint úsáide as an athróg timpeallachta WEBLATE_TRANSLATION_UPLOAD_MAX_SIZE.

UNUSED_ALERT_DAYS

Added in version 4.17.

Cumraíonn sé nuair a spreagtar an foláireamh Component seems unused.

Réamhshocrú go 365 lá, socraigh go 0 chun é a chasadh as.

UPDATE_LANGUAGES

Added in version 4.3.2.

Rialaíonn cé acu ar cheart bunachar sonraí teangacha a nuashonrú agus aistriú bunachar sonraí á rith agus tá sé ar siúl de réir réamhshocraithe. Níl aon éifeacht ag an socrú seo ar setuplang a agairt.

Warning

Seans go n-éireodh taispeáint na dteangacha ar neamhréir leis seo. Leathnaíonn sainmhínithe teanga ar an ngréasán le himeacht ama agus ní thaispeánfaidh sé cód teanga do na teangacha sainithe.

See also

Sainmhínithe teanga ionsuite

URL_PREFIX

Ligeann an socrú seo duit Weblate a rith faoi chosán éigin (ar shlí eile braitheann sé ar a bheith á rith ó fhréamh an fhreastalaí gréasáin).

Note

Chun an socrú seo a úsáid, ní mór duit freisin do fhreastalaí a chumrú chun an réimír seo a bhaint. Mar shampla le WSGI, is féidir é seo a bhaint amach trí WSGIScriptAlias a shocrú.

Hint

Ba chóir go dtosódh an réimír le /.

Sampla:

URL_PREFIX = "/translations"

Note

Ní oibríonn an socrú seo le freastalaí ionsuite Django, bheadh ort urls.py a choigeartú chun an réimír seo a bheith ann.

VCS_ALLOW_HOSTS

Added in version 5.15.

Tacar óstach le ceadú agus URL VCS á chumrú. Is tacar folamh é an réamhshocrú, rud nach ndéanann aon scagadh ar chor ar bith.

Nuair a bhíonn VCS_RESTRICT_PRIVATE cumasaithe, tá óstaigh chomhoiriúnacha díolmhaithe ón srianadh sprioc phríobháideach freisin.

VCS_ALLOW_SCHEMES

Added in version 5.15.

Sraith scéimeanna URL le ceadú agus URL VCS á chumrú. Ní cheadaítear ach https agus ssh de réir réamhshocraithe.

VCS_RESTRICT_PRIVATE

Added in version 5.17.

Diúltaigh URLanna stórtha VCS atá ag díriú ar sheoltaí inmheánacha nó neamhphoiblí mura bhfuil an t-óstach sprice san áireamh i VCS_ALLOW_HOSTS. Ar siúl de réir réamhshocraithe.

Nuair a bhíonn sé cumasaithe, diúltaítear d'ainmneacha óstach nach féidir a réiteach le linn bailíochtaithe mura bhfuil siad san áireamh go sainráite i VCS_ALLOW_HOSTS.

VCS_API_DELAY

Added in version 4.15.1.

Configures minimal delay in seconds between third-party API calls in Iarratais tharraingt GitHub, Iarratais chumasc GitLab, Iarratais tarraingt Gitea, leathanach iarratais chumaisc, and Iarratais tarraingthe Azure DevOps.

Cuireann an ráta teorainneacha seo ar ghlaonna API ó Weblate chuig na seirbhísí seo chun ró-ualú a sheachaint.

Má tá tú faoi theorainn teorannaithe rátaí tánaisteacha ag GitHub, d’fhéadfadh go gcabhródh sé seo leat é seo a mhéadú.

Is é 10 an luach réamhshocraithe.

VCS_API_TIMEOUT

Added in version 5.15.

Configures timeout in seconds for third-party API calls such as forking or creating merge requests in Iarratais tharraingt GitHub, Iarratais chumasc GitLab, Iarratais tarraingt Gitea, leathanach iarratais chumaisc, and Iarratais tarraingthe Azure DevOps.

Is é 10 an luach réamhshocraithe.

VCS_BACKENDS

Cumraíocht na n-inneall VCS atá ar fáil.

Note

Déanann Weblate iarracht úsáid a bhaint as na cúlchríocha go léir a bhfuil na huirlisí agat ina leith.

Hint

Is féidir leat roghanna a theorannú nó cúlchríocha saincheaptha VCS a chur leis trí úsáid a bhaint as seo.

VCS_BACKENDS = ("weblate.vcs.git.GitRepository",)

See also

Comhtháthú rialaithe leagan

VCS_CLONE_DEPTH

Cumraíonn sé cé chomh domhain is ceart do chlónáil stórtha Weblate a dhéanamh.

Note

Faoi láthair ní thacaítear leis seo ach i Git. De réir réamhshocraithe déanann Weblate clón éadomhain de na stórtha chun clónáil a dhéanamh níos tapúla agus chun spás diosca a shábháil. Ag brath ar d'úsáid (mar shampla agus tú ag úsáid saincheaptha Breiseáin), b'fhéidir gur mhaith leat an doimhneacht a mhéadú nó clóin éadomhain a mhúchadh go hiomlán trí é seo a shocrú go 0.

Hint

Sa chás go bhfaigheann tú an earráid fatal: protocol error: expected old/new/ref, got 'shallow <commit hash>' agus tú ag brú ó Weblate, múch clónanna éadomhaine go hiomlán tríd an méid seo a leanas a shocrú:

VCS_CLONE_DEPTH = 0

WEBLATE_ADDONS

Liosta de na breiseáin atá ar fáil le húsáid. Chun iad a úsáid, ní mór iad a chumasú le haghaidh comhpháirt aistriúcháin ar leith. De réir réamhshocraithe, áirítear leis seo gach breiseán ionsuite, agus an liosta á leathnú beidh tú ag iarraidh na cinn atá ann cheana a choinneáil cumasaithe, mar shampla:

WEBLATE_ADDONS = (
    # Built-in add-ons
    "weblate.addons.gettext.GenerateMoAddon",
    "weblate.addons.gettext.UpdateLinguasAddon",
    "weblate.addons.gettext.UpdateConfigureAddon",
    "weblate.addons.gettext.MsgmergeAddon",
    "weblate.addons.gettext.GettextAuthorComments",
    "weblate.addons.cleanup.CleanupAddon",
    "weblate.addons.consistency.LanguageConsistencyAddon",
    "weblate.addons.discovery.DiscoveryAddon",
    "weblate.addons.flags.SourceEditAddon",
    "weblate.addons.flags.TargetEditAddon",
    "weblate.addons.flags.SameEditAddon",
    "weblate.addons.flags.BulkEditAddon",
    "weblate.addons.generate.GenerateFileAddon",
    "weblate.addons.properties.PropertiesSortAddon",
    "weblate.addons.git.GitSquashAddon",
    "weblate.addons.removal.RemoveComments",
    "weblate.addons.removal.RemoveSuggestions",
    "weblate.addons.resx.ResxUpdateAddon",
    "weblate.addons.autotranslate.AutoTranslateAddon",
    "weblate.addons.cdn.CDNJSAddon",
    # Add-on you want to include
    "weblate.addons.example.ExampleAddon",
)

Note

Má bhaintear an breiseán den liosta, ní dhíshuiteáiltear é ó na comhpháirteanna. Beidh Weblate tuairteála sa chás sin. Díshuiteáil an breiseán ó na comhpháirteanna go léir sula mbainfidh tú den liosta seo é le do thoil.

See also

ADDON_ACTIVITY_LOG_EXPIRY

Added in version 5.6.

Cumraíonn sé cé chomh fada agus a choimeádtar logaí gníomhaíochta do bhreiseáin. Réamhshocrú go 180 lá.

WEBLATE_EXPORTERS

Added in version 4.2.

Liosta d’onnmhaireoirí atá ar fáil a thairgeann aistriúcháin nó gluaiseanna a íoslódáil i bhformáidí éagsúla comhaid.

See also

Formáidí comhaid logánaithe

WEBLATE_FORMATS

Liosta de na formáidí comhaid atá ar fáil le húsáid.

Note

Tá na formáidí coitianta ar an liosta réamhshocraithe cheana féin.

See also

Formáidí comhaid logánaithe

WEBLATE_MACHINERY

Added in version 4.13.

Liosta de na seirbhísí innealra atá ar fáil le húsáid.

See also

WEBLATE_GPG_IDENTITY

Céannacht a úsáideann Weblate chun gealltanais Git a shíniú, mar shampla:

WEBLATE_GPG_IDENTITY = "Weblate <weblate@example.com>"

Cuardaítear eochairí GPG Weblate le haghaidh eochair mheaitseála (home/.gnupg faoi DATA_DIR). Mura bhfaightear é, gintear eochair, seiceáil le do thoil Tiomnaíonn síniú Git le GnuPG le haghaidh tuilleadh sonraí.

See also

Tiomnaíonn síniú Git le GnuPG

WEBSITE_REQUIRED

Sainmhíníonn sé cibé an gá Láithreán gréasáin tionscadal a shonrú agus tionscadal á chruthú. Ar aghaidh de réir réamhshocraithe, de réir mar a oireann do shocraithe freastalaí poiblí.

WEBSITE_ALERTS_ENABLED

Added in version 5.17.

Réamhshocrú: True

Sainmhíníonn sé seo an gceart do Weblate infhaighteacht shuíomh gréasáin tionscadail a sheiceáil agus foláirimh a thaispeáint maidir le suíomhanna gréasáin tionscadail nach féidir a bhaint amach.

Nuair a shocraítear go False é, seachnóidh Weblate seiceálacha infhaighteachta láithreáin ghréasáin agus ní ghinfidh sé foláirimh láithreáin ghréasáin tionscadail. Tá sé seo úsáideach nuair:

  • Tá do shuíomhanna gréasáin taobh thiar de bhallaí dóiteáin a chuireann bac ar iarratais Weblate

  • Ba mhaith leat earráidí de chineál 403/503 a sheachaint ó chosaint bota

  • Ní ábhar imní chun do shuiteáil infhaighteacht shuíomh gréasáin an tionscadail

See also

WEBSITE_REQUIRED

Dintiúir rialaithe leagan a chumrú

Hint

Déanann an chuid seo cur síos ar athróga inchreidte VCS mar GITHUB_CREDENTIALS, GITLAB_CREDENTIALS, GITEA_CREDENTIALS, PAGURE_CREDENTIALS, BITBUCKETSERVER_CREDENTIALS.

Tá an foclóir cumraíochta comhdhéanta de dhintiúir sainithe do gach óstach API. D'fhéadfadh go mbeadh an t-óstach API difriúil ón méid a úsáideann tú sa bhrabhsálaí gréasáin, mar shampla tá rochtain ag GitHub API mar api.github.com.

Is féidir na dintiúir a shárú freisin i URL bhrú stórais nó Stór cód foinse (mura bhfuil URL an bhrú cumraithe), bíonn tosaíocht acu seo thar na cinn atá sonraithe sa chomhad cumraíochta.

Tá an chumraíocht seo a leanas ar fáil do gach óstach:

username

Úsáideoir API, ag teastáil.

token

Comhartha API don úsáideoir API, riachtanach.

scheme

Added in version 4.18.

Sárú scéime. Déanann Weblate iarracht scéim a pharsáil ó URL an stórais agus téann sé ar ais go https. Má tá an freastalaí API á rith agat go hinmheánach, b'fhéidir gur mhaith leat http a úsáid ina ionad, ach smaoinigh ar shlándáil.

Hint

Sa choimeádán Docker, is féidir na dintiúir a chumrú le hathróga timpeallachta, féach Dintiúir suímh óstála cód.