Seiceálacha agus fixups

Ceartúcháin uathoibríocha saincheaptha

Is féidir leat do shocrú uathoibríoch féin a chur i bhfeidhm chomh maith leis na cinn caighdeánacha agus iad a chur san áireamh in AUTOFIX_LIST.

Tá na réitigh uathoibríoch cumhachtach, ach is féidir damáiste a dhéanamh freisin; bí cúramach agus ceann á scríobh agat.

Mar shampla, chuirfí bar in ionad gach teagmhas den teaghrán foo` in aistriúchán leis an socrú uathoibríoch seo a leanas:

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

from django.utils.translation import gettext_lazy

from weblate.trans.autofixes.base import AutoFix


class ReplaceFooWithBar(AutoFix):
    """Replace foo with bar."""

    name = gettext_lazy("Foobar")

    def fix_single_target(self, target, source, unit):
        if "foo" in target:
            return target.replace("foo", "bar"), True
        return target, False

Chun seiceálacha saincheaptha a shuiteáil, cuir conair láncháilithe ar fáil don rang Python sa AUTOFIX_LIST, féach Seiceálacha cáilíochta saincheaptha, breiseáin agus deisiúcháin uathoibríoch.

Saincheapadh iompar ag baint úsáide as bratacha

Is féidir leat iompar Weblate a mhionchoigeartú trí úsáid a bhaint as bratacha. Tugann na bratacha aiseolas amhairc do na haistritheoirí agus cabhraíonn siad leo a gcuid aistriúcháin a fheabhsú. Déantar na bratacha a chumasc ó na foinsí seo a leanas:

Tá na bratacha scartha le camóga; má tá paraiméadair acu, tá siad scartha le colon. Is féidir leat comharthaí athfhriotail a úsáid chun spásanna bána nó carachtair speisialta a chur san áireamh sa teaghrán. Mar shampla:

placeholders:"special:value":"other value", regex:.*

Glactar le comharthaí athfhriotail singil agus dúbailte, tá carachtair speisialta á n-éalú le cúlslais:

placeholders:"quoted \"string\"":'single \'quoted\''
placeholders:r"^#*"

Chun a fhíorú nach n-athraíonn aistritheoirí ceannteideal doiciméid Markdown: Cuirfear tús le seiceáil theipthe má aistrítear an teaghrán ### Index mar # Indice.

placeholders:r"\]\([^h].*?\)"

Chun a chinntiú nach bhfuil naisc inmheánacha á n-aistriú (i.e. [tástáil](../seiceálacha) ní dhéantar [tástáil](../seiceanna).

Is féidir na bratacha atá sainithe ar leibhéal níos airde a chaitheamh amach ag baint úsáide as an gcomhréir ''discard:NAME''. Mar shampla, má tá comhpháirt cumraithe le ''safe-html'', is féidir leat ''discard:safe-html'' a chur leis na bratacha teaghrán chun é a scipeáil don teaghrán áirithe seo.

Seo liosta de na bratacha a nglactar leo faoi láthair:

rst-text

Caitheamh le téacs mar dhoiciméad Téacs athstruchtúrtha, a théann i bhfeidhm ar Aistriúchán gan athrú. Tá sé ar siúl Earráid chomhréire reStructuredText agus Tagairtí Téacs athstruchtúrtha neamh-chomhsheasmhach.

bbcode-text

Déileáil le téacs mar dhoiciméad Cód Feasacháin (BBCode), a dhéanann difear do Aistriúchán gan athrú.

dos-eol

Úsáideann sé marcóirí deireadh líne DOS in ionad cinn Unix (\r\n in ionad \n).

read-only

Tá an teaghrán léite amháin agus níor cheart é a chur in eagar i Weblate, féach Teaghráin inléite amháin.

terminology

Úsáidtear in Gluais. Cóipeálann sé an sreang isteach i ngach teanga gloiseach ionas gur féidir é a úsáid go comhsheasmhach i ngach aistriúchán Úsáideach freisin i dteannta le read-only, mar shampla in ainmneacha táirgí.

priority:N

Tosaíocht na sreinge. Cuirtear teaghráin ardtosaíochta i láthair ar dtús le haistriú. Is é 100 an tosaíocht réamhshocraithe, dá airde tosaíocht atá ag teaghrán, is ea is luaithe a thairgtear í le haistriú.

max-length:N

Teorainn an fad uasta do teaghrán go dtí N carachtar, féach Fad uasta an aistriúcháin.

xml-text

Déileáil le téacs mar dhoiciméad XML, bíonn tionchar aige Comhréir XML agus XML marcáil.

font-family:NAME

Sainmhínigh cló-teaghlach le haghaidh seiceálacha rindreála, féach Clónna a bhainistiú.

font-weight:WEIGHT

Sainmhínigh meáchan cló le haghaidh seiceálacha rindreála, féach Clónna a bhainistiú.

font-size:SIZE

Sainmhínigh clómhéid le haghaidh seiceálacha rindreála, féach Clónna a bhainistiú.

font-spacing:SPACING

Sainmhínigh spásáil litreacha le haghaidh seiceálacha rindreála, féach Clónna a bhainistiú.

icu-flags:FLAGS

Sainmhínigh bratacha chun iompar an seiceála cáilíochta Formáid Teachtaireacht ICU a shaincheapadh.

icu-tag-prefix:PREFIX

Socraigh réimír riachtanach le haghaidh clibeanna XML don seiceáil cáilíochta Formáid Teachtaireacht ICU.

placeholders:NAME:NAME2:...

Táthar ag súil le teaghráin sealbhóirí san aistriúchán, féach Áitsealbhóirí.

replacements:FROM:TO:FROM2:TO2...

Athsholáthairtí le déanamh agus paraiméadair an téacs mar thoradh á seiceáil (mar shampla i Uasmhéid an aistriúcháinFad uasta an aistriúcháin). Is é an gnáthchás úsáide chuige seo ná cuir in áit a leathnú chun a chinntiú go luíonn an téacs fiú le luachanna fada, mar shampla: athsholáthair:%s:"John Doe".

variants:SOURCE

Marcáil an teaghrán seo mar leagan de shreang le foinse meaitseála. Féach Leaganacha teaghrán.

regex:REGEX

Slonn rialta chun an t-aistriúchán a mheaitseáil, féach Léiriú rialta.

discard:NAME

Bratach a chur i leataobh ar leibhéal níos airde.

forbidden

Léiríonn sé aistriúchán toirmiscthe i ngluaiseacht, féach Aistriúcháin toirmiscthe.

strict-same

Lig duit Aistriúchán gan athrú liosta dubh inmheánach a sheachaint.

strict-format

Déan seiceálacha formáide a chur i bhfeidhm ag baint úsáide as formáid fiú i gcás foirmeacha iolra a bhfuil luach amháin acu, féach Teaghráin formáidithe.

check-glossary

Cumasaigh an seiceáil cáilíochta Ní leanann gluais.

angularjs-format

Cumasaigh an seiceáil cáilíochta Teaghrán idirshuíomh AngularJS.

c-format

Cumasaigh an seiceáil cáilíochta Formáid C.

c-sharp-format

Cumasaigh seiceáil cáilíochta Formáid C#.

es-format

Cumasaigh an seiceáil cáilíochta Teimpléad ECMAScript litreach.

i18next-interpolation

Cumasaigh seiceáil cáilíochta i18 chéad idirshuíomh eile.

icu-message-format

Cumasaigh an seiceáil cáilíochta Formáid Teachtaireacht ICU.

java-printf-format

Cumasaigh an seiceáil cáilíochta Formáid Java.

java-format

Cumasaigh seiceáil cáilíochta Formáid Teachtaireacht Java.

javascript-format

Cumasaigh an seiceáil cáilíochta Formáid javascript.

lua-format

Cumasaigh an seiceáil cáilíochta Formáid Lua.

object-pascal-format

Cumasaigh seiceáil cáilíochta Formáid Pascal saor in aisce,.

percent-placeholders

Cumasaigh seiceáil cáilíochta Céatadán sealbhóirí áitribh.

perl-brace-format

Cumasaigh an seiceáil cáilíochta Formáid perl brace.

perl-format

Cumasaigh an seiceáil cáilíochta Formáid Perl.

php-format

Cumasaigh an seiceáil cáilíochta Formáid PHP.

python-brace-format

Cumasaigh an seiceáil cáilíochta Formáid brace python.

python-format

Cumasaigh seiceáil cáilíochta Formáid Python.

qt-format

Cumasaigh an seiceáil cáilíochta Formáid Qt.

qt-plural-format

Cumasaigh an seiceáil cáilíochta Qt formáid iolra.

ruby-format

Cumasaigh an seiceáil cáilíochta Formáid Ruby.

scheme-format

Cumasaigh an seiceáil cáilíochta Formáid scéime.

vue-format

Cumasaigh an seiceáil cáilíochta Formáidiú Vue I18n.

md-text

Déileáil le téacs mar dhoiciméad Markdown, agus soláthar aibhsiú comhréireachta Markdown ar an limistéar téacs aistriúcháin. Cumasaíonn sé naisc Markdown, Tagairtí Markdown, agus Comhréir Markdown seiceálacha cáilíochta.

case-insensitive

Coigeartaigh iompar seiceálacha le bheith neamh-íogair. Faoi láthair bíonn tionchar ag seiceáil cáilíochta Áitsealbhóirí amháin.

safe-html

Cumasaigh an seiceáil cáilíochta HTML neamhshábháilte.

url

Níor chóir go mbeadh ach URL ar an sreang. Cumasaigh an seiceáil cáilíochta URL.

ignore-all-checks

Déan neamhaird de gach seiceáil cáilíochta.

fluent-source-inner-html

Cumasaigh an seiceáil cáilíochta HTML inmheánach foinse líofa.

fluent-source-syntax

Cumasaigh an seiceáil cáilíochta Comhréir foinse líofa.

icu-message-format

Cumasaigh an seiceáil cáilíochta Comhréir ICU MessageFormat.

ignore-bbcode

Scipeáil an seiceáil cáilíochta Marcáil BBCode.

ignore-duplicate

Scipeáil an seiceáil cáilíochta Focail dúblacha as a chéile.

ignore-check-glossary

Scipeáil an seiceáil cáilíochta Ní leanann gluais.

ignore-double-space

Scipeáil an seiceáil cáilíochta Spás dúbailte.

ignore-fluent-parts

Scipeáil an seiceáil cáilíochta Páirteanna líofa.

ignore-fluent-references

Scipeáil an seiceáil cáilíochta Tagairtí líofa.

ignore-fluent-target-inner-html

Scipeáil an seiceáil cáilíochta HTML inmheánach aistriúchán líofa.

ignore-fluent-target-syntax

Scipeáil an seiceáil cáilíochta Comhréir aistriúcháin líofa.

ignore-angularjs-format

Scipeáil ar an seiceáil cáilíochta Teaghrán idirshuíomh AngularJS.

ignore-automattic-components-format

Seachain an seiceáil cáilíochta Formáidiú comhpháirteanna uathoibrithe.

ignore-c-format

Scipeáil an seiceáil cáilíochta Formáid C.

ignore-c-sharp-format

Scipeáil an seiceáil cáilíochta Formáid C#.

ignore-es-format

Scipeáil an seiceáil cáilíochta Teimpléad ECMAScript litreach.

ignore-i18next-interpolation

Scipeáil an seiceáil cáilíochta i18 chéad idirshuíomh eile.

ignore-icu-message-format

Scipeáil ar an seiceáil cáilíochta Formáid Teachtaireacht ICU.

ignore-java-printf-format

Scipeáil ar an seiceáil cáilíochta Formáid Java.

ignore-java-format

Scipeáil an seiceáil cáilíochta Formáid Teachtaireacht Java.

ignore-javascript-format

Scipeáil an seiceáil cáilíochta Formáid javascript.

ignore-lua-format

Scipeáil an seiceáil cáilíochta Formáid Lua.

ignore-object-pascal-format

Scipeáil an seiceáil cáilíochta Formáid Pascal saor in aisce,.

ignore-percent-placeholders

Scipeáil an seiceáil cáilíochta Céatadán sealbhóirí áitribh.

ignore-perl-brace-format

Scipeáil ar an seiceáil cáilíochta Formáid perl brace.

ignore-perl-format

Scipeáil an seiceáil cáilíochta Formáid Perl.

ignore-php-format

Scipeáil ar an Formáid PHP seiceáil cáilíochta.

ignore-python-brace-format

Scipeáil an seiceáil cáilíochta Formáid brace python.

ignore-python-format

Scipeáil an seiceáil cáilíochta Formáid Python.

ignore-qt-format

Scipeáil an seiceáil cáilíochta Formáid Qt.

ignore-qt-plural-format

Scipeáil ar an seiceáil cáilíochta Qt formáid iolra.

ignore-ruby-format

Scipeáil an seiceáil cáilíochta Formáid Ruby.

ignore-scheme-format

Scipeáil an seiceáil cáilíochta Formáid scéime.

ignore-vue-format

Scipeáil an seiceáil cáilíochta Formáidiú Vue I18n.

ignore-translated

Scipeáil an seiceáil cáilíochta Aistríodh.

ignore-inconsistent

Scipeáil ar an Neamh-chomhsheasmhach seiceáil cáilíochta.

ignore-rst-references

Scipeáil an seiceáil cáilíochta Tagairtí Téacs athstruchtúrtha neamh-chomhsheasmhach.

ignore-kashida

Scipeáil an seiceáil cáilíochta Litir Kashida a úsáideadh.

ignore-md-link

Scipeáil ar an naisc Markdown seiceáil cáilíochta.

ignore-md-reflink

Scipeáil ar an Tagairtí Markdown seiceáil cáilíochta.

ignore-md-syntax

Scipeáil ar an Comhréir Markdown seiceáil cáilíochta.

ignore-max-length

Scipeáil an seiceáil cáilíochta Fad uasta an aistriúcháin.

ignore-max-size

Scipeáil an seiceáil cáilíochta Uasmhéid an aistriúcháin.

ignore-escaped-newline

Scipeáil an seiceáil cáilíochta Mímheaitseáilte \n.

ignore-end-colon

Scipeáil an seiceáil cáilíochta colon mímheaitseála.

ignore-end-ellipsis

Scipeáil an seiceáil cáilíochta Éipideas mímheaitseála.

ignore-end-exclamation

Scipeáil an seiceáil cáilíochta Comhartha exclamation mímheaitseála.

ignore-end-stop

Scipeáil an seiceáil cáilíochta lánstad mí-oiriúnach.

ignore-end-interrobang

Scipeáil ar an Interrobang mícheart seiceáil cáilíochta.

ignore-end-question

Scipeáil ar an Comhartha ceiste mímheaitseála seiceáil cáilíochta.

ignore-end-semicolon

Scipeáil an seiceáil cáilíochta Leathstad mímheaitseála.

ignore-newline-count

Scipeáil an seiceáil cáilíochta Briseadh líne mímheaitseála.

ignore-plurals

Scipeáil an seiceáil cáilíochta Iolra ar iarraidh.

ignore-kabyle-characters

Seachain an seiceáil cáilíochta Carachtair neamhchaighdeánacha i gCabile.

ignore-placeholders

Scipeáil an seiceáil cáilíochta Áitsealbhóirí.

ignore-prohibited-initial-character

Scipeáil an seiceáil cáilíochta Toirmiscthe carachtar tosaigh.

ignore-punctuation-spacing

Scipeáil an seiceáil cáilíochta Spásáil poncaíochta.

ignore-regex

Scipeáil an seiceáil cáilíochta Léiriú rialta.

ignore-rst-syntax

Scipeáil ar an Earráid chomhréire reStructuredText seiceáil cáilíochta.

ignore-reused

Scipeáil an seiceáil cáilíochta Aistriúchán athúsáidte.

ignore-same-plurals

Scipeáil an seiceáil cáilíochta Na foirmeacha iolra céanna.

ignore-begin-newline

Scipeáil an seiceáil cáilíochta Líne nua a thosú.

ignore-begin-space

Scipeáil an seiceáil cáilíochta Spásanna tosaithe.

ignore-end-newline

Scipeáil an seiceáil cáilíochta Líne nua á lorg.

ignore-end-space

Scipeáil an seiceáil cáilíochta Spás leantóir.

ignore-same

Scipeáil an seiceáil cáilíochta Aistriúchán gan athrú.

ignore-safe-html

Léim ar an HTML neamhshábháilte seiceáil cáilíochta.

ignore-url

Scipeáil an seiceáil cáilíochta URL.

ignore-xml-tags

Scipeáil an seiceáil cáilíochta XML marcáil.

ignore-xml-invalid

Scipeáil an seiceáil cáilíochta Comhréir XML.

ignore-zero-width-space

Scipeáil an seiceáil cáilíochta Spás nialasach.

ignore-ellipsis

Scipeáil an seiceáil cáilíochta Éilips.

ignore-fluent-source-inner-html

Scipeáil an seiceáil cáilíochta HTML inmheánach foinse líofa.

ignore-fluent-source-syntax

Scipeáil an seiceáil cáilíochta Comhréir foinse líofa.

ignore-icu-message-format

Scipeáil ar an Comhréir ICU MessageFormat seiceáil cáilíochta.

ignore-long-untranslated

Scipeáil an seiceáil cáilíochta Fada gan aistriúchán.

ignore-multiple-failures

Scaipeáil an seiceáil cáilíochta Seiceálacha teip iolracha.

ignore-unnamed-format

Scipeáil an seiceáil cáilíochta Athróga iolracha gan ainm.

ignore-optional-plural

Scipeáil an seiceáil cáilíochta Neamhiolra.

Note

De ghnáth ainmnítear an riail ignore-* d'aon seiceáil, ag baint úsáide as a aitheantóir, ionas gur féidir leat é seo a úsáid fiú le haghaidh do sheiceálacha saincheaptha.

Tuigtear na bratacha seo i socruithe Cumraíocht na Comhpháirte, de réir socruithe teaghrán foinse agus sa chomhad aistriúcháin féin (mar shampla i gettext GNU).

Seiceálacha a fhorfheidhmiú

Is féidir leat liosta seiceálacha a chumrú nach féidir neamhaird a dhéanamh orthu ach Seiceálacha forfheidhmithe a shocrú i Cumraíocht na Comhpháirte. Ní féidir gach seic liostaithe a dhíbhe sa chomhéadan úsáideora agus marcáiltear aon teaghrán a dteipeann uirthi sa tseiceáil seo mar Tá eagarthóireacht de dhíth air (féach Stáit aistriúcháin).

Note

Má chuirtear forghníomhú seiceanna ar siúl ní féidir é a chumasú go huathoibríoch. Is féidir an tseic a chur ar siúl tríd an mbratach chomhfhreagrach a chur le bratacha teaghrán nó comhpháirte.

Clónna a bhainistiú

Hint

Úsáidtear clónna a uaslódáiltear chuig Weblate chun críocha an tseiceáil Uasmhéid an aistriúcháin amháin, níl aon éifeacht acu i gcomhéadan úsáideora Weblate.

Ní mór an seice Uasmhéid an aistriúcháin a úsáidtear chun toisí an téacs rindreáilte a ríomh cló a luchtú isteach sa Weblate agus a roghnú ag baint úsáide as bratach aistriúcháin (féach Saincheapadh iompar ag baint úsáide as bratacha).

Uirlis bainistíochta cló Weblate i Fonts faoin roghchlár Manage do thionscadal aistriúcháin comhéadan chun clónna a uaslódáil agus a bhainistiú. Is féidir clónna TrueType nó OpenType a uaslódáil, clóghrúpaí a shocrú agus iad siúd atá sa tseic a úsáid.

Ligeann na grúpaí cló duit clónna éagsúla a shainiú do theangacha éagsúla, rud a bhíonn ag teastáil go hiondúil do theangacha nach teangacha Laidineacha iad:

../_images/font-group-edit.webp

Aithnítear na grúpaí cló de réir ainm, nach féidir spás bán nó carachtair speisialta a bheith iontu, ionas gur féidir é a úsáid go héasca sa sainmhíniú seiceála:

../_images/font-group-list.webp

Aithnítear cló-teaghlach agus stíl go huathoibríoch tar éis iad a uaslódáil:

../_images/font-edit.webp

Is féidir leat roinnt clónna a lódáil isteach i Weblate:

../_images/font-list.webp

Chun na clónna a úsáid chun fad an sreangáin a sheiceáil, cuir na bratacha cuí air (féach Saincheapadh iompar ag baint úsáide as bratacha). Is dócha go mbeidh na cinn seo a leanas de dhíth ort:

uasmhéid: 500 / uasmhéid:300:5

Sainmhíníonn sé an leithead uasta i bpicteilíní agus, go roghnach, an t-uaslíon línte (cuirtear beart fillte i bhfeidhm).

font-family:ubuntu

Sainmhíníonn grúpa cló le húsáid trína aitheantóir a shonrú.

font-size:22

Sainmhíníonn clómhéid i bpicteilíní.

Ag scríobh seiceanna féin

Tá raon leathan seiceálacha cáilíochta ionsuite, (féach Seiceálacha cáilíochta), cé go bhféadfadh nach gclúdaíonn siad gach rud is mian leat a sheiceáil. Is féidir liosta na seiceálacha a dhéantar a choigeartú ag baint úsáide as CHECK_LIST, agus is féidir leat seiceálacha saincheaptha a chur leis freisin.

  1. Fo-aicme an weblate.checks.Check

  2. Socraigh cúpla tréithe.

  3. Cuir an seiceáil i bhfeidhm (má tá tú ag iarraidh déileáil leis na hiolra i do chód) nó an modh check_single (a dhéanann sé duit).

Roinnt samplaí:

Chun seiceálacha saincheaptha a shuiteáil, cuir conair láncháilithe ar fáil don rang Python sa CHECK_LIST, féach Seiceálacha cáilíochta saincheaptha, breiseáin agus deisiúcháin uathoibríoch.

Níl "foo" i dtéacs an aistriúcháin

Is seiceáil simplí go leor é seo a dhéanann seiceáil an bhfuil an teaghrán "foo" in easnamh ar an aistriúchán.

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Simple quality check example."""

from django.utils.translation import gettext_lazy

from weblate.checks.base import TargetCheck


class FooCheck(TargetCheck):
    # Used as identifier for check, should be unique
    # Has to be shorter than 50 characters
    check_id = "foo"

    # Short name used to display failing check
    name = gettext_lazy("Foo check")

    # Description for failing check
    description = gettext_lazy("Your translation is foo")

    # Real check code
    def check_single(self, source, target, unit):
        return "foo" in target

Seiceáil go bhfuil difríocht idir iolraí téacs aistriúcháin na Seice

Seiceáil ag baint úsáide as faisnéis teanga chun a fhíorú nach bhfuil an dá fhoirm iolra sa teanga Seicis mar an gcéanna.

# Copyright © Michal Čihař <michal@weblate.org>
#
# SPDX-License-Identifier: GPL-3.0-or-later

"""Quality check example for Czech plurals."""

from django.utils.translation import gettext_lazy

from weblate.checks.base import TargetCheck


class PluralCzechCheck(TargetCheck):
    # Used as identifier for check, should be unique
    # Has to be shorter than 50 characters
    check_id = "foo"

    # Short name used to display failing check
    name = gettext_lazy("Foo check")

    # Description for failing check
    description = gettext_lazy("Your translation is foo")

    # Real check code
    def check_target_unit(self, sources, targets, unit):
        if unit.translation.language.is_base({"cs"}):
            return targets[1] == targets[2]
        return False

    def check_single(self, source, target, unit) -> bool:
        """We don't check target strings here."""
        return False