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, chuirfeadh an ceartú uathoibríoch seo a leanas in ionad gach teaghrán foo in aistriúchán le bar:
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, moltaí uathoibríocha agus ceartúcháin uathoibríocha.
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:
Bratacha breise teaghrán foinse:
Déanann Eolas breise ar na teaghráin foinse cur síos ar eagarthóireacht láimhe.
Is féidir Bulc eagarthóireacht a úsáid chun bratacha a chur i bhfeidhm i mbaisc.
Is féidir le breiseán Bulc eagarthóireacht bratacha a chur i bhfeidhm go huathoibríoch.
Bratacha in aghaidh an teaghrán a bhaintear as an bhformáid comhaid, féach Formáidí comhaid logánaithe.
Bratacha aistriúcháin (bratach
léamh-amháinamháin le haghaidh teaghrán foinse dátheangach faoi láthair).Bratacha ar leith formáid comhaid.
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á sainmhínithe 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 go safe-html, is féidir leat discard:safe-html a chur leis na bratacha teaghráin chun iad a scipeáil don teaghrán seo.
Seo liosta de na bratacha a nglactar leo faoi láthair:
rst-textCaitheamh 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 Téacs Athstruchtúrtha Neamhréireach.
bbcode-textDé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\nin ionad\n).read-onlyTá 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:NTosaí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:NTeorainn an fad uasta do teaghrán go dtí N carachtar, féach Fad uasta an aistriúcháin.
xml-textDéileáil le téacs mar dhoiciméad XML, bíonn tionchar aige Comhréir XML agus XML marcáil.
font-family:NAMESainmhínigh cló-teaghlach le haghaidh seiceálacha rindreála, féach Clónna a bhainistiú.
font-weight:WEIGHTSainmhínigh meáchan cló le haghaidh seiceálacha rindreála, féach Clónna a bhainistiú.
font-size:SIZESainmhínigh clómhéid le haghaidh seiceálacha rindreála, féach Clónna a bhainistiú.
font-spacing:SPACINGSainmhínigh spásáil litreacha le haghaidh seiceálacha rindreála, féach Clónna a bhainistiú.
icu-flags:FLAGSSainmhínigh bratacha chun iompar an seiceála cáilíochta Formáid Teachtaireacht ICU a shaincheapadh.
icu-tag-prefix:PREFIXSocraigh 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áin nó Fad 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:SOURCEMarcáil an teaghrán seo mar leagan de shreang le foinse meaitseála. Féach Leaganacha teaghrán.
regex:REGEXSlonn rialta chun an t-aistriúchán a mheaitseáil, féach Léiriú rialta.
discard:NAMEBratach a chur i leataobh ar leibhéal níos airde.
forbiddenLéiríonn sé aistriúchán toirmiscthe i ngluaiseacht, féach Aistriúcháin toirmiscthe.
strict-sameLig duit Aistriúchán gan athrú liosta dubh inmheánach a sheachaint.
strict-formatDé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-glossaryCumasaigh an seiceáil cáilíochta Ní leanann gluais.
angularjs-formatCumasaigh an seiceáil cáilíochta Teaghrán idirshuíomh AngularJS.
c-formatCumasaigh an seiceáil cáilíochta Formáid C.
c-sharp-formatCumasaigh seiceáil cáilíochta Formáid C#.
es-formatCumasaigh an seiceáil cáilíochta Teimpléad ECMAScript litreach.
i18next-interpolationCumasaigh seiceáil cáilíochta i18 chéad idirshuíomh eile.
icu-message-formatCumasaigh an seiceáil cáilíochta Formáid Teachtaireacht ICU.
java-printf-formatCumasaigh an seiceáil cáilíochta Formáid Java.
java-formatCumasaigh seiceáil cáilíochta Formáid Teachtaireacht Java.
javascript-formatCumasaigh an seiceáil cáilíochta Formáid javascript.
lua-formatCumasaigh an seiceáil cáilíochta Formáid Lua.
object-pascal-formatCumasaigh seiceáil cáilíochta Formáid Pascal saor in aisce,.
percent-placeholdersCumasaigh seiceáil cáilíochta Céatadán sealbhóirí áitribh.
perl-brace-formatCumasaigh an seiceáil cáilíochta Formáid perl brace.
perl-formatCumasaigh an seiceáil cáilíochta Formáid Perl.
php-formatCumasaigh an seiceáil cáilíochta Formáid PHP.
python-brace-formatCumasaigh an seiceáil cáilíochta Formáid brace python.
python-formatCumasaigh seiceáil cáilíochta Formáid Python.
qt-formatCumasaigh an seiceáil cáilíochta Formáid Qt.
qt-plural-formatCumasaigh an seiceáil cáilíochta Qt formáid iolra.
ruby-formatCumasaigh an seiceáil cáilíochta Formáid Ruby.
scheme-formatCumasaigh an seiceáil cáilíochta Formáid scéime.
vue-formatCumasaigh an seiceáil cáilíochta Formáidiú Vue I18n.
md-textDé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-insensitiveCoigeartaigh iompar seiceálacha le bheith neamh-íogair. Faoi láthair bíonn tionchar ag seiceáil cáilíochta Áitsealbhóirí amháin.
safe-htmlCumasaigh an seiceáil cáilíochta HTML neamhshábháilte.
urlNíor chóir go mbeadh ach URL ar an sreang. Cumasaigh an seiceáil cáilíochta URL.
ignore-all-checksDéan neamhaird de gach seiceáil cáilíochta.
fluent-source-inner-htmlCumasaigh an seiceáil cáilíochta HTML inmheánach foinse líofa.
fluent-source-syntaxCumasaigh an seiceáil cáilíochta Comhréir foinse líofa.
icu-message-formatCumasaigh an seiceáil cáilíochta Comhréir ICU MessageFormat.
ignore-bbcodeScipeáil an seiceáil cáilíochta Marcáil BBCode.
ignore-duplicateScipeáil an seiceáil cáilíochta Focail dúblacha as a chéile.
ignore-check-glossaryScipeáil an seiceáil cáilíochta Ní leanann gluais.
ignore-double-spaceScipeáil an seiceáil cáilíochta Spás dúbailte.
ignore-fluent-partsScipeáil an seiceáil cáilíochta Páirteanna líofa.
ignore-fluent-referencesScipeáil an seiceáil cáilíochta Tagairtí líofa.
ignore-fluent-target-inner-htmlScipeáil an seiceáil cáilíochta HTML inmheánach aistriúchán líofa.
ignore-fluent-target-syntaxScipeáil an seiceáil cáilíochta Comhréir aistriúcháin líofa.
ignore-angularjs-formatScipeáil ar an seiceáil cáilíochta Teaghrán idirshuíomh AngularJS.
ignore-automattic-components-formatSeachain an seiceáil cáilíochta Formáidiú comhpháirteanna uathoibríocha.
ignore-c-formatScipeáil an seiceáil cáilíochta Formáid C.
ignore-c-sharp-formatScipeáil an seiceáil cáilíochta Formáid C#.
ignore-es-formatScipeáil an seiceáil cáilíochta Teimpléad ECMAScript litreach.
ignore-i18next-interpolationScipeáil an seiceáil cáilíochta i18 chéad idirshuíomh eile.
ignore-icu-message-formatScipeáil ar an seiceáil cáilíochta Formáid Teachtaireacht ICU.
ignore-java-printf-formatScipeáil ar an seiceáil cáilíochta Formáid Java.
ignore-java-formatScipeáil an seiceáil cáilíochta Formáid Teachtaireacht Java.
ignore-javascript-formatScipeáil an seiceáil cáilíochta Formáid javascript.
ignore-lua-formatScipeáil an seiceáil cáilíochta Formáid Lua.
ignore-object-pascal-formatScipeáil an seiceáil cáilíochta Formáid Pascal saor in aisce,.
ignore-percent-placeholdersScipeáil an seiceáil cáilíochta Céatadán sealbhóirí áitribh.
ignore-perl-brace-formatScipeáil ar an seiceáil cáilíochta Formáid perl brace.
ignore-perl-formatScipeáil an seiceáil cáilíochta Formáid Perl.
ignore-php-formatScipeáil ar an Formáid PHP seiceáil cáilíochta.
ignore-python-brace-formatScipeáil an seiceáil cáilíochta Formáid brace python.
ignore-python-formatScipeáil an seiceáil cáilíochta Formáid Python.
ignore-qt-formatScipeáil an seiceáil cáilíochta Formáid Qt.
ignore-qt-plural-formatScipeáil ar an seiceáil cáilíochta Qt formáid iolra.
ignore-ruby-formatScipeáil an seiceáil cáilíochta Formáid Ruby.
ignore-scheme-formatScipeáil an seiceáil cáilíochta Formáid scéime.
ignore-vue-formatScipeáil an seiceáil cáilíochta Formáidiú Vue I18n.
ignore-translatedScipeáil an seiceáil cáilíochta Aistríodh.
ignore-inconsistentScipeáil ar an Neamh-chomhsheasmhach seiceáil cáilíochta.
ignore-rst-referencesScipeáil an seiceáil cáilíochta Téacs Athstruchtúrtha Neamhréireach.
ignore-kashidaScipeáil an seiceáil cáilíochta Litir Kashida a úsáideadh.
ignore-md-linkScipeáil ar an naisc Markdown seiceáil cáilíochta.
ignore-md-reflinkScipeáil ar an Tagairtí Markdown seiceáil cáilíochta.
ignore-md-syntaxScipeáil ar an Comhréir Markdown seiceáil cáilíochta.
ignore-max-lengthScipeáil an seiceáil cáilíochta Fad uasta an aistriúcháin.
ignore-max-sizeScipeáil an seiceáil cáilíochta Uasmhéid an aistriúcháin.
ignore-escaped-newlineScipeáil an seiceáil cáilíochta Mímheaitseáilte \n.
ignore-end-colonScipeáil an seiceáil cáilíochta colon mímheaitseála.
ignore-end-ellipsisScipeáil an seiceáil cáilíochta Éipideas mímheaitseála.
ignore-end-exclamationScipeáil an seiceáil cáilíochta Comhartha exclamation mímheaitseála.
ignore-end-stopScipeáil an seiceáil cáilíochta lánstad mí-oiriúnach.
ignore-end-interrobangScipeáil ar an Interrobang mícheart seiceáil cáilíochta.
ignore-end-questionScipeáil ar an Comhartha ceiste mímheaitseála seiceáil cáilíochta.
ignore-end-semicolonScipeáil an seiceáil cáilíochta Leathstad mímheaitseála.
ignore-newline-countScipeáil an seiceáil cáilíochta Briseadh líne mímheaitseála.
ignore-pluralsScipeáil an seiceáil cáilíochta Iolra ar iarraidh.
ignore-kabyle-charactersSeachain an seiceáil cáilíochta Carachtair neamhchaighdeánacha i gCabile.
ignore-placeholdersScipeáil an seiceáil cáilíochta Áitsealbhóirí.
ignore-prohibited-initial-characterScipeáil an seiceáil cáilíochta Toirmiscthe carachtar tosaigh.
ignore-punctuation-spacingScipeáil an seiceáil cáilíochta Spásáil poncaíochta.
ignore-regexScipeáil an seiceáil cáilíochta Léiriú rialta.
ignore-rst-syntaxScipeáil ar an Earráid chomhréire reStructuredText seiceáil cáilíochta.
ignore-reusedScipeáil an seiceáil cáilíochta Aistriúchán athúsáidte.
ignore-same-pluralsScipeáil an seiceáil cáilíochta Na foirmeacha iolra céanna.
ignore-begin-newlineScipeáil an seiceáil cáilíochta Líne nua a thosú.
ignore-begin-spaceScipeáil an seiceáil cáilíochta Spásanna tosaithe.
ignore-end-newlineScipeáil an seiceáil cáilíochta Líne nua á lorg.
ignore-end-spaceScipeáil an seiceáil cáilíochta Spás leantóir.
ignore-sameScipeáil an seiceáil cáilíochta Aistriúchán gan athrú.
ignore-safe-htmlLéim ar an HTML neamhshábháilte seiceáil cáilíochta.
ignore-urlScipeáil an seiceáil cáilíochta URL.
ignore-xml-tagsScipeáil an seiceáil cáilíochta XML marcáil.
ignore-xml-invalidScipeáil an seiceáil cáilíochta Comhréir XML.
ignore-zero-width-spaceScipeáil an seiceáil cáilíochta Spás nialasach.
ignore-ellipsisScipeáil an seiceáil cáilíochta Éilips.
ignore-fluent-source-inner-htmlScipeáil an seiceáil cáilíochta HTML inmheánach foinse líofa.
ignore-fluent-source-syntaxScipeáil an seiceáil cáilíochta Comhréir foinse líofa.
ignore-icu-message-formatScipeáil ar an Comhréir ICU MessageFormat seiceáil cáilíochta.
ignore-long-untranslatedScipeáil an seiceáil cáilíochta Fada gan aistriúchán.
ignore-multiple-failuresScaipeáil an seiceáil cáilíochta Seiceálacha teip iolracha.
ignore-unnamed-formatScipeáil an seiceáil cáilíochta Athróga iolracha gan ainm.
ignore-optional-pluralScipeá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).
Bratacha bunaithe ar shuíomh¶
Cuirtear roinnt bratacha le teaghráin de réir réamhshocraithe, bunaithe ar a suíomhanna. Ciallaíonn sé seo go gcuirfear seiceálacha áirithe ar siúl go huathoibríoch ag brath ar an áit a n-úsáidtear an teaghrán.
rst-text: Cuirtear an bhratach seo go huathoibríoch le teaghráin i gcomhaid reStructuredText, más é.rstan síneadh suímh.md-text: Cuirtear an bhratach seo go huathoibríoch le teaghráin i gcomhaid Markdown, más é.mdnó.markdownan síneadh suímh.
Seiceálacha a fhorfheidhmiú¶
Ní féidir na seiceálacha forfheidhmithe a dhíbhe agus an teaghrán a mharcáil mar Needs editing (féach Stáit aistriúcháin). Cuireann sé seo cosc ar aistritheoirí seiceálacha den sórt sin a cheilt.
Hint
Ní chuireann forfheidhmiú seiceála ar siúl é ar siúl go huathoibríoch. Caithfear roinnt seiceálacha a chasadh air tríd an mbratach chomhfhreagrach a chur leis na bratacha teaghráin nó comhpháirte.
Is fearr é seo a úsáid le seiceálacha a d’fhéadfadh fadhbanna tromchúiseacha a chruthú nuair a úsáidtear iad cosúil le seiceálacha le haghaidh Teaghráin formáidithe. Ní mholtar seiceálacha stíl cosúil le Aistriúchán gan athrú a úsáid mar is cur chuige réasúnta é a dhíbhe uaireanta sna seiceálacha seo.
Is féidir an Polasaí Tiomnais a úsáid ansin chun teaghráin a bhfuil eagarthóireacht le déanamh orthu a eisiamh ó bheith á gcur i bhfeidhm sa rialú leagain.
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).
Cuireann uirlis bainistíochta clónna Weblate i Fonts faoin roghchlár Operations de do thionscadal aistriúcháin comhéadan ar fáil chun clónna a uaslódáil agus a bhainistiú. Is féidir clónna TrueType nó OpenType a uaslódáil, grúpaí clónna a bhunú agus iad sin a úsáid sa tseiceáil.
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:
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:
Aithnítear cló-teaghlach agus stíl go huathoibríoch tar éis iad a uaslódáil:
Is féidir leat roinnt clónna a lódáil isteach i Weblate:
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:5Sainmhí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:ubuntuSainmhíníonn grúpa cló le húsáid trína aitheantóir a shonrú.
font-size:22Sainmhí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.
Fo-aicme an weblate.checks.Check
Socraigh cúpla tréithe.
Cuir an
seiceáili bhfeidhm (má tá tú ag iarraidh déileáil leis na hiolra i do chód) nó an modhcheck_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, moltaí uathoibríocha agus ceartúcháin uathoibríocha.
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.
"""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.
"""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