Breiseáin

Cuireann breiseáin bealaí ar fáil chun an sreabhadh oibre aistriúcháin a shaincheapadh agus a uathoibriú. Is féidir le riarthóirí breiseáin a chur leis agus a bhainistiú ón roghchlár Operations ↓ Add-ons de gach tionscadal nó comhpháirt aistriúcháin faoi seach. Is féidir breiseáin a shuiteáil ar fud an tsuímh i Comhéadan bainistíochta freisin.

Hint

Is féidir leat breiseáin a chumrú freisin le API, DEFAULT_ADDONS, nó install_addon.

Is féidir breiseáin a roghnaíonn spreagadh de láimh a rith ó bhainistíocht breiseán nó trí úsáid a bhaint as API. Déantar na torthaí a thaifeadadh i log gníomhaíochta na mbreiseán.

Add-ons that expose a component API show its base URL on the add-on's API tab, alongside a link to the API root.

Add-ons can show Integration instructions above their settings. These explain how to connect your application or service to the add-on. Add-ons without configurable settings, such as Comhaid aistriúcháin CDN, show instructions without a settings form. Generated URLs and integration snippets are available after installation.

Add-ons are persistent administrative configuration. They run with their service identity in the scope where they are installed, rather than repeatedly using the permissions of the administrator who configured them. This ensures that equally authorized administrators see and save the same configuration, and that saving an unrelated change does not silently alter the add-on's input scope. Removing or disabling the configuring administrator does not disable the add-on.

Project and category add-ons therefore include compatible restricted components in that scope. A component add-on can use inputs outside its destination component when documented by that add-on. Automatic translation determines its source components as follows:

  • Direct automatic-translation actions use the acting user's component access.

  • A saved automatic-translation add-on uses its persistent administrative scope. Compatible components in the target project are eligible, including restricted components.

  • Components in another project are eligible when that project contributes to shared translation memory. This includes restricted components even though they do not create shared translation-memory entries; the add-on reads the explicitly selected component as an administrative input instead.

Restricted components remain filtered from ordinary listings and direct access for users without an explicit grant or Edit project settings permission. Grant add-on management permissions only to users trusted with the add-on's complete input and effect scope. See Scóip na bhfoirne and Rochtain shrianta.

Repository add-ons, including Fionnachtain Comhpháirte, can be installed only on the component that owns the repository. Linked components show installed repository add-ons as inherited. Their available add-on list links to the owning component's add-ons when you can manage it; otherwise the entry is unavailable.

../_images/addons.webp

Imeachtaí a spreagann breiseáin

Suiteáil breiseán

Spreagtha nuair atá an breiseán á shuiteáil.

Nuashonrú comhpháirte

Spreagtar aon uair a tharlaíonn athrú i gcomhpháirt mar:

  • Athraítear teaghráin sa stór.

  • Cuirtear sreang leis.

  • Cuirtear aistriúchán nua leis.

Laethúil

Spreagtar iad go laethúil, ach de ghnáth scoilteann breiseáin an t-ualach laethúil idir comhpháirteanna ag brath ar BACKGROUND_TASKS.

Athrú imeachta

Cuirtear i ngníomh tar éis teagmhas Athraithe a chruthú.

Truicear láimhe

Cuirtear i ngníomh nuair a ritheann breiseán de láimh ó bhainistíocht breiseán nó ón API.

Iarchur leis an stóras

Spreagtha díreach tar éis an t-aistriúchán nua a chur leis agus geallta.

Iarchoimisiún stóras

Spreagtha díreach tar éis na hathruithe a bheith geallta.

Stóras iar-bhrú

Spreagtha díreach tar éis an stóras a bhrú suas an sruth.

Iar-bhaint an stórais

Cuirtear i ngníomh díreach tar éis aistriúchán a bhaint.

Iar-nuashonrú an stóras

Spreagtar iad nuair a tharraingítear athruithe nua ón stóras in aghaidh an tsrutha.

Réamhthiomantas stóras

Spreagtha díreach sula ndéantar na hathruithe.

Stóras réamh-bhrú

Spreagtha díreach sula gcuirtear an stóras in aghaidh an tsrutha.

Réamh-nuashonrú ar an stóras

Spreagtha díreach sula ndéantar iarracht an stóras a nuashonrú.

Aonad iar-shábháil

Spreagtha díreach tar éis an teaghrán a shábháil.

Iar-shioncrónú aonaid

Cuirtear i ngníomh tar éis an teaghrán a shioncrónú leis an VCS.

Aonad réamh-chruthú

Spreagtha díreach tar éis an teaghrán nuachruthaithe a shábháil.

Breiseáin ionsuite

Meastóireacht cáilíochta AI

Aitheantas an bhreiseáin:

weblate.ai.quality

Cumraíocht:

service

Seirbhís mheasúnaithe

Roghanna atá ar fáil:

anthropic

Anthropic

openai

Oscail AI

mistral

Mistral

ollama

Ollama

azure-openai

Azure OpenAI

q

Cheist

interval

Minicíocht na meastóireachta

Roghanna atá ar fáil:

disabled

Díchumasaithe

daily

Laethúil

weekly

Seachtainiúil

monthly

Míosúil

on_change

Déan measúnú ar athruithe aistriúcháin

on_update

Déan measúnú ar nuashonruithe an stórais

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte, Laethúil, Athrú imeachta, Truicear láimhe

Déanann sé meastóireacht ar aistriúcháin atá ann cheana féin ag baint úsáide as LLM agus taifeadann sé seiceálacha cáilíochta.

This add-on evaluates existing translations using an LLM service configured under Moltaí uathoibríocha. It does not generate suggestions or change translations. Choose an Evaluation service from the configured LLM services; credentials and project overrides are reused.

The Query selects strings using the normal search syntax. By default, translated strings are selected. Source strings, read-only strings, and glossary entries are excluded. Each request includes all translation plural forms, source text, language information, string context, glossary terms, placeholders, and configured translation instructions. This data is sent to the selected provider.

Requests group strings from the same translation in file order, using the service's automatic translation batch size (currently 20 strings for built-in LLM services). All plural forms of a string stay together. Related strings share context, allowing the evaluator to check meaning and terminology across the batch. Batching reduces the number of provider requests for scheduled, manual, and change-triggered runs; it does not skip unchanged strings.

Evaluation frequency defaults to weekly. Daily and monthly schedules are also available; disabled turns off scheduled evaluation. Background processing must be enabled. A successful full run starts the next interval. Manual runs bypass the interval. Enable Evaluate translation changes or Evaluate repository updates to additionally evaluate after those events. Installation does not immediately contact the provider. Each run can incur provider costs, including reevaluation of unchanged translations.

Evaluation runs in background tasks, with results and failure counts recorded in the existing add-on activity log. Failed requests retain existing valid findings and are tried again only by a subsequent run. Evaluation shares the service's automatic translation cooldown: rate-limit responses activate it, and batches are skipped while it is active. More specific installations take precedence: component, nearest category, project, then site-wide.

Findings appear as standard checks for accuracy, fluency, terminology, style, and formatting. Each finding includes a minor, major, or critical severity and an explanation. Multiple findings in one category share a check, so ignoring that check ignores the whole category for the string. Existing search filters and API search work, for example check:ai_accuracy. Translation flags such as ignore-ai-accuracy disable a category; ignore-all-checks disables all checks.

Changing the source or translation removes outdated findings. Results received after any source or translation in their batch changes are discarded for the whole batch. A failed or malformed response also leaves existing findings for the whole batch unchanged; other batches can still complete. Incomplete runs do not advance the scheduled evaluation date. Reevaluation of unchanged content preserves ignored categories, and a successful evaluation removes categories that no longer have findings. Removing or reconfiguring the add-on clears its findings. Evaluator metadata is internal and cannot be edited through the API; the add-on configuration uses the existing Breiseáin permissions and validation.

Uathoibriú

Added in version 2026.10.

Aitheantas an bhreiseáin:

weblate.automation.automation

Cumraíocht:

workflow

Sreabhadh oibre

Cuir isteach sainmhíniú uathoibrithe i bhformáid YAML nó JSON.

Truicear:

Nuashonrú comhpháirte, Laethúil, Athrú imeachta, Truicear láimhe, Iarchoimisiún stóras, Stóras iar-bhrú, Iar-nuashonrú an stóras

Ritheann sé oibríochtaí aistriúcháin ordaithe ina bhfuil coinníollacha agus brainsí.

Install this add-on on a component, category, project, or site. Inherited instances run separately for each component. Multiple instances can be installed. Configuring, previewing, and running an automation requires the usual add-on management permission. Saving its configuration does not execute it.

Enter YAML or JSON in Workflow. Use Preview without changes to validate it and inspect planned actions, then Run now for real execution. Results appear in the add-on activity log.

See also

Aistriúchán uathoibríoch

Aitheantas an bhreiseáin:

weblate.autotranslate.autotranslate

Cumraíocht:

mode

Modh aistriúcháin uathoibríoch

Roghanna atá ar fáil:

suggest

Cuir leis mar mholadh

translate

Cuir leis mar aistriúchán

fuzzy

Cuir leis mar "Eagarthóireacht de dhíth"

approved

Cuir leis mar aistriúchán ceadaithe

q

Cheist

Tabhair faoi deara le do thoil go gcaithfí na haistriúcháin go léir atá ann cheana féin agus tú ag aistriú gach teaghrán.

auto_source

Foinse aistriúcháin uathoibrithe

Roghanna atá ar fáil:

others

Comhpháirteanna aistriúcháin eile

mt

Aistriúchán meaisín

component

Comhpháirt

Enter a source component ID. With 30 or more eligible source components, a project/component path is also accepted. In that case, component and project operations also accept a component slug from the target project. Leave blank to use eligible components from each target component's project.

engines

Seirbhísí aistriúcháin

Seirbhísí aistriúcháin

threshold

Tairseach scóir

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte, Laethúil, Athrú imeachta

Aistrítear teaghráin go huathoibríoch ag baint úsáide as aistriúchán meaisín nó comhpháirteanna eile.

To control translation order, use the Uathoibriú add-on with a separate action for each pass. Follow the Apply translation memory before machine translation cookbook example to apply local translation memory first and send only the remaining strings to a machine translation service. Selecting multiple engines here uses Tosaíocht na seirbhísí meaisínaistriúcháin agus cuimhne aistriúcháin; installation order of separate add-ons does not define an execution sequence.

Logánú JavaScript CDN

Added in version 4.2.

Aitheantas an bhreiseáin:

weblate.cdn.cdnjs

Cumraíocht:

threshold

Tairseach aistriúcháin

An céatadán de theaghráin aistrithe nach mór a bheith i láthair le go gcuirfear aistriúchán san áireamh.

css_selector

Roghnóir CSS

Roghnóir CSS chun eilimintí logánta a bhrath.

cookie_name

Ainm fianán teanga

Ainm an fhianáin a stórálann rogha teanga.

files

Sliocht teaghráin ó chomhaid HTML

Liosta de na comhaid sa stór reatha nó i URLanna cianda le parsáil le haghaidh teaghráin inaistrithe.

Truicear:

Suiteáil breiseán, Laethúil, Iarchoimisiún stóras, Iar-bhaint an stórais, Iar-nuashonrú an stóras

Foilsíonn sé aistriúcháin go líonra seachadta inneachair le húsáid i logánú JavaScript nó HTML.

Is féidir é a úsáid chun leathanaigh HTML statacha a logánú, nó chun logánú a luchtú sa chód JavaScript.

Generates a unique URL for your component you can include in HTML pages to localize them. See HTML agus JavaScript a aistriú ag úsáid Weblate CDN for more details. Available languages and translation files are listed in the CDN manifest.

Note

Éilíonn an breiseán seo cumraíocht bhreise ar an bhfreastalaí Weblate. :setting: Cumraíonn LOCALIZE_CDN_PATH cá scríobhfar comhaid ghintear (ar chóras comhaid), agus LOCALIZE_CDN_URL sainmhíníonn cá háit a sheirbheálfar iad (URL). Ní dhéanann Weblate na comhaid a sheirbheáil agus caithfear iad a chur ar bun go seachtrach (de ghnáth ag baint úsáide as seirbhís CDN).

Tá an breiseán seo cumraithe ar Hosted Weblate agus freastalaíonn sé ar na comhaid trí https://weblate-cdn.com/.

Comhaid aistriúcháin CDN

Added in version 2026.5.

Aitheantas an bhreiseáin:

weblate.cdn.files

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte, Iarchoimisiún stóras, Iar-bhaint an stórais, Iar-nuashonrú an stóras

Foilsíonn sé comhaid aistriúcháin i líonra seachadta ábhair.

Publishes translation files without converting them to another format. Files are written below the add-on specific CDN directory and served from LOCALIZE_CDN_URL/<add-on UUID>/. Single-file translations use the language code and original file extension, for example cs.json or de.po. Multi-file translations are served below the language code using paths relative to the translation directory. Monolingual components include the source language file, while bilingual components publish only target-language files. See Logánú CDN for secure serving guidance. Available languages and translation files are listed in the CDN manifest.

CDN SDK Kotlin

Added in version 2026.10.

Aitheantas an bhreiseáin:

weblate.cdn.kotlin

Cumraíocht:

maximum_age

Uasaois an tiomsaithe (laethanta)

Socraítear aois an déanmhais bunaithe ar an líon laethanta ón gcéad chlárú. Ní chuirtear síneadh le haois an déanmhais má dhéantar é a athchlárú.

maximum_versions

Uaslíon na leaganacha a choinnítear

Cuirtear teorainn le líon na dtógálacha a choinnítear do gach ainm pacáiste. Cuirtear deireadh le tógáil nuair a shroichtear an teorainn seo nó an t-uasaois.

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte, Laethúil, Iarchoimisiún stóras, Iar-bhaint an stórais, Iar-nuashonrú an stóras

Foilsíonn sé acmhainní teaghráin agus iolra Android do thógálacha cláraithe de chuid Kotlin SDK.

Warning

The Kotlin SDK is available as an alpha release. No compatibility is guaranteed until the final Kotlin SDK is released. Endpoints, build metadata, CDN manifests, and generated resource formats may change without backward compatibility.

Install Kotlin SDK CDN on an Android string-resource component to publish translations for builds registered by the Kotlin SDK. Configure LOCALIZE_CDN_URL and LOCALIZE_CDN_PATH first. CDN output is public, including translations from private components. Manifests expose the application package name and version code. ARSC files expose published resource names and their submitted IDs alongside translated text. Do not treat the uploaded resource mapping as confidential; enable publication only when this disclosure is intended. Registration and status API access remains permission-controlled.

Installation offers to install Comhaid aistriúcháin CDN by default so the SDK can also consume the original Android XML files. Existing Translation files CDN installations are reused. For existing Kotlin SDK installations, use Install Translation files CDN on the configuration page, then return to copy the updated Gradle configuration. Original files are also published publicly, including those from private components.

Copy the Gradle plugin configuration from the add-on configuration page. It includes the Weblate server URL, separate translationFiles and kotlinSdk public CDN URLs, project slug, and component path (with any category path URL-encoded). Replace the placeholder with a project-scoped API token whose permissions allow editing the component. Project administrators can create one in the project's API access tab; see Comharthaí rochtana in aghaidh an tionscadail. Keep that token in the build environment, not in the application. The add-on's API tab shows the API base URL; submit build metadata to its builds/ endpoint. See Kotlin SDK builds for the request and response format.

For Gradle plugin and library setup, see Kotlin SDK for Android.

The add-on matches resource names and types from registered builds to current component translations. Strings, plurals, and Android styled text are supported. String arrays and resource references are not generated. Untranslated entries, read-only entries, and incomplete plural resources are omitted; applications retain their bundled values. Unsupported styling fails publication; the previous successful publication remains available.

Resource IDs must describe the final installed build. Uploading an identical mapping again is harmless; a different mapping for the same package and version is rejected. Old builds receive current translations by name, including after source text or formatting arguments change. Maintainers are responsible for compatibility with older application code.

Lifecycle settings

  • Maximum build age (days) defaults to 365 and accepts 1 through 730, measured from the first registration. Repeated uploads do not extend it.

  • Maximum retained versions defaults to 20 and accepts 1 through 100, counted across all package names. One additional unpublished replacement is allowed. New registrations can retire older unpublished replacements. Published builds are retired for this limit only after a replacement is published. Failed replacements preserve existing publications; maximum-age expiry still applies independently.

Either limit retires a build and immediately clears its metadata. Lightweight retired records are deleted on cleanup after 24 hours and successful manifest removal; their package/version identifiers can then be registered again. Failed or interrupted manifest removals are retried hourly. Until removal succeeds, the registration and its referenced artifacts are retained, and the files may remain publicly accessible. Resource mappings are immutable only while their registration records remain.

Each add-on permits at most 1000 registration records, including retired records. New registrations exceeding this limit return HTTP 409 until cleanup frees capacity; identical retries remain accepted. Metadata is bounded by the 5 MiB upload limit and maximum retained version count plus one replacement, without a separate byte quota. Limits are enforced during registration and scheduled cleanup.

Superseded artifacts are deleted on cleanup after a fixed 24-hour window. All artifact files, including superseded files and incomplete publication output, count towards hard limits of 5 GiB and 10000 files per add-on. The larger artifact allowance accommodates translated text and multiple locales; it does not guarantee capacity for every locale or build combination. Shared artifacts count only once. Publications exceeding either limit fail before writing new artifacts and preserve the previous manifest. Neither the window nor these limits are configurable. Limit manifest caching as described below.

Compilation stages one locale at a time on disk. A per-locale conservative encoded text and styling estimate exceeding 64 MiB fails publication.

Preparation additionally requires up to 5 GiB of temporary disk space per publication job, separate from the published artifact allowance. Temporary files contain staged ARSC output, shared by versions with identical resource mappings. They are stored below LOCALIZE_CDN_PATH. Configure the server to deny access to .kotlin-sdk-staging as described in Logánú CDN before enabling this add-on.

Manifest replacement follows the database commit. Failed or interrupted writes are retried by subsequent publication jobs, with artifacts for both the old and pending manifest protected until replacement succeeds.

Uninstalling the add-on attempts to remove its published files from the CDN origin immediately. Failed or interrupted removals are retried hourly; files may remain publicly accessible until cleanup succeeds. Removal does not revoke copies already cached or downloaded by clients.

Publication and cleanup run asynchronously after build registration, component updates, translation commits and removals, and during daily add-on processing. Failures appear in the add-on activity log and registration status. Previous successful publications remain available when replacement generation fails. If the component stops using the Android resource format, hourly maintenance retires its publications. The normal artifact retention window still applies.

CDN client contract

Each build has a stable manifest at <CDN base>/<packageName>/<versionCode>/manifest.json. The version 1 manifest contains schemaVersion, packageName, versionCode, and locales. Locale keys are Weblate language codes. Each locale contains a relative url, sha256, and byte size for its ARSC artifact. Resolve relative URLs against the manifest URL. Artifact contents do not change after publication. The manifest has a JSON Schema.

Configure the CDN origin to cache manifests for at most one hour (for example, Cache-Control: public, max-age=3600), and artifact files with Cache-Control: public, max-age=31536000, immutable. Artifact files may use application/octet-stream. Configure these headers on the CDN server. Translation updates and retirements can take up to one hour to reach clients. Use Cache-Control: no-cache when immediate revalidation is preferred. The fixed 24-hour artifact retention window exceeds the manifest cache lifetime.

The Kotlin SDK should validate artifact length and hash, cache successful downloads locally, and load them with Android's resources-loader API on API 30 or newer. A missing manifest, missing locale, or download failure must preserve bundled resources. Retired manifests return 404 at the origin; cached copies can remain usable until they expire. Hashes detect corrupted or mismatched content; authentication relies on HTTPS and the configured CDN.

Bain teaghráin bhána

Added in version 4.4.

Aitheantas an bhreiseáin:

weblate.cleanup.blank

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Iarchoimisiún stóras, Iar-nuashonrú an stóras

Bain teaghráin gan aistriú ó chomhaid aistriúcháin.

Bain úsáid as seo chun nach mbeidh aon teaghráin fholmha i gcomhaid aistriúcháin (mar shampla má thaispeánann do leabharlann logánaithe iad a bheith in easnamh in ionad titim ar ais go dtí an teaghrán foinse).

Glanadh comhaid aistriúcháin

Aitheantas an bhreiseáin:

weblate.cleanup.generic

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Iar-nuashonrú an stóras, Réamhthiomantas stóras

Nuashonraigh gach comhad aistriúcháin chun teacht leis an mbunchomhad aonteangach. Don chuid is mó de na formáidí comhaid, ciallaíonn sé seo go mbaintear seaneochracha aistriúcháin nach bhfuil sa bhunchomhad a thuilleadh.

I gcás formáidí ina bhfuil ábhar breise seachas teaghráin aistriúcháin (amhail Comhaid HTML, Comhaid RC Windows, nó Formáid OpenDocument) tugann sé seo an comhad aistriúcháin ar shioncronú leis an mbunchomhad.

Chun glanadh aonuaire a dhéanamh ar chomhad aistriúcháin aonair, bain úsáid as Cleanup unused in Cothabháil stór ar an aistriúchán sin in ionad an breiseán a shuiteáil.

Cuir teangacha atá in easnamh leis

Aitheantas an bhreiseáin:

weblate.consistency.languages

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Laethúil, Iarchur leis an stóras

Cinntíonn sé go mbaintear úsáid as tacar comhsheasmhach teangacha do gach comhpháirt de thionscadal.

Note

Ní chuirtear na comhpháirteanna a roinntear ó thionscadail eile san áireamh anseo.

Seiceáiltear teangacha ar iarraidh uair amháin gach 24 uair, agus nuair a chuirtear teangacha nua leis in Weblate.

Murab ionann agus formhór na cinn eile, bíonn tionchar ag an mbreiseán seo ar an tionscadal iomlán.

Hint

Uath-aistrigh na teaghráin nua-chur leis le Aistriúchán uathoibríoch.

Fionnachtain Comhpháirte

Aitheantas an bhreiseáin:

weblate.discovery.discovery

Cumraíocht:

File matching

match

slonn rialta chun comhaid aistriúcháin a mheaitseáil le

Caithfidh an slonn rialta grúpa ainmnithe a shainiú don chomhpháirt. Sainigh grúpa ainmnithe don teanga freisin agus comhaid aistriúcháin á meaitseáil. Nuair a bhíonn an masc comhaid socraithe, fág an teanga ar lár agus déan meaitseáil leis an mbunchomhad aonteangach nó leis an mbunchomhad nua ina ionad sin.

file_format

Formáid comhaid

Formáid comhaid

language_regex

Scagaire teanga

Slonn rialta chun comhaid aistriúcháin a scagadh ina choinne agus masc comhaid á scanadh.

Component naming and file templates

name_template

Saincheap ainm an chomhpháirt

Bain úsáid as comhréir teimpléid Django. Ní mór {{ component }} a bheith san áireamh sa teimpléad seo.

base_file_template

Sainmhínigh an bonnainm aonteangach

Fág folamh le haghaidh comhaid aistriúcháin dátheangacha. Nuair a bheidh sé socraithe, ní mór {{ component }} a bheith san áireamh sa teimpléad seo.

new_base_template

Sainmhínigh an bunchomhad le haghaidh aistriúcháin nua

Ainm comhaid an chomhaid a úsáidtear chun aistriúcháin nua a chruthú. Roghnaigh comhad .pot le haghaidh gettext. Caithfidh {{ component }} a bheith sa teimpléad seo.

intermediate_template

Comhad teanga idirmheánach

Ainm comhaid an chomhaid aistriúcháin idirmheánaigh. I bhformhór na gcásanna, is comhad aistriúcháin é seo arna sholáthar ag forbróirí agus úsáidtear é agus teaghráin foinse iarbhír á gcruthú. Ní mór {{ component }} a bheith san áireamh sa teimpléad seo.

filemask_template

Sainmhínigh an masc comhaid

Fág bán é chun comhaid aistriúcháin a mheaitseáil go díreach. Nuair a bhíonn sé socraithe, déanann an próiseas aimse achomharc ar an mbun-chomhad aonteangach nó ar an mbun-chomhad nua, agus úsáidtear an teimpléad seo mar mhasc comhaid. Cuir carachtar fiáin teanga agus {{ component }} san áireamh, mar shampla locale//{{ component }}.po nó docs/{{ component }}_.md.

Component lifecycle

copy_addons

Breiseáin Clón ón bpríomh-chomhpháirt go dtí na cinn nuachruthaithe

remove

Bain comhpháirteanna as comhaid nach bhfuil ann

Truicear:

Suiteáil breiseán, Iar-nuashonrú an stóras

Cuireann nó baintear comhpháirteanna tionscadail go huathoibríoch bunaithe ar athruithe comhaid sa chóras rialaithe leagain.

Déantar an meaitseáil trí úsáid a bhaint as slonnanna rialta a cheadaíonn cumraíocht chasta, ach teastaíonn eolas áirithe chuige sin. De ghnáth, ní mór dhá ghrúpa ainmnithe a bheith sa slonn rialta a úsáidtear chun comhaid aistriúcháin a mheaitseáil — ceann don chomhpháirt agus ceann don teanga. Agus comhpháirteanna á gcruthú ó bhunús aonteangach nó ó chomhad bunúis nua, fág an grúpa teanga ar lár agus déan an comhad foinse sin a mheaitseáil ina ionad sin. Is féidir na grúpaí ainmnithe go léir sa slonn rialta a úsáid mar athróga i réimsí na teimpléad.

Riachtanais fionnachtana

Chun comhpháirt a aimsiú go rathúil, ní mór don chumraíocht na nithe seo a leanas go léir a dhéanamh:

  • Caithfidh an slonn rialta grúpa ainmnithe dar teideal component a shainiú. Chun go meaitseálfaí comhaid aistriúcháin, teastaíonn grúpa ainmnithe dar teideal language freisin.

  • Caithfidh {{ component }} a bheith i réimsí teimpléid a úsáidtear chun comhaid in aghaidh an chomhpháirte a ainmniú nó a aimsiú, ionas go n-athraíonn an luach rindreáilte i ndáiríre do gach comhpháirt a aimsítear.

  • I gcás formáidí aonteangacha, ní mór don chomhpháirt comhad a fhreagraíonn do base_file_template agus ar a laghad comhad aistriúcháin amháin a fhreagraíonn do match a chuimsiú, mura socraíonn tú an masc comhaid (féach thíos).

Comhpháirteanna a aimsiú gan comhaid aistriúcháin

Socraigh Sainmhínigh an masc comhaid chun comhpháirteanna a aimsiú ó bhuncomhad aonteangach nó ó bhuncomhad nua amháin, fiú nuair nach bhfuil aon chomhaid aistriúcháin ann go fóill. Sa mhód sin:

  • Cumraigh Slonn rialta chun comhaid aistriúcháin a mheaitseáil sa chaoi is go meaitseálfaidh sé an bunchomhad aonteangach nó an bunchomhad nua, agus fág an grúpa language ar lár. Coinnigh smacht iomlán ar an ngabháil component, mar shampla locale/(?P<component>[^/]+)\.pot nó docs/(?P<component>[^/_]+)\.md.

  • Líon an réimse Sainmhínigh an masc comhaid le cosán ina bhfuil cárta fiáin teanga agus {{ component }} araon, mar shampla locale/*/{{ component }}.po nó docs/{{ component }}_*.md.

  • Lean ort ag úsáid na dteimpléad ainm comhaid eile le haon ghrúpaí ainmnithe ón slonn meaitseála.

Sampla oibre: news_<lang>.md

Seo leagan amach coitianta teanga atá bunaithe ar ainm comhaid:

  • docs/news_en.md

  • docs/news_cs.md

  • docs/guide_en.md

Bain úsáid as an réamhshocrú File-name-based language variants mar phointe tosaigh, ansin roghnaigh an fhormáid comhaid chomhoiriúnach agus athbhreithnigh na luachanna atá líonta isteach.

slonn rialta:

(?:(?P<path>.*/))?(?P<component>.+?)_(?P<language>[A-Za-z]{2,3}(?:[_-][A-Za-z0-9]+)*)\.(?P<extension>[^/.]+)

Ainm na Comhpháirte:

{{ component }}

Maisc chomhaid a aimsíodh:
  • docs/news_*.md

  • docs/guide_*.md

Sa sampla seo, réitíonn {{ component }} go dtí an bunainm roimh iarmhír na teanga, mar sin bíonn docs/news_en.md, docs/news_pt_BR.md, agus docs/news_pt-BR.md ina gcomhpháirt news.

Is féidir leat marcáil teimpléad Django a úsáid i ngach réimse ainm comhaid, mar shampla:

{{ component }}

Ainm an chomhpháirte parsáilte ón ngrúpa meaitseála component

{{ component|title }}

Comhainm comhpháirte agus an chéad litir sa chás uachtair

{{ path }}: {{ component }}

Grúpa cluiche saincheaptha ón slonn rialta

Nuair a bhuaileann tú Sábháil, cuirfear i láthair réamhamharc ar na comhpháirteanna meaitseála, áit ar féidir leat a sheiceáil cibé an bhfuil an chumraíocht ag teacht le do chuid riachtanas:

../_images/addon-discovery.webp

Samplaí fionnachtana Comhpháirte

Clúdaíonn an sampla thuas an leagan amach malairte is coitianta atá bunaithe ar ainm comhaid. Taispeánann na samplaí seo a leanas struchtúir stórtha eile ar féidir leat a mheaitseáil.

Fillteán amháin in aghaidh na teanga

Fillteán amháin in aghaidh na teanga ina bhfuil comhaid aistriúcháin le haghaidh comhpháirteanna.

slonn rialta:

(?P<language>[^/.]*)/(?P<component>[^/]*)\.po

Comhaid a mheaitseálann:
  • cs/application.po

  • cs/website.po

  • de/application.po

  • de/website.po

Leagan amach locales Gettext

Struchtúr is gnách chun comhaid PO gettext a stóráil.

slonn rialta:

locale/(?P<language>[^/.]*)/LC_MESSAGES/(?P<component>[^/]*)\.po

Comhaid a mheaitseálann:
  • locale/cs/LC_MESSAGES/application.po

  • locale/cs/LC_MESSAGES/website.po

  • locale/de/LC_MESSAGES/application.po

  • locale/de/LC_MESSAGES/website.po

Ainmneacha comhaid casta

Ag baint úsáide as ainm comhpháirte agus teanga laistigh d'ainm an chomhaid.

slonn rialta:

src/locale/(?P<component>[^/]*)\.(?P<language>[^/.]*)\.po

Comhaid a mheaitseálann:
  • src/locale/application.cs.po

  • src/locale/website.cs.po

  • src/locale/application.de.po

  • src/locale/website.de.po

Cód teanga arís agus arís eile

Teanga in úsáid sa chonair agus san ainm comhaid.

slonn rialta:

locale/(?P<language>[^/.]*)/(?P<component>[^/]*)/(?P=language)\.po

Comhaid a mheaitseálann:
  • locale/cs/application/cs.po

  • locale/cs/website/cs.po

  • locale/de/application/de.po

  • locale/de/website/de.po

Scoilt teaghráin Android

Teaghráin acmhainní Android, roinnte i roinnt comhaid.

slonn rialta:

res/values-(?P<language>[^/.]*)/strings-(?P<component>[^/]*)\.xml

Comhaid a mheaitseálann:
  • res/values-cs/strings-about.xml

  • res/values-cs/strings-help.xml

  • res/values-de/strings-about.xml

  • res/values-de/strings-help.xml

Cosáin iolracha a mheaitseáil

Tionscadal Maven Il-modúl le haistriúcháin airíonna Java....

slonn rialta:

(?P<originalHierarchy>.+/)(?P<component>[^/]*)/src/main/resources/ApplicationResources_(?P<language>[^/.]*)\.properties

Ainm na Comhpháirte:

{{ originalHierarchy }}: {{ component }}

Comhaid a mheaitseálann:
  • parent/module1/submodule/src/main/resources/ApplicationResources_fr.properties

  • parent/module1/submodule/src/main/resources/ApplicationResource_es.properties

  • parent/module2/src/main/resources/ApplicationResource_de.properties

  • parent/module2/src/main/resources/ApplicationResource_ro.properties

Hint

Úsáideann breiseán fionnachtana comhpháirteanna URLanna inmheánacha an Ghréasáin. Is bealach áisiúil é chun socrú VCS a roinnt idir ilchodanna. Úsáideann comhpháirteanna nasctha stór áitiúil an phríomh-chomhpháirte atá socraithe trí weblate://project/main-component a líonadh isteach sa réimse Stór cód foinse (i Operations ↓ Settings ↓ Version control system) de gach comhpháirt faoi seach. Sábhálann sé seo am le cumraíocht agus acmhainní córais freisin.

Hint

Cinntigh go bhfuil an tacar iomlán teangacha inaistrithe sa chomhpháirt nua le Cuir teangacha atá in easnamh leis.

Teachtaireachtaí Fedora

Added in version 5.15.

Aitheantas an bhreiseáin:

weblate.fedora_messaging.publish

Cumraíocht:

Broker connection

amqp_url

URL bróicéir AMQP

URL an bhróicéara AMQP le ceangal leis.

topic_prefix

Réimír na topaice

Réimír roghnach le cur le topaicí teachtaireachtaí ginte.

Timeouts and retries

connection_timeout

Teorainn ama don nasc

Cé mhéad soicind ba chóir a cheadú don nascadh agus do shocrú an chainéil in aghaidh an iarrachta.

publish_timeout

Am críochnaithe foilsitheoireachta

Cé mhéad soicind atá le ceadú le haghaidh seolta agus admháil seachadta an bhróicéara in aghaidh gach iarrachta, tar éis socrú nasc.

connection_attempts

Iarrachtaí ceangail

Cé mhéad uair is ceart iarracht a dhéanamh ceangal leis an mbróicéir.

retry_delay

Moill athiarrachta

Cé mhéad soicind le fanacht idir iarrachtaí ceangail.

TLS credentials

ca_cert

Pacáiste deimhnithe CA (PEM)

Greamaigh bloic teastais PEM amháin, gach ceann acu ag tosú le "-----BEGIN CERTIFICATE-----" agus ag críochnú le "-----END CERTIFICATE-----".

client_key

Eochair phríobháideach an chliaint (PEM)

Greamaigh bloc eochrach príobháideach PEM neamhchriptithe amháin. Ní thacaítear le heochracha príobháideacha criptithe.

client_cert

Teastas cliant (PEM)

Greamaigh an bloc deimhnithe PEM amháin ag tosú le "-----BEGIN CERTIFICATE-----"; ná greamaigh an t-aschur ó "openssl x509 -text".

Event selection

event_filter

Athraigh imeachtaí le spreagadh

Roghnaigh cé na himeachtaí athraithe ba chóir a chur i ngníomh an breiseáin seo. Athraigh imeachtaí le spreagadh

events

Imeachtaí athraithe roghnaithe

Imeachtaí athraithe roghnaithe

Truicear:

Athrú imeachta

Seolann sé fógraí chuig malartán AMQP atá comhoiriúnach le Fedora Messaging.

Is foilsitheoir é Fedora Messaging atá bunaithe ar AMQP maidir le gach athrú a tharlaíonn ar Weblate. Is féidir leat seirbhísí breise a chuimsiú ar athruithe atá ag tarlú ar Weblate agus é seo á úsáid agat.

Configure the broker with a plain amqp:// or amqps:// URL, including its virtual host. URL query strings and fragments are not supported. Use the add-on's connection attempts, retry delay, and timeout fields instead. Each connection attempt has separate connection and publish timeouts. The connection timeout covers DNS resolution, TCP and TLS connection establishment, AMQP authentication, channel opening, and publisher-confirm negotiation. The publish timeout starts when the connection is ready and covers sending the message and waiting for broker confirmation. Both timeouts default to five seconds. Previously, the publish timeout covered the entire operation.

Each configured retry receives fresh timeout budgets, with the retry delay between attempts. The maximum socket-operation and retry-delay time is connection_attempts * (connection_timeout + publish_timeout) + (connection_attempts - 1) * retry_delay.

Publishing resolves DNS when opening a connection and reuses the existing connection without further DNS lookups. Resolved addresses and the connected peer are checked against the configured private-network restrictions. Synchronous DNS resolution cannot be interrupted by the connection timeout and can exceed it when the system resolver is slow or unavailable. Rejected messages are not retried.

Weblate reuses a publisher connection in each worker process, with AMQP heartbeats disabled. A stale connection detected before sending is replaced once within the same connection timeout, even with only one configured attempt. Other failed connections are discarded and recreated on the next configured attempt. A write failure or lost broker confirmation can cause duplicate delivery; consumers can identify retries by their unchanged message ID.

Ábhar an teachtaireachta

Tá topaic weblate.<action>.<project>.<category...>.<component>.<translation> ag gach teachtaireacht. Nuair a bhíonn sé cumraithe, cuirtear topic_prefix leis an topaic seo ag baint úsáide as deighilteoir ponc aonair, mar shampla org.fedoraproject.weblate.project_backed_up.website. Is léiriú téacsúil beag den ghníomh an gníomh le fo-línte in ionad spáis, mar shampla resource_updated; féach Imeachtaí athraithe roghnaithe le haghaidh gach aitheantóir gníomhaíochta. Meaitseálann na codanna atá fágtha de dheighleoga conaire réada Weblate.

Mar shampla, úsáideann imeacht cúltaca tionscadail don tionscadal website weblate.project_backed_up.website. Úsáideann athrú aistriúcháin sa tionscadal website, sa chomhpháirt frontend, agus san aistriúchán Seiceach weblate.translation_changed.website.frontend.cs. Úsáideann an t-athrú céanna sa chomhpháirt frontend laistigh de na catagóirí parent agus child weblate.translation_changed.website.parent.child.frontend.cs.

Corp an teachtaireachta

Tá na réimsí seo a leanas sa chorp (ar choinníoll go bhfuil siad ar fáil don imeacht):

change_id

ID uimhriúil an athraithe

action

Ainm focalach an athraithe.

timestamp

Stampa ama formáidithe ISO

target

Luach nua an athraithe (m.sh. aistriúchán nua ar an teaghrán)

old

Seanluach an athraithe (m.sh. aistriúchán na teaghrán roimhe seo)

source

Teaghrán foinse.

url

URL absalóideach chun an réad gaolmhar a fheiceáil.

author

Ainm úsáideora an údair (is féidir é seo a bheith difriúil ón úsáideoir mar shampla nuair a ghlactar le moltaí)

user

Ainm úsáideora gníomhach

project

Seilide tionscadail

component

Seilide comhpháirte

translation

Cód teanga aistriúcháin

Ceanntásca teachtaireachtaí

Tá ceanntásca breise ann a d'fhéadfá a úsáid le haghaidh ródaithe chomh maith:

action

Ainm focalach an athraithe.

project

Seilide tionscadail

component

Seilide comhpháirte

Teachtaireachtaí samplacha

Imeacht chumasc stórais:

{
  "id": 1,
  "action": "Merged repository",
  "timestamp": "2017-06-15T11:30:47.325000+00:00",
  "url": "http://example.com/projects/test/test/",
  "component": "test"
}

Imeacht teaghrán foinse nua:

{
  "id": 2,
  "action": "New source string",
  "timestamp": "2017-06-15T11:30:47.372000+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Imeacht nuashonraithe acmhainní:

{
  "id": 6,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.410000+00:00",
  "url": "http://example.com/projects/test/test/cs/",
  "project": "test",
  "component": "test",
  "translation": "cs"
}
{
  "id": 7,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.510000+00:00",
  "url": "http://example.com/projects/test/test/de/",
  "project": "test",
  "component": "test",
  "translation": "de"
}
{
  "id": 8,
  "action": "Resource update",
  "timestamp": "2017-06-15T11:30:47.595000+00:00",
  "url": "http://example.com/projects/test/test/it/",
  "project": "test",
  "component": "test",
  "translation": "it"
}

Imeacht bainte tionscadail:

{
  "id": 9,
  "action": "Removed project",
  "timestamp": "2019-10-17T15:57:08.559420+00:00",
  "target": "test",
  "user": "testuser"
}

Imeacht rannpháirtí nua:

{
  "id": 11,
  "action": "New contributor",
  "timestamp": "2019-10-17T15:57:08.759960+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "author": "testuser",
  "user": "testuser",
  "project": "test",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Imeacht aistriúcháin nua:

{
  "id": 12,
  "action": "New translation",
  "timestamp": "2019-10-17T15:57:08.772591+00:00",
  "url": "http://example.com/translate/test/test/cs/?checksum=6412684aaf018e8e",
  "target": ["Ahoj svete!\n"],
  "author": "testuser",
  "user": "testuser",
  "project": "test",
  "component": "test",
  "translation": "cs",
  "source": ["Hello, world!\n"]
}

Bulc eagarthóireacht

Aitheantas an bhreiseáin:

weblate.flags.bulk

Cumraíocht:

q

Cheist

search_type

Cineál cuardaigh

Roghanna atá ar fáil:

text

Téacs

regex

Léiriú rialta

search

Teaghrán cuardaigh

Téacs (ina bhfuil cás na litreach tábhachtach) nó slonn rialta le cur in áit i sreanga meaitseála. Fág folamh é chun an t-athsholáthar a dhíchumasú.

replacement

Teaghrán athsholáthair

Fág folamh é chun an téacs comhoiriúnach a bhaint. I mód na sloigse rialta, bain úsáid as 1 don chéad ghrúpa gafa. Tacaítear freisin le tagairtí do ghrúpaí ainmnithe.

state

Luaigh a shocrú

Roghanna atá ar fáil:

-1

Ná athraigh

0

Folamh

10

Tá eagarthóireacht de dhíth

11

Riachtanas eagarthóireachta (Riachtanas athscríofa)

12

Riachtanas eagarthóireachta (Riachtanas seiceála)

20

Aistrithe

30

Ceadaithe

Source flags

Socraítear bratacha ar na teaghráin fhounse a fhreagraíonn do thorthaí do scagaire, agus baineann siad lena n-aistriúcháin i ngach teanga.

add_flags

Cuir bratacha leis

remove_flags

Bain bratacha

Translation flags

Ní bhaineann bratacha ach le haistriúcháin a mheaitseálann do scagaire. Ní chuirtear teaghráin fhounse san áireamh.

add_translation_flags

Cuir bratacha leis

remove_translation_flags

Bain bratacha

Ní bhaintear ach bratacha atá socraithe go díreach ar na haistriúcháin seo. Fanann bratacha a fuarthas trí oidhreacht i bhfeidhm.

Labels

Baineann lipéid leis na teaghráin fhoinsise a fhreagraíonn do thorthaí do scagaire, agus roinntear iad thar gach teanga.

add_labels

Cuir lipéid leis

remove_labels

Bain lipéid

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte

Cuir téacs, bratacha, lipéid nó stáit teaghrán in eagar ar mórchóir.

Uses the operations described in Bulc eagarthóireacht, including literal or regular expression replacement and clearing translations. Runs process all eligible matching strings without interactive preview. See Eagarthóireacht mhórchóir for replacement syntax and string state values.

Samplaí:

Lipéadaigh teaghráin nua go huathoibríoch

Iarratas cuardaigh

NOT has:label

Labels: Add labels

le déanaí

Marcáil na teaghráin log-athraithe go léite amháin Comhaid meiteashonraí ó App Store a mharcáil

Iarratas cuardaigh

language:en AND key:changelogs/

Translation flags: Add flags

read-only

Teaghráin áirithe a mharcáil inléite amháin

Iarratas cuardaigh

source:r"^\`\`[.a-zA-Z0-9_-]*\`\`$" AGUS language:en

Translation flags: Add flags

read-only

Brataigh aistriúcháin gan athrú mar "Riachtanas athscríofa"

Aitheantas an bhreiseáin:

weblate.flags.same_edit

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Aonad réamh-chruthú

Aon uair a allmhairítear teaghrán nua inaistrithe ón VCS agus go bhfuil sé ag teacht le teaghrán foinse, cuirtear bratach air mar theaghrán a bhfuil gá é a athscríobh i Weblate. Tá sé seo an-úsáideach go háirithe i gcás formáidí comhaid ina bhfuil teaghráin foinse do theaghráin neamhaistrithe.

Hint

B'fhéidir gur mhaith leat an seice Aistriúchán gan athrú a dhaingniú trí bhratach strict-same a chur chuig Bratacha aistriúcháin.

Brataigh teaghráin foinse nua mar "Riachtanas seiceála"

Aitheantas an bhreiseáin:

weblate.flags.source_edit

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Aonad réamh-chruthú

Aon uair a iompórtáiltear teaghrán foinse nua ón VCS, cuirtear bratach air mar rud a bhfuil gá le seiceáil air i Weblate. Ar an mbealach seo is féidir leat teaghráin foinse scríofa ag na forbróirí a scagadh agus a chur in eagar go héasca.

Brataigh aistriúcháin nua mar "Riachtanas athscríofa"

Aitheantas an bhreiseáin:

weblate.flags.target_edit

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Aonad réamh-chruthú

Aon uair a allmhairítear teaghrán nua inaistrithe ón VCS, cuirtear bratach air mar theaghrán a bhfuil gá é a athscríobh i Weblate. Ar an mbealach seo is féidir leat aistriúcháin a chruthaigh na forbróirí a scagadh agus a chur in eagar go héasca.

Brataigh aistriúcháin nuashonraithe ón stór mar "Riachtanas athscríofa"

Aitheantas an bhreiseáin:

weblate.flags.target_repo_update

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Iar-shioncrónú aonaid

Aon uair a athraítear aistriúchán teaghráin ón VCS, cuirtear bratach air mar rud a bhfuil gá é a athscríobh i Weblate. Tá sé seo an-úsáideach go háirithe má bhíonn comhaid aistriúcháin á nuashonrú de láimh nó ag seirbhís sheachtrach go minic.

Líon teaghráin inléite amháin leis an bhfoinse

Added in version 4.18.

Aitheantas an bhreiseáin:

weblate.generate.fill_read_only

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte, Laethúil

Líonann sé aistriúchán teaghráin inléite amháin le teaghrán foinse.

Gineadóir staitisticí

Aitheantas an bhreiseáin:

weblate.generate.generate

Cumraíocht:

scope

Scóip na n-aschur

Roghanna atá ar fáil:

translation

Comhad amháin in aghaidh an aistriúcháin

component

Comhad amháin in aghaidh an chomhpháirtí

filename

Ainm an chomhaid a cruthaíodh

template

Ábhar an chomhaid a cruthaíodh

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte, Iarchur leis an stóras, Iar-bhaint an stórais, Réamhthiomantas stóras

Gintear comhad ina bhfuil faisnéis mhionsonraithe faoi stádas an aistriúcháin.

Is féidir leat teimpléad Django a úsáid in ainm comhaid agus in ábhar araon, féach Marcáil teimpléad le haghaidh tuairisc mhionsonraithe marcála.

Mar shampla comhad achomair a ghiniúint do gach aistriúchán:

Ainm an chomhaid a cruthaíodh

locale/{{ language_code }}.json

Ábhar
{
   "language": "{{ language_code }}",
   "strings": "{{ stats.all }}",
   "translated": "{{ stats.translated }}",
   "last_changed": "{{ stats.last_changed }}",
   "last_author": "{{ stats.last_author }}",
}

Component-wide output

Set Output scope to One file per component to maintain one locale list or statistics file for the entire component. The default, One file per translation, preserves existing configurations.

Component output is generated on installation and configuration changes. It is updated when translations are committed, languages are added or removed, and component files are reloaded. Language metadata changes are included on the next such update or when the add-on is reconfigured. Unchanged output does not create a new commit.

Both modes support component and project variables in filenames and content. In component mode, the content additionally receives translations, ordered by repository language code. Each item provides:

  • language_code: the language code used in the repository.

  • language_name: the English language name.

  • language_native_name: the name translated into its own language using Weblate's catalogs, with an English fallback when unavailable.

  • language_direction: ltr or rtl.

  • filename and url: the translation filename and Weblate URL.

  • is_source: whether this is the component's source translation.

  • stats: the same statistics available in translation mode.

The source translation is included. Templates can exclude it using {% if not item.is_source %}. Statistics use Weblate's completion semantics. Custom language names are retained; there is no external locale-data lookup.

For example, generate locales.json for a website:

[
{% for item in translations %}
  {
    "code": {{ item.language_code|json }},
    "file": {{ item.filename|json }},
    "name": {{ item.language_native_name|json }},
    "dir": {{ item.language_direction|json }}
  }{% if not forloop.last %},{% endif %}
{% endfor %}
]

Or generate languages.py for an application:

names = {
{% for item in translations %}
    {{ item.language_code|python }}: {{ item.language_native_name|python }},
{% endfor %}
}
completeness = {
{% for item in translations %}
    {{ item.language_code|python }}: {{ item.stats.translated_percent|python }},
{% endfor %}
}

The json and python filters serialize complete values, including string quotes and escaping. Do not add quotes around their output. They also support lists and dictionaries; {{ translations|json }} exports all available data. Dates and times are serialized as ISO-formatted strings.

Réamhlíon an t-aistriúchán leis an bhfoinse

Added in version 4.11.

Aitheantas an bhreiseáin:

weblate.generate.prefill

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte, Laethúil

Líonann sé teaghráin aistriúcháin le teaghrán foinse.

Líonfar gach teaghrán neamhaistrithe sa chomhpháirt leis an teaghrán foinse, agus marcálfar iad mar theaghrán a bhfuil gá le heagarthóireacht orthu. Bain úsáid as seo nuair nach féidir teaghráin folamha a bheith sna comhaid aistriúcháin. .. TOSACH UATHGHINIÚNTA: weblate.generate.pseudolocale .. Gintear an chuid seo go huathoibríoch ag ./manage.py list_addons. Ná déan eagarthóireacht de láimh.

Giniúint pseudolocale

Added in version 4.5.

Aitheantas an bhreiseáin:

weblate.generate.pseudolocale

Cumraíocht:

Source and target

source

Teaghráin foinse

include_readonly

Cuir teaghráin inléite amháin san áireamh

target

Aistriúchán sprice

Déanfar gach teaghrán san aistriúchán seo a fhorscríobh

Prepended text

prefix

Téacs statach curtha roimh

var_prefix

Téacs athrógach curtha roimh

Appended text

suffix

Téacs statach curtha leis

var_suffix

Téacs athraitheach curtha leis

Text expansion

var_multiplier

Iolraitheoir téacs athraitheach

Cé mhéad uair is ceart an téacs athrógach a athdhéanamh ag brath ar fhad an teaghráin foinse.

Truicear:

Suiteáil breiseán, Nuashonrú comhpháirte, Laethúil

Gintear aistriúchán trí réimír agus iarmhír a chur le teaghráin foinse go huathoibríoch.

Tá pseudolocales úsáideach chun teaghráin a aimsiú nach bhfuil ullmhaithe le haghaidh logánú. Déantar é seo trí gach teaghrán foinse inaistrithe a athrú chun go mbeidh sé éasca teaghráin neamhathraithe a fheiceáil agus an feidhmchlár á rith sa teanga pseudolocale.

Is féidir teaghráin a aimsiú nach n-oireann a gcomhghleacaithe áitiúla don leagan amach freisin.

Trí na codanna athraitheacha a úsáid, is féidir teaghráin a lorg nach n-oirfeadh don chomhéadan úsáideora tar éis an logánaithe - síneann sé an téacs bunaithe ar fhad an teaghráin foinse. Déantar na téacsanna athraitheacha a athdhéanamh de réir fhad an téacs iolraithe faoin iolraitheoir. Mar shampla, éiríonn Haigh a dhomhan le téacs athraitheach _ agus iolraitheoir athraitheach de 1 ina Haigh a dhomhan__________ - déantar an téacs a athdhéanamh uair amháin do gach carachtar sa teaghrán foinse.

Ginfear na teaghráin ag baint úsáide as an bpatrún seo a leanas:

Téacs statach curtha leis Téacs athraitheach curtha leis Teaghrán foinse Téacs athraitheach curtha leis Téacs statach curtha leis

Hint

Is féidir leat fíortheangacha a úsáid le haghaidh tástála, ach tá pseudolocales tiomnaithe ar fáil in Weblate - en_XA agus ar_XB.

Hint

Is féidir leat an breiseán seo a úsáid chun aistriúchán go logán nua de theanga atá ann cheana féin nó teanga chomhchosúil a thosú. Nuair a chuireann tú an t-aistriúchán leis an gcomhpháirt, lean ar aghaidh chuig an mbreiseán. Sampla: Má tá fr agat agus gur mhaith leat aistriúchán fr_CA a thosú, níl le déanamh ach fr a shocrú mar fhoinse, fr_CA mar sprioc, agus fág bán an réimír agus an iarmhír.

Díshuiteáil an breiseán nuair a bheidh an t-aistriúchán nua líonta agat chun Weblate a chosc ó na haistriúcháin a rinneadh tar éis na cóipeála a athrú.

Nuashonraigh ALL_LINGUAS athróg sa chomhad "cumraigh"

Aitheantas an bhreiseáin:

weblate.gettext.configure

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Laethúil, Iarchur leis an stóras, Iar-bhaint an stórais

Nuashonraíonn sé an athróg ALL_LINGUAS i gcomhaid "configure", "configure.in" nó "configure.ac", nuair a chuirtear aistriúchán leis nó nuair a bhaintear é.

Nuashonraíonn sé an athróg ALL_LINGUAS i configure, configure.in nó in aon chomhad configure.ac, nuair a chuirtear aistriúchán leis nó nuair a bhaintear é.

Saincheap aschur gettext

Removed in version 5.13: Arna ionadú ag Paraiméadair formáid comhaid.

Nuashonraigh teimpléad gettext (Django)

Added in version 5.17.

Aitheantas an bhreiseáin:

weblate.gettext.django

Cumraíocht:

interval

Minicíocht nuashonraithe

Cé chomh minic ba chóir don bhreiseán an comhad POT a nuashonrú nuair a athnuachantar an chomhpháirt.

Roghanna atá ar fáil:

daily

Laethúil

weekly

Seachtainiúil

monthly

Míosúil

normalize_header

Ceanntásc POT a normalú

Nuashonraíonn sé ceanntásca gettext agus cuireann sé tuairimí POT in ionad na n-áitchoinneálaí.

location_mode

Suíomhanna foinse

Roghnaigh conas a scríobhann eastóscadh suíomhanna foinse chuig an gcomhad POT. Úsáid é seo chun suíomhanna a choinneáil sa teimpléad agus iad a fhágáil ar lár ó chomhaid PO aistrithe.

Roghanna atá ar fáil:

file

Úsáid socruithe formáide comhaid

keep

Sliocht suíomhanna chuig an gcomhad POT

omit

Ná bain amach suíomhanna

Truicear:

Suiteáil breiseán, Truicear láimhe, Iar-nuashonrú an stóras

Nuashonraíonn sé an teimpléad gettext ag baint úsáide as an ordú makemessages atá ionsuite i Django.

Nuashonraíonn an breiseán seo an teimpléad atá cumraithe i Teimpléad le haghaidh aistriúcháin nua. Tá sé ar fáil do chomhpháirteanna gettext PO, agus ní mór don chomhpháirt teimpléad a shainiú le haghaidh aistriúcháin nua.

Baineann an mhinicíocht nuashonraithe roghnaithe le ritheanna uathoibríocha tar éis athnuachan an stórais. Ritheann suiteáil nó athchumrú an bhreiseáin láithreach é, agus seachnaíonn ritheanna láimhe ó bhainistíocht breiseán nó ón API an sceideal minicíochta freisin. Tar éis nuashonrú rathúil, déanann Weblate an teimpléad athraithe a thiomnú agus teaghráin foinse a athlódáil.

Ní dhéanann an nuashonrú teimpléid comhaid aistriúcháin PO a nuashonrú leis féin. Coinnigh Nuashonraigh comhaid PO chun teacht le POT (msgmerge) suiteáilte nuair ba chóir go leanfadh comhaid aistriúcháin athruithe teimpléid go huathoibríoch. Is féidir leis an bhfoirm suiteála don bhreiseán seo an breiseán sin a shuiteáil, ach ní thaispeánann socruithe breiseáin atá ann cheana an rogha suiteála sin arís.

Riachtanais Django

Éilíonn an breiseán seo xgettext agus msguniq. Ritheann sé fillteán eastósctha inmheánach Weblate le haghaidh teachtaireachtaí Django in ionad manage.py makemessages tionscadail a ghairm, mar sin ní luchtóidh sé socruithe ná feidhmchláir tionscadail Django.

Caithfidh an teimpléad le haghaidh aistriúcháin nua an fearann django nó djangojs a úsáid. Is iad na hainmneacha teimpléid a dtacaítear leo ná django.pot, djangojs.pot, django.po, agus djangojs.po. Déanann Weblate an t-eolaire foinse a thuiscint ó chonair an teimpléid agus seachnaíonn sé eolairí logánta an stórais agus é á eastóscadh.

Nuashonraigh comhad LINGUAS

Aitheantas an bhreiseáin:

weblate.gettext.linguas

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Laethúil, Iarchur leis an stóras, Iar-bhaint an stórais

Nuashonraíonn sé an comhad LINGUAS nuair a chuirtear aistriúchán leis nó nuair a bhaintear é.

Nuashonraigh comhad POT (Meson)

Added in version 5.17.

Aitheantas an bhreiseáin:

weblate.gettext.meson

Cumraíocht:

Update behavior

interval

Minicíocht nuashonraithe

Cé chomh minic ba chóir don bhreiseán an comhad POT a nuashonrú nuair a athnuachantar an chomhpháirt.

Roghanna atá ar fáil:

daily

Laethúil

weekly

Seachtainiúil

monthly

Míosúil

normalize_header

Ceanntásc POT a normalú

Nuashonraíonn sé ceanntásca gettext agus cuireann sé tuairimí POT in ionad na n-áitchoinneálaí.

location_mode

Suíomhanna foinse

Roghnaigh conas a scríobhann eastóscadh suíomhanna foinse chuig an gcomhad POT. Úsáid é seo chun suíomhanna a choinneáil sa teimpléad agus iad a fhágáil ar lár ó chomhaid PO aistrithe.

Roghanna atá ar fáil:

file

Úsáid socruithe formáide comhaid

keep

Sliocht suíomhanna chuig an gcomhad POT

omit

Ná bain amach suíomhanna

Meson preset

preset

Réamhshocrú Meson

Réamhshocrú argóinte xgettext ionsuite a mheaitseálann comhtháthú gettext Meson. Cuireann an réamhshocrú GLib na roghanna eochairfhocail agus brataí formáide a úsáideann cúntóir gettext Meson leis.

Roghanna atá ar fáil:

glib

GLib

Comment extraction

comment_mode

Tráchtanna ar chód

Roghnaigh an gcaithfidh xgettext gan aon tráchtanna, na tráchtanna uile, nó tráchtanna atá marcáilte le clib shonrach amháin a bhaint amach.

Roghanna atá ar fáil:

off

Ná bain amach tuairimí

all

Bain amach na tuairimí go léir

tagged

Bain amach tuairimí leis an gclib

comment_tag

Clib tráchta

Cuireadh an chlib chuig xgettext le haghaidh eastóscadh tráchta agus mód tráchta clibáilte in úsáid.

Keywords

keyword

Eochairfhocail bhreise

Eochairfhocail bhreise scartha le líne nua a chuirtear chuig xgettext ag baint úsáide as --keyword.

keyword_exclusive

Úsáid eochairfhocail go heisiach

Nuair a bhíonn sé cumasaithe, cuirtear --keyword gan luach chuig xgettext roimh an eochairfhocal breise, rud a dhíchumasaíonn na heochairfhocail réamhshocraithe go léir ionas nach n-aithnítear ach an eochairfhocal atá sonraithe thuas.

Checks and ITS data

checks

seiceálacha xgettext

Seiceálacha bailíochtaithe xgettext breise chun teachtaireachtaí eastósctha a chumasú.

Roghanna atá ar fáil:

ellipsis-unicode

eilipsis-unicode

space-ellipsis

spás-eilipsis

quote-unicode

luachan-unicode

bullet-unicode

piléar-unicode

data_dirs

Eolaire sonraí ITS

Eolaire a bhaineann leis an stór (agus a shonraítear ar línte ar leith) ina bhfuil foch-eolaire 'its' — mar shampla, 'po' le haghaidh 'po/its'. Bíonn tosaíocht ag na heolairí luatha ar na heolairí déanacha agus ar na rialacha atá cuimsithe sa bhogearra.

Truicear:

Suiteáil breiseán, Truicear láimhe, Iar-nuashonrú an stóras

Nuashonraíonn sé an teimpléad gettext ag baint úsáide as coinbhinsiúin gettext Meson.

Nuashonraíonn an breiseán seo an teimpléad atá cumraithe i Teimpléad le haghaidh aistriúcháin nua. Tá sé ar fáil do chomhpháirteanna gettext PO, agus ní mór don chomhpháirt teimpléad a shainiú le haghaidh aistriúcháin nua.

Baineann an mhinicíocht nuashonraithe roghnaithe le ritheanna uathoibríocha tar éis athnuachan an stórais. Ritheann suiteáil nó athchumrú an bhreiseáin láithreach é, agus seachnaíonn ritheanna láimhe ó bhainistíocht breiseán nó ón API an sceideal minicíochta freisin. Tar éis nuashonrú rathúil, déanann Weblate an teimpléad athraithe a thiomnú agus teaghráin foinse a athlódáil.

Ní dhéanann an nuashonrú teimpléid comhaid aistriúcháin PO a nuashonrú leis féin. Coinnigh Nuashonraigh comhaid PO chun teacht le POT (msgmerge) suiteáilte nuair ba chóir go leanfadh comhaid aistriúcháin athruithe teimpléid go huathoibríoch. Is féidir leis an bhfoirm suiteála don bhreiseán seo an breiseán sin a shuiteáil, ach ní thaispeánann socruithe breiseáin atá ann cheana an rogha suiteála sin arís.

Riachtanais Mheasún

Éilíonn an breiseán seo xgettext; ní iarrann sé Meson. Leanann sé coinbhinsiúin gettext Meson trí POTFILES nó POTFILES.in a léamh ón eolaire gettext agus an eochairfhocal GLib agus an réamhshocrú format-flag a chur chuig xgettext.

Is é an t-eolaire gettext an t-eolaire ina bhfuil an teimpléad atá cumraithe i Teimpléad le haghaidh aistriúcháin nua. Caithfidh meson.build agus POTFILES nó POTFILES.in a bheith ann. Caithfidh tionscadal Meson meson.build a bheith i láthair san eolaire sin nó i gceann dá eolairí tuismitheora. Má tá POTFILES agus POTFILES.in araon ann, úsáidtear POTFILES. Ní dhéanann POTFILES.skip comharsanachta comhaid foinse liostaithe a eisiamh ó eastóscadh.

Cumraigh an breiseán seo ón socrú gettext Meson atá ann cheana féin. I bhformhór na dtionscadal Meson, is é po/ an t-eolaire gettext, ainmnítear an teimpléad i ndiaidh an fhearainn gettext, agus glaonn po/meson.build ar chúntóir gettext Meson. Bain úsáid as an gcosán teimpléid céanna i Teimpléad le haghaidh aistriúcháin nua, mar shampla po/example.pot, agus coinnigh POTFILES nó POTFILES.in in aice leis an gcomhad meson.build sin.

Ní léann Weblate an liosta comhad foinse ó meson.build. Úsáideann sé POTFILES nó POTFILES.in, rud a mheaitseálann coinbhinsiún gettext Meson. Nuair a úsáideann tionscadal Meson eolaire nó fearann gettext neamh-réamhshocraithe, déan an leagan amach sin a scáthánú i gcosán teimpléid an chomhpháirte.

Gin comhaid MO

Aitheantas an bhreiseáin:

weblate.gettext.mo

Cumraíocht:

path

Conair an chomhaid MO a ghintear

Mura sonraítear é, úsáidfear suíomh an chomhaid PO.

fuzzy

Cuir teaghráin ar gá eagarthóireacht a dhéanamh orthu

Go hiondúil ní bhíonn teaghráin ar gá eagarthóireacht a dhéanamh orthu (doiléir) réidh le húsáid mar aistriúcháin.

Truicear:

Réamhthiomantas stóras

Gineann sé go huathoibríoch comhad MO do gach comhad PO athraithe.

Is féidir suíomh an chomhaid MO a ghintear a shaincheapadh agus úsáideann an réimse chuige Marcáil teimpléad.

Note

Má bhaintear aistriúchán, scriosfar a chomhad PO ón stór, ach ní bheidh an comhad MO ginte ag an mbreiseán seo. Ní mór an comhad MO a bhaint den réamhtheacht de láimh.

Nuashonraigh comhaid PO chun teacht le POT (msgmerge)

Changed in version 5.13: Settings tá an chumraíocht bogtha go Paraiméadair formáid comhaid.

Aitheantas an bhreiseáin:

weblate.gettext.msgmerge

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Iar-nuashonrú an stóras

Nuashonraítear gach comhad PO (mar atá cumraithe ag "Masc Comhaid") chun an comhad POT a mheaitseáil (mar atá cumraithe ag "Teimpléad le haghaidh aistriúcháin nua") ag baint úsáide as msgmerge.

Tá an breiseán seo riachtanach agus comhaid PO gettext á n-oibriú nuair a dhéantar an comhad POT (teimpléad) a nuashonrú le teaghráin nua nó athruithe ar theaghráin atá ann cheana féin. Nuair a dhéantar an comhad POT a nuashonrú sa stórlann, cumascfaidh an breiseán seo na hathruithe sin go huathoibríoch i ngach comhad PO teanga, rud a chinntíonn:

  • Tá teaghráin inaistrithe nua le feiceáil i ngach teanga

  • Tá teaghráin bainte marcáilte mar atá as dáta

  • Tá teaghráin mhodhnaithe marcáilte mar theastaigh athbhreithniú uathu (doiléir)

Is féidir formhór na roghanna líne ordaithe msgmerge a shocrú trí chumraíocht paraiméadair formáid comhaid. Cumasaigh an paraiméadar po_remove_obsolete chun iontrálacha #~ atá as dáta a bhaint nuair a shábháiltear comhaid PO.

Nuashonraigh comhad POT (Sphinx)

Added in version 5.17.

Aitheantas an bhreiseáin:

weblate.gettext.sphinx

Cumraíocht:

interval

Minicíocht nuashonraithe

Cé chomh minic ba chóir don bhreiseán an comhad POT a nuashonrú nuair a athnuachantar an chomhpháirt.

Roghanna atá ar fáil:

daily

Laethúil

weekly

Seachtainiúil

monthly

Míosúil

normalize_header

Ceanntásc POT a normalú

Nuashonraíonn sé ceanntásca gettext agus cuireann sé tuairimí POT in ionad na n-áitchoinneálaí.

location_mode

Suíomhanna foinse

Roghnaigh conas a scríobhann eastóscadh suíomhanna foinse chuig an gcomhad POT. Úsáid é seo chun suíomhanna a choinneáil sa teimpléad agus iad a fhágáil ar lár ó chomhaid PO aistrithe.

Roghanna atá ar fáil:

file

Úsáid socruithe formáide comhaid

keep

Sliocht suíomhanna chuig an gcomhad POT

omit

Ná bain amach suíomhanna

filter_mode

Scagadh

Is féidir teaghráin nach bhfuil úsáideach le haistriú a bhaint tar éis eastóscadh an Sphinx, más mian leat.

Roghanna atá ar fáil:

none

Dada

weblate_docs

Cáipéisíocht Weblate

Truicear:

Suiteáil breiseán, Truicear láimhe, Iar-nuashonrú an stóras

Nuashonraíonn sé an teimpléad gettext ag baint úsáide as tógálaí gettext Sphinx gan cumraíocht an tionscadail a luchtú.

Nuashonraíonn an breiseán seo an teimpléad atá cumraithe i Teimpléad le haghaidh aistriúcháin nua. Tá sé ar fáil do chomhpháirteanna gettext PO, agus ní mór don chomhpháirt teimpléad a shainiú le haghaidh aistriúcháin nua.

Baineann an mhinicíocht nuashonraithe roghnaithe le ritheanna uathoibríocha tar éis athnuachan an stórais. Ritheann suiteáil nó athchumrú an bhreiseáin láithreach é, agus seachnaíonn ritheanna láimhe ó bhainistíocht breiseán nó ón API an sceideal minicíochta freisin. Tar éis nuashonrú rathúil, déanann Weblate an teimpléad athraithe a thiomnú agus teaghráin foinse a athlódáil.

Ní dhéanann an nuashonrú teimpléid comhaid aistriúcháin PO a nuashonrú leis féin. Coinnigh Nuashonraigh comhaid PO chun teacht le POT (msgmerge) suiteáilte nuair ba chóir go leanfadh comhaid aistriúcháin athruithe teimpléid go huathoibríoch. Is féidir leis an bhfoirm suiteála don bhreiseán seo an breiseán sin a shuiteáil, ach ní thaispeánann socruithe breiseáin atá ann cheana an rogha suiteála sin arís.

Riachtanais na Sfincs

Éilíonn an breiseán seo sphinx-build, arna sholáthar ag an breiseán suiteála sphinx. Ní mór don teimpléad le haghaidh aistriúcháin nua a bheith ina chomhad .pot faoi bhun eolaire locales. Úsáidtear an t-eolaire roimh locales mar eolaire foinse Sphinx agus ní mór conf.py a bheith ann.

Úsáideann eastóscadh cumraíocht phacáilte Sphinx Weblate agus ní luchtaíonn sé cumraíocht an tionscadail. Ritheann Weblate an tógálaí gettext Sphinx, déanann sé tagairtí foinseacha a normalú do chosáin i gcoibhneas leis an eolaire foinseacha, agus cóipeálann sé an teimpléad ginte ar ais chuig an gcosán teimpléid chumraithe.

Nuashonraigh comhad POT (xgettext)

Added in version 5.17.

Aitheantas an bhreiseáin:

weblate.gettext.xgettext

Cumraíocht:

Update behavior

interval

Minicíocht nuashonraithe

Cé chomh minic ba chóir don bhreiseán an comhad POT a nuashonrú nuair a athnuachantar an chomhpháirt.

Roghanna atá ar fáil:

daily

Laethúil

weekly

Seachtainiúil

monthly

Míosúil

normalize_header

Ceanntásc POT a normalú

Nuashonraíonn sé ceanntásca gettext agus cuireann sé tuairimí POT in ionad na n-áitchoinneálaí.

location_mode

Suíomhanna foinse

Roghnaigh conas a scríobhann eastóscadh suíomhanna foinse chuig an gcomhad POT. Úsáid é seo chun suíomhanna a choinneáil sa teimpléad agus iad a fhágáil ar lár ó chomhaid PO aistrithe.

Roghanna atá ar fáil:

file

Úsáid socruithe formáide comhaid

keep

Sliocht suíomhanna chuig an gcomhad POT

omit

Ná bain amach suíomhanna

Input files

input_mode

Foinse ionchuir

Roghnaigh an léifidh xgettext comhaid foinse ó phatrúin glob nó ó mhaitrís POTFILES/POTFILES.in.

Roghanna atá ar fáil:

patterns

Patrúin comhaid foinse

potfiles

Léiriú POTFILES

language

teanga xgettext

Teanga ríomhchlárúcháin a chuirtear chuig xgettext, mar shampla Python nó C. Fág bán le ligean do xgettext buille faoi thuairim a thabhairt faoin teanga ó shíntí comhaid.

source_patterns

Patrúin comhaid foinse

Patrúin globa coibhneasta leis an stór atá scartha de réir líne nua le haghaidh comhad le baint amach le xgettext.

potfiles_path

Cosán POTFILES

Cosán gaolmhar leis an stórlann chuig POTFILES nó POTFILES.in. Réitítear iontrálacha i gcoibhneas le fréamh an stórlainne. Má tá sé i láthair in aice leis an manifíse, ní dhéanann POTFILES.skip comhaid liostaithe a eastóscadh.

Comment extraction

comment_mode

Tráchtanna ar chód

Roghnaigh an gcaithfidh xgettext gan aon tráchtanna, na tráchtanna uile, nó tráchtanna atá marcáilte le clib shonrach amháin a bhaint amach.

Roghanna atá ar fáil:

off

Ná bain amach tuairimí

all

Bain amach na tuairimí go léir

tagged

Bain amach tuairimí leis an gclib

comment_tag

Clib tráchta

Cuireadh an chlib chuig xgettext le haghaidh eastóscadh tráchta agus mód tráchta clibáilte in úsáid.

Keywords

keyword

Eochairfhocail bhreise

Eochairfhocail bhreise scartha le líne nua a chuirtear chuig xgettext ag baint úsáide as --keyword.

keyword_exclusive

Úsáid eochairfhocail go heisiach

Nuair a bhíonn sé cumasaithe, cuirtear --keyword gan luach chuig xgettext roimh an eochairfhocal breise, rud a dhíchumasaíonn na heochairfhocail réamhshocraithe go léir ionas nach n-aithnítear ach an eochairfhocal atá sonraithe thuas.

Checks and ITS data

checks

seiceálacha xgettext

Seiceálacha bailíochtaithe xgettext breise chun teachtaireachtaí eastósctha a chumasú.

Roghanna atá ar fáil:

ellipsis-unicode

eilipsis-unicode

space-ellipsis

spás-eilipsis

quote-unicode

luachan-unicode

bullet-unicode

piléar-unicode

data_dirs

Eolaire sonraí ITS

Eolaire a bhaineann leis an stór (agus a shonraítear ar línte ar leith) ina bhfuil foch-eolaire 'its' — mar shampla, 'po' le haghaidh 'po/its'. Bíonn tosaíocht ag na heolairí luatha ar na heolairí déanacha agus ar na rialacha atá cuimsithe sa bhogearra.

Truicear:

Suiteáil breiseán, Truicear láimhe, Iar-nuashonrú an stóras

Nuashonraíonn sé an teimpléad gettext ag baint úsáide as xgettext ar chomhaid foinse roghnaithe.

Nuashonraíonn an breiseán seo an teimpléad atá cumraithe i Teimpléad le haghaidh aistriúcháin nua. Tá sé ar fáil do chomhpháirteanna gettext PO, agus ní mór don chomhpháirt teimpléad a shainiú le haghaidh aistriúcháin nua.

Baineann an mhinicíocht nuashonraithe roghnaithe le ritheanna uathoibríocha tar éis athnuachan an stórais. Ritheann suiteáil nó athchumrú an bhreiseáin láithreach é, agus seachnaíonn ritheanna láimhe ó bhainistíocht breiseán nó ón API an sceideal minicíochta freisin. Tar éis nuashonrú rathúil, déanann Weblate an teimpléad athraithe a thiomnú agus teaghráin foinse a athlódáil.

Ní dhéanann an nuashonrú teimpléid comhaid aistriúcháin PO a nuashonrú leis féin. Coinnigh Nuashonraigh comhaid PO chun teacht le POT (msgmerge) suiteáilte nuair ba chóir go leanfadh comhaid aistriúcháin athruithe teimpléid go huathoibríoch. Is féidir leis an bhfoirm suiteála don bhreiseán seo an breiseán sin a shuiteáil, ach ní thaispeánann socruithe breiseáin atá ann cheana an rogha suiteála sin arís.

riachtanais xgettext

Éilíonn an breiseán seo xgettext. Cumraigh patrúin chomhaid foinse nó manifíl POTFILES / POTFILES.in. Is patrúin glob gaolmhara leis an stór iad patrúin chomhaid foinse agus ní chuirtear ach comhaid stórtha comhoiriúnacha chuig xgettext.

Déantar iontrálacha i POTFILES nó POTFILES.in a réiteach i gcoibhneas le fréamh an stórais. Ní mór dóibh a bheith ina gcosáin choibhneasta, fanacht laistigh den stór, agus pointeáil chuig comhaid atá ann cheana féin. Déantar neamhaird de línte bána agus línte a thosaíonn le #. Má tá comhad POTFILES.skip ann in aice leis an manifíse, eisiatar a iontrálacha ón eastóscadh.

Déantar ritheanna athnuachana uathoibríocha stórtha a scipeáil mura bhfuil na comhaid athraithe ag teacht leis na patrúin foinse cumraithe, mura bhfuil siad ag teacht le comhaid atá liostaithe sa mhaitrís, mura n-athraítear maitrís faire, nó mura n-athraítear cumraíocht an bhreiseáin.

Tosaigh ón socrú eastósctha córais tógála agus an breiseán seo á chumrú. De ghnáth, coinníonn tionscadail Autotools ionchuir gettext i po/POTFILES.in agus roghanna ar nós an fhearainn gettext agus bratacha xgettext i po/Makevars nó i gcomhaid ghaolmhara Makefile.am. Bain úsáid as an mód follasach leis an POTFILES.in céanna nuair is cosáin foinse simplí gaolmhara leis an stór a iontrálacha, agus cóipeáil iompar eastósctha ábhartha isteach i socruithe an bhreiseáin, mar shampla an teanga, eastóscadh tráchta, seiceálacha, agus eochairfhocal breise.

I gcás córais tógála eile, bain úsáid as an liosta foinse nó as an ordú eastósctha atá á rith acu cheana féin mar fhoinse na fírinne. Is minic a ghlaonn CMake, Makefile saincheaptha, scripteanna npm, nó scripteanna eastósctha tionscadail-shonracha ar xgettext go díreach nó gineann siad liosta comhad idirmheánach. Cumraigh patrúin foinse le haghaidh leagan amach simplí, nó bain úsáid as mód léirithe nuair a choinníonn an tionscadal liosta comhad simplí. Má tá claochluithe nó réimíreanna i léiriú córais tógála nach cosáin chomhaid iad, tiontaigh é go cosáin simplí gaolmhara leis an stór sula n-úsáidtear é mar POTFILES.

Mixed source formats and ITS rules

Leave xgettext language blank to extract messages from different formats into the same POT. Include all inputs in the source patterns or POTFILES, for example:

common/messages.py
qt/application.desktop
qt/application.policy
data/application.metainfo.xml

Desktop entries use the native xgettext parser. Weblate bundles ITS rules for Polkit policies, AppStream/MetaInfo, GSettings, GTK Builder, and Shared MIME Info. These rules are included in the Weblate package, including Docker installations; no additional system packages are required for these formats. The Nuashonraigh comhad POT (Meson) add-on uses the same rules.

Extraction follows upstream gettext and ITS behavior. In particular, desktop extraction includes keys such as Name, GenericName, and Comment; Polkit rules select description and message elements without filtering by gettext-domain. Use untranslated policy sources: upstream Polkit rules also select elements carrying xml:lang.

For custom XML formats or overrides, configure ITS data directories. Enter one repository-relative directory per line, in priority order. Each must contain an its/ subdirectory with .loc locating rules and .its extraction rules. For example, enter po for po/its/example.loc and po/its/example.its, or . for its/ at the repository root. In API add-on configuration, use a list: "data_dirs": ["po", "data"].

Earlier directories take precedence over later ones, followed by Weblate's bundled rules and gettext's system rules. The directories are passed through GETTEXTDATADIRS. Configure them explicitly even when using Meson; Weblate does not read data_dirs from meson.build or inherit an administrator's GETTEXTDATADIRS environment variable.

Rule directories and files must stay inside the repository and must not be symbolic links. A locating rule's target must name an existing .its file in the same directory. DTDs, entity declarations, and external rule references are not supported. Weblate validates project-local rules before extraction and reports invalid rules as add-on errors. Changes, additions, or deletions in the configured its/ directories trigger extraction even when source files have not changed.

Geallann Squash Git

Aitheantas an bhreiseáin:

weblate.git.squash

Cumraíocht:

squash

Tiomantas scuaise

Roghanna atá ar fáil:

all

Gach tiomantas i amháin

language

In aghaidh an teanga

file

In aghaidh an chomhaid

author

De réir an údair

author-language

De réir údair agus teanga

append_trailers

Leantóirí a chur i gceangal leis an teachtaireacht cimithe brúite

Is éard atá i línte leantóir ná línte atá cosúil le ceanntásca r-phoist RFC 822, ag deireadh na coda eile de theachtaireacht gealltanais, amhail ‘Co-authored-by: …’.

commit_message

Tiomantas teachtaireacht

Úsáidfear an teachtaireacht gealltanais seo in ionad na dteachtaireachtaí comhcheangailte ón ngealltanas brúite.

Truicear:

Suiteáil breiseán, Iarchoimisiún stóras

Geallann Squash Git roimh athruithe a bhrú.

Hint

Chun coimhlintí neamhriachtanacha a sheachaint, moltar glacadh uathoibríoch athruithe suas an sruth a chumrú trí webhooks nó API, féach Taisclanna á nuashonrú.

Is féidir gealltanais git a bhrú roimh athruithe a bhrú ar cheann de na modhanna seo a leanas:

  • Gach tiomantas i amháin

  • In aghaidh an teanga

  • In aghaidh an chomhaid

  • De réir an údair

  • De réir údair agus teanga

Coinnítear na bunteachtaireachtaí gealltanais, ach cailltear an t-údaracht ach amháin má roghnaítear Per author, nó má dhéantar an teachtaireacht tiomantais a shaincheapadh chun é a chur san áireamh.

Is féidir na buntheachtaireachtaí gealltanais a shárú go roghnach le teachtaireacht chimithe saincheaptha.

Is féidir leantóirí (línte tiomantais cosúil le Comhúdaraithe ag: …) a bhaint de na teachtaireachtaí tiomantais bunaidh agus iad a chur le deireadh na teachtaireachta tiomantais brúite. Gineann sé seo creidiúint chuí Comhúdaraithe ag: do gach aistritheoir freisin.

Saincheap aschur JSON

Changed in version 5.12: Avoid spaces after separators rogha curtha leis..

Removed in version 5.13: Arna ionadú ag Paraiméadair formáid comhaid.

Athshocraigh an stór go dtí an sruth

Added in version 5.17.

Aitheantas an bhreiseáin:

weblate.hosted.reset

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Laethúil

Caitheann sé gach athrú sa stór Weblate gach oíche.

Formáidigh an comhad airíonna Java

Aitheantas an bhreiseáin:

weblate.properties.sort

Cumraíocht:

case_sensitive

Cumasaigh sórtáil eochrach cás-íogair

Truicear:

Réamhthiomantas stóras

Formáidí agus sórtálann an comhad airíonna Java.

  • Comhdhlúthaíonn sé línte nua le cinn Unix.

  • Formáidiú cás uachtair ar sheichimh éalaithe Unicode (i gcás go bhfuil siad i láthair).

  • Stiallacha línte bána agus tuairimí.

  • Sórtáil na teaghráin de réir na heochracha.

  • Titeann teaghráin dhúbailt.

Baint tráchta stale

Aitheantas an bhreiseáin:

weblate.removal.comments

Cumraíocht:

age

Laethanta le coinneáil

Truicear:

Suiteáil breiseán, Laethúil

Socraigh fráma ama chun tuairimí a bhaint.

D’fhéadfadh sé seo a bheith úsáideach chun seantráchtanna a d’fhéadfadh a bheith as dáta a bhaint. Bain úsáid as go cúramach mar ní chiallaíonn tuairimí ag dul in aois go bhfuil a dtábhacht caillte acu.

Moladh stale a bhaint

Aitheantas an bhreiseáin:

weblate.removal.suggestions

Cumraíocht:

age

Laethanta le coinneáil

votes

Tairseach vótála

Tairseach le haghaidh bainte. Fág folamh chun moltaí a bhaint beag beann ar vótaí. Níl aon éifeacht ag an réimse seo nuair a bhíonn an vótáil múchta.

Truicear:

Suiteáil breiseán, Laethúil

Socraigh fráma ama chun moltaí a bhaint.

Is féidir a bheith an-úsáideach i dtaca le vótáil mholtaí (féach Léirmheas piaraí) chun moltaí nach bhfaigheann go leor vótaí dearfacha a bhaint i bhfráma ama ar leith.

Nuashonraigh comhaid RESX

Aitheantas an bhreiseáin:

weblate.resx.update

Cumraíocht:

Níl aon chumraíocht ag an mbreiseán seo.

Truicear:

Suiteáil breiseán, Iar-nuashonrú an stóras

Nuashonraigh gach comhad aistriúcháin chun teacht leis an mbunchomhad aonteangach réamhtheachtacha. Baintear teaghráin nár úsáideadh, agus cuirtear cinn nua leis mar chóipeanna den teaghrán foinse.

Hint

Úsáid Glanadh comhaid aistriúcháin mura bhfuil uait ach seaneochracha aistriúcháin a bhaint.

Crúcaí Gréasáin Slack

Added in version 5.12.

Aitheantas an bhreiseáin:

weblate.webhook.slack

Cumraíocht:

webhook_url

URL Webhook

event_filter

Athraigh imeachtaí le spreagadh

Roghnaigh cé na himeachtaí athraithe ba chóir a chur i ngníomh an breiseáin seo. Athraigh imeachtaí le spreagadh

events

Imeachtaí athraithe roghnaithe

Imeachtaí athraithe roghnaithe

Truicear:

Athrú imeachta

Seolann sé fógra chuig cainéal Slack bunaithe ar imeachtaí roghnaithe.

Warning

D’fhéadfadh clibeanna HTML a bheith le feiceáil in ábhar an fhógra. Is fadhb aitheanta í seo a réiteofar go luath; féach https://github.com/WeblateOrg/weblate/issues/15056.

Hint

Chun URL webhook a fháil, lean na céimeanna atá leagtha amach i ndoiciméadacht Slack Incoming Webhooks

Crúca Gréasáin

Added in version 5.11.

Changed in version 5.15: Tá comhlíonadh fad an rúnda leis an tsonraíocht bailíochtú anois.

Aitheantas an bhreiseáin:

weblate.webhook.webhook

Cumraíocht:

webhook_url

URL Webhook

secret

Rún Webhook

Is teaghrán ionchódaithe base64 é rún Standard Webhooks.

event_filter

Athraigh imeachtaí le spreagadh

Roghnaigh cé na himeachtaí athraithe ba chóir a chur i ngníomh an breiseáin seo. Athraigh imeachtaí le spreagadh

events

Imeachtaí athraithe roghnaithe

Imeachtaí athraithe roghnaithe

Truicear:

Athrú imeachta

Seolann sé fógraí chuig seirbhísí seachtracha bunaithe ar imeachtaí roghnaithe, ag leanúint shonraíocht chaighdeánach Webhooks.

Comhlíonann ualach an iarratais an scéim Weblate Messaging. Úsáideann an réimse action ainm an ghnímh atá liostaithe i Imeachtaí athraithe roghnaithe. Is féidir cur síos OpenAPI a fháil ag /api/docs/ freisin. Corp iarratais samplach:

{
   "change_id": 99,
   "action": "Translation changed",
   "timestamp": "2019-08-24T14:15:22Z",
   "target": "Nazdar svete!",
   "old": "Nazdar!",
   "source": "Hello, world",
   "url": "/translate/project-slug/component-slug/cs/?checksum=46add148a53cab6f",
   "author": "author-username",
   "user": "user-username",
   "project": "project-slug",
   "component": "component-slug",
   "translation": "cs"
}

Corp iarratais shamplach le catagóirí:

{
   "change_id": 8910,
   "action": "Component renamed",
   "timestamp": "2025-06-11T07:15:09Z",
   "target": ["new-name"],
   "old": ["component-slug"],
   "url": "/projects/project-slug/parent-category/child-category/sub-category/component-slug/",
   "user": "testuser",
   "project": "project-slug",
   "component": "component-slug",
   "category": [
      "sub-category",
      "child-category",
      "parent-category"
   ]
}

Ceanntásca iarratais samplacha:

{
   "webhook-id": "7f1c5477f6275a69af7b83236c20cb1a",
   "webhook-timestamp": "1748505623.044281",
   "webhook-signature": "v1,Ceo5qEr07ixe2NLpvHk3FH9bwy/WavXrAFQ/9tdO6mc="
}

Is liosta de shínithe HMAC scartha le spásanna é an webhook-signature a ghintear ag baint úsáide as an teaghrán secret, ualach an iarratais, an webhook-timestamp, agus an webhook-id. Cinntíonn sé seo barántúlacht agus sláine an iarratais webhook.

Is teaghrán ionchódaithe le base64 idir 24 beart (192 giotán) agus 64 beart (512 giotán) an secret a chuirtear ar fáil. Is féidir réimír whsec_ a chur leis le go mbeidh sé éasca é a aithint.

Chun iarratas a fhíorú, is féidir leat an modh Webhook.verify ón leabharlann standardwebhooks nó cur i bhfeidhm den "Standard Webhooks Specification" a úsáid.

Cruthaíonn an modh Aistriúchán uathoibríoch (Add as approved translation) teaghráin cheadaithe nuair a bhíonn athbhreithnithe cumasaithe don sprioc-theanga. Má dhéantar athbhreithnithe a dhíchumasú de bharr socruithe an tionscadail nó sreabhadh oibre teanga, cruthaítear teaghráin aistrithe ina n-ionad. Coinnítear an modh atá cumraithe, lena n-áirítear i gcás breiseán a bhaineann leis an tionscadal ar fad nó leis an suíomh ar fad, fiú má tá socruithe athbhreithnithe éagsúla ag na spriocanna atá acu. Chun an modh seo a chumrú, teastaíonn an ghnáthcheadúnas bainistíochta breiseán; ní gá gur athbhreithneoir é an t-úsáideoir atá ag déanamh na cumraíochta.

The Comhaid aistriúcháin CDN and Logánú JavaScript CDN add-ons publish manifest.json at their CDN base URL. Clients can download it without an API token to discover available languages and translation files:

{
  "schemaVersion": 1,
  "locales": {
    "cs": [
      {
        "url": "cs.json",
        "sha256": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
        "size": 123
      }
    ]
  }
}

The locales keys are Weblate language codes. Each value lists the published files for that language, sorted by URL. The url is relative to the manifest URL, sha256 is the SHA-256 checksum of the published bytes, and size is the file size in bytes. Multi-file translations have several entries per language. The JavaScript add-on includes only languages meeting its translation threshold. Source-language inclusion follows each add-on's existing publication rules. The JavaScript loader and the manifest itself are not listed. When no translation files are published, locales is an empty object. The root filename manifest.json is reserved for this manifest. Weblate validates each manifest against the CDN manifest before publishing it.

Translation files are written before the manifest is replaced, and stale files are removed afterwards. File URLs remain mutable, and CDN caches can refresh the manifest and translation files at different times. If a download fails or its checksum does not match, refresh the manifest and retry the download. The manifest does not provide an immutable snapshot or revoke cached copies of removed files. Existing add-on installations publish a manifest on their next successful publication.

The CDN SDK Kotlin add-on uses a separate build-specific manifest format.

Stopann an breiseán Fionnachtain Comhpháirte le hearráid má sháraíonn scanadh an stóir 100,000 cosán, nó má theastaíonn níos mó ná 1,000,000 comparáid idir cosáin agus maisc ó na comhaid aistriúcháin a bhaineann leis. Déantar an teorainn comparáide a sheiceáil trí líon na gcosán sa stór a iolrú faoi líon na masc comhaid. Cuireann na teorainneacha seasta seo srian le tomhaltas acmhainní nuair is ábhar an stóir a chinneann na maisc. Má sháraítear ceachtar den dá theorainn, ní chruthaíonn ná ní bhaineann an próiseas aimsithe comhpháirteanna ar bith.

When configuring the add-on, Weblate also suggests presets detected from the repository. Preset detection analyzes at most 4,096 distinct results with file masks no longer than 512 characters or 16 path segments. It samples groups of more than 128 compatible results and limits itself to 8,192 comparisons, 50 presets, and eight examples per preset. If a limit omits results or comparisons, Weblate warns that suggestions might be incomplete. You can enter the configuration manually.

The Crúca Gréasáin and Crúcaí Gréasáin Slack add-ons request uncompressed responses and reject responses with a Content-Encoding other than identity before reading their bodies. They limit each response body to 1 MiB and response headers to 64 KiB, including duplicate headers and separators. If a response is encoded or either fixed limit is exceeded, Weblate closes the response and records an add-on error without storing the response body or headers. The remote service might already have accepted the notification even when Weblate records this error.

Breiseáin atá as dáta

Rannpháirtithe sa trácht

Removed in version 2026.10: Replaced by Tuairimí ó rannpháirtithe.

Existing installations of weblate.gettext.authors are migrated to the gettext value of the po_contributor_comments file format parameter for each affected PO component. This includes components covered by category-, project-, and site-wide installations. New components default to disabled unless their file format parameters are copied from another component.

Remove weblate.addons.gettext.GettextAuthorComments from custom WEBLATE_ADDONS lists and weblate.gettext.authors entries from DEFAULT_ADDONS. Configure Tuairimí ó rannpháirtithe instead.

Saincheap aschur XML

Added in version 4.15.

Removed in version 5.13: Arna ionadú ag Paraiméadair formáid comhaid.

Saincheap aschur YAML

Removed in version 5.13: Arna ionadú ag Paraiméadair formáid comhaid.

Paraiméadair bhreiseáin choitianta

Seirbhísí aistriúcháin

Roghanna atá ar fáil:

alibaba

Ali Baba

aws

Amazon Translate

anthropic

Anthropic

apertium-apy

Apertium APy

microsoft-translator

Azure AI Aistritheoir

azure-openai

Azure OpenAI

baidu

Baidu

cyrtranslit

CyrTranslit

deepl

domhainL

glosbe

Glosbe

google-translate-api-v3

Google Cloud Translation Advanced

google-translate

Google Cloud Translation Bunúsach

ltengine

LTEngine

libretranslate

LibreTranslate

mistral

Mistral

modernmt

ModernMT

mymemory

MyMemory

netease-sight

Radharc Netease

ollama

Ollama

openai

Oscail AI

sap-translation-hub

Mol Aistriúcháin SAP

systran

Systran

weblate

Weblate

weblate-translation-memory

Cuimhne Aistriúcháin Weblate

yandex

Yandex

yandex-v2

Yandex leagan 2

youdao-zhiyun

Tú Zhiyun

etranslation

eTranslation

tmserver

freastalaí tm

Formáid comhaid

Roghanna atá ar fáil:

apple-xliff

XLIFF 1.2 le síntí Apple

appstore

Comhaid meiteashonraí ó App Store

arb

Comhad ARB

aresource

Acmhainn Teaghrán Android

asciidoc

Comhad AsciiDoc

ass

Comhad fotheideal Advanced SubStation Alpha

catkeys

Eochracha cait Haiku

cmp-resource

Acmhainn Il-ardáin a Chur le chéile

csv

Comhad CSV

csv-multi

Comhad CSV illuach

csv-simple

Comhad CSV simplí

dokuwiki

Comhad téacs DokuWiki

dtd

Comhad DTD

flatxml

Comhad XML cothrom

fluent

Comhad líofa

formatjs

Formáid.JS comhad JSON

go-i18n-json

go-i18n v1 JSON comhad

go-i18n-json-v2

go-i18n v2 JSON comhad

go-i18n-toml

comhad TOML go-i18n

gotext

gotext JSON comhad

gwt

airíonna GWT

html

Comhad HTML

i18next

i18next comhad JSON v3

i18nextv4

i18next comhad JSON v4

idml

Comhad IDML

ini

comhad INI

islu

Comhad INI Inno Socrú

joomla

Joomla comhad teanga

json

comhad JSON

json-nested

Comhad struchtúir neadaithe JSON

laravel

Teaghráin php Laravel

markdown

Comhad marcála

mdx

Comhad MDX

mediawiki

Comhad téacs MediaWiki

mi18n-lang

@draggable/i18n comhad lang

moko-resource

Acmhainn Soghluaiste Kotlin

nextcloud-json

Comhad JSON Nextcloud

odf

Comhad OpenDocument

php

Teaghráin PHP

po

comhad PO gettext

po-mono

comhad PO gettext (aonteangach)

poxliff

XLIFF 1.2 le síntí gettext

properties

Airíonna Java

rc

Comhad RC

resjson

Comhad RESJSON

resourcedictionary

Comhad ResourceDictionary

resx

Comhad acmhainne .NET

ruby-yaml

Comhad Ruby YAML

srt

Comhad fotheideal SubRip

ssa

Comhad fotheideal SubStation Alpha

strings

teaghráin iOS

stringsdict

Stringsdict comhad

sub

Comhad fotheideal microDVD

tbx

Comhad eXchange TermBase

toml

Comhad TOML

ts

Comhad aistriúcháin Qt Linguist (leagan 2)

ts1

Comhad aistriúcháin Qt Linguist (leagan 1)

txt

Comhad téacs simplí

webextension

Comhad JSON WebExtension

wxl

Comhad WixLocalization

xliff

Comhad aistriúcháin XLIFF 1.2

xliff2

Comhad aistriúcháin XLIFF 2.0

xlsx

Excel Oscailte XML

xwiki-fullpage

Leathanach Iomlán XWiki

xwiki-java-properties

Airíonna XWiki Java

xwiki-page-properties

Airíonna Leathanach XWiki

yaml

Comhad YAML

Athraigh imeachtaí le spreagadh

Roghanna atá ar fáil:

content

Imeachtaí ábhair aistriúcháin

all

Gach imeacht athraithe

custom

Imeachtaí athraithe roghnaithe

Imeachtaí athraithe roghnaithe

Is féidir na gníomhartha athraithe seo a leanas a bheith le feiceáil in ualaí fógra. Úsáideann Fedora Messaging an colún aitheantais i dtopaicí teachtaireachtaí, agus úsáideann ualaí webhook an colún ainm sa réimse gníomh.

Roghanna atá ar fáil:

Aitheantas

Aitheantóir

Ainm

Cur síos

0

resource_updated

Acmhainn nuashonraithe

Sioncrónaíodh comhad aistriúcháin lena stór.

1

translation_completed

Aistriúchán críochnaithe

Rinneadh aistriúchán teanga a aistriú go hiomlán tar éis eagarthóireacht aonair. Ní tharlaíonn an teagmhas seo le haistriúchán uathoibríoch, uaslódálacha ná eagarthóireachtaí mórchóir.

2

translation_changed

Athraíodh an t-aistriúchán

Rinne úsáideoir eagarthóireacht ar aistriúchán atá ann cheana féin.

3

comment_added

Trácht curtha leis

Cuireadh trácht le teaghrán.

4

suggestion_added

Moladh curtha leis

Cuireadh moladh aistriúcháin leis.

5

translation_added

Aistriúchán curtha leis

Aistríodh teaghrán nár aistríodh roimhe seo ag úsáideoir.

6

automatically_translated

Aistrithe go huathoibríoch

Cuireadh aistriúchán leis nó athraíodh é le haistriúchán uathoibríoch. Aistrítear é seo in ionad Aistriúchán curtha leis nó Aistriúchán athraithe.

7

suggestion_accepted

Glacadh le moladh

Glacadh le moladh aistriúcháin mar aistriúchán.

8

translation_reverted

Aistriúchán ar ais

Athchóiríodh aistriúchán go luach níos luaithe.

9

translation_uploaded

Aistriúchán uaslódáilte

Cuireadh aistriúchán leis nó athraíodh é trí chomhad aistriúcháin a uaslódáil. Aistrítear é seo in ionad Aistriúchán curtha leis nó Aistriúchán athraithe.

13

source_string_added

Cuireadh teaghrán foinse leis

Cuireadh teaghrán foinse leis lasmuigh den stórlann nó de nuashonruithe uaslódála.

14

component_locked

Comhpháirt faoi ghlas

Glasáladh comhpháirt le haghaidh aistriúcháin.

15

component_unlocked

Comhpháirt díghlasáilte

Díghlasáladh comhpháirt le haghaidh aistriúcháin.

17

changes_committed

Athruithe geallta

Rinneadh athruithe ar chomhpháirteanna atá ar feitheamh.

18

changes_pushed

Athruithe bhrú

Brúdh athruithe ar an stór suas an sruth.

19

repository_reset

Athshocrú stór

Athshocraíodh stórlann go dtí a staid suas an sruth.

20

repository_merged

Cumasc an stór

Cuireadh athruithe ar an stór suas an sruth le chéile.

21

repository_rebased

Stór athbhunaithe

Rinneadh athruithe ar an stór a athbhunú ar an uas-sruth.

22

repository_merge_failed

Theip ar chumasc stórtha

Theip ar athruithe ar an stórlann suas an sruth a chumasc.

23

repository_rebase_failed

Theip ar athbhunú an taisc

Theip ar athruithe ar an stóras a athbhunú.

24

parsing_failed

Theip ar pharsáil

Ní raibh Weblate in ann comhad aistriúcháin a pharsáil.

25

translation_removed

Baineadh an t-aistriúchán

Baineadh aistriúchán teanga.

26

suggestion_removed

Baineadh an moladh

Baineadh moladh aistriúcháin.

27

translation_replaced

Aistriúchán ionad

Athraíodh aistriúchán le hoibríocht cuardaigh agus athsholáthair. Aistrítear é seo in ionad Athraíodh an t-aistriúchán.

28

repository_push_failed

Theip ar bhrú stórtha

Theip ar athruithe ar an stór a bhrú suas an sruth.

29

suggestion_removed_during_cleanup

Baineadh an moladh le linn glantacháin

Baineadh moladh aistriúcháin atá as dáta le linn an ghlantacháin.

30

source_string_changed

Athraíodh teaghrán foinse

Rinneadh eagarthóireacht ar theaghrán foinse i Weblate.

31

string_added

Teaghrán curtha leis

Cuireadh teaghrán nua leis i Weblate.

32

bulk_status_changed

Athraíodh an stádas mórchóir

Athraíodh staid aistriúcháin teaghrán amháin nó níos mó ar an mórchóir.

33

visibility_changed

Infheictheacht athraithe

Athraíodh infheictheacht an tionscadail nó an chomhpháirte.

34

user_added

Úsáideoir curtha leis

Bronnadh rochtain ar úsáideoir.

35

user_removed

Baineadh an t-úsáideoir

Baineadh rochtain úsáideora.

36

translation_approved

Aistriúchán ceadaithe

Ceadaíodh aistriúchán le linn an athbhreithnithe.

37

marked_for_edit

Marcáilte le haghaidh eagarthóireacht

Marcáladh aistriúchán mar aistriúchán a raibh gá le heagarthóireacht air.

38

component_removed

Baineadh an chomhpháirt

Baineadh comhpháirt aistriúcháin.

39

project_removed

Baineadh an tionscadal

Baineadh tionscadal aistriúcháin.

41

project_renamed

Athainmníodh an tionscadal

Athainmníodh tionscadal aistriúcháin.

42

component_renamed

Comhpháirt athainmnithe

Athainmníodh comhpháirt aistriúcháin.

43

moved_component

Comhpháirt bhog

Bogadh comhpháirt laistigh de thionscadal.

45

contributor_joined

Chuaigh an ranníocóir isteach

Rinne úsáideoir a chéad ranníocaíocht le haistriúchán.

46

announcement_posted

Fógraí curtha suas

Cuireadh fógra suas.

47

alert_triggered

Spreagadh foláireamh

Cuireadh foláireamh comhpháirte i ngníomh.

48

language_added

Cuireadh teanga leis

Cuireadh aistriúchán teanga leis.

49

language_requested

Teanga iarrtha

D'iarr úsáideoir teanga nua.

50

project_created

Tionscadal cruthaithe

Cruthaíodh tionscadal aistriúcháin.

51

component_created

Comhpháirt cruthaithe

Cruthaíodh comhpháirt aistriúcháin.

52

user_invited

Tugadh cuireadh don úsáideoir

Tugadh cuireadh d'úsáideoir chuig tionscadal.

53

repository_notification_received

Fuarthas fógra stórtha

Fuair Weblate fógra stórais ó óstach cóid.

54

translation_replaced_file_by_upload

Uaslódáil in ionad an aistriúcháin

Cuireadh comhad uaslódáilte in ionad comhad aistriúcháin.

55

license_changed

Athraíodh an ceadúnas

Athraíodh faisnéis cheadúnais tionscadail nó comhpháirte.

56

contributor_license_agreement_changed

Comhaontú ceadúnais ranníocóra athraithe

Athraíodh an comhaontú ceadúnais rannpháirtí.

57

screenshot_added

Cuireadh gabháil scáileáin leis

Bhí baint ag gabháil scáileáin le teaghrán.

58

screenshot_uploaded

Uaslódáladh gabháil scáileáin

Uaslódáladh íomhá scáileáin.

59

string_updated_in_the_repository

Teaghrán nuashonraithe sa stór

Athraíodh teaghrán agus sioncrónú á dhéanamh ón stór.

60

add-on_installed

Breiseán suiteáilte

Suiteáladh breiseán.

61

add-on_configuration_changed

Athraíodh cumraíocht an bhreiseáin

Athraíodh cumraíocht breiseáin.

62

add-on_uninstalled

Breiseán díshuiteáilte

Díshuiteáladh breiseán.

63

string_removed

Teaghrán bainte

Baineadh teaghrán as aistriúchán.

64

comment_removed

Baineadh an nóta tráchta

Baineadh trácht teaghráin.

65

comment_resolved

Trácht réitithe

Marcáladh trácht teaghráin mar réitithe.

66

explanation_updated

Míniú nuashonraithe

Nuashonraíodh an míniú ar theaghrán foinse.

67

category_removed

Baineadh an chatagóir

Baineadh catagóir comhpháirte.

68

category_renamed

Athainmníodh an chatagóir

Athainmníodh catagóir comhpháirte.

69

category_moved

Bogadh an chatagóir

Bogadh catagóir comhpháirte.

70

saving_string_failed

Theip ar shábháil teaghrán

Níorbh fhéidir le Weblate teaghrán athraithe a shábháil.

71

string_added_in_the_repository

Teaghrán curtha leis sa stór

Fuarthas teaghrán nua agus sioncrónú á dhéanamh ón stór.

72

string_updated_in_the_upload

Nuashonraíodh an teaghrán sa uaslódáil

Athraíodh teaghrán agus comhad uaslódáilte á phróiseáil.

73

string_added_in_the_upload

Teaghrán curtha leis san uaslódáil

Fuarthas teaghrán nua agus comhad uaslódáilte á phróiseáil.

74

translation_updated_by_source_upload

Aistriúchán nuashonraithe ag foinse uaslódáil

Sioncrónaíodh aistriúchán tar éis comhad foinse a uaslódáil.

75

component_translation_completed

Aistriú comhpháirte críochnaithe

Aistríodh gach aistriúchán teanga i gcomhpháirt go hiomlán tar éis eagarthóireacht aonair. Ní astaíonn aistriúchán uathoibríoch, uaslódálacha ná eagarthóireachtaí mórchóir an teagmhas seo.

76

applied_enforced_check

Seice forfheidhmithe curtha i bhfeidhm

Marcáladh aistriúchán mar aistriúchán a raibh gá le heagarthóireacht air trí sheiceáil éigeantach.

77

propagated_change

Athrú iomadaithe

Cuireadh eagarthóireacht aistriúcháin ar aghaidh chuig teaghrán meaitseála eile.

78

file_uploaded

Comhad uaslódáilte

Uaslódáladh comhad chuig aistriúchán.

79

extra_flags_updated

Bratacha breise nuashonraithe

Nuashonraíodh bratacha breise teaghrán foinse.

80

font_uploaded

Cló uaslódáilte

Uaslódáladh cló.

81

font_changed

Athraíodh an cló

Athraíodh cló uaslódáilte.

82

font_removed

Cló bainte

Baineadh cló uaslódáilte.

83

forced_synchronization_of_translations

Sioncrónú éigeantach aistriúcháin

Rinneadh sioncrónú foréigneach ar na comhaid aistriúcháin leis an stórlann.

84

forced_rescan_of_translations

Athscanadh éigeantach ar aistriúcháin

Rinneadh athscanadh foréigneach ar na comhaid aistriúcháin le haghaidh athruithe.

85

screenshot_removed

Baineadh an scáileán

Baineadh pictiúr scáileáin.

86

label_added

Lipéad curtha leis

Cuireadh lipéad le teaghrán.

87

label_removed

Lipéad bainte

Baineadh lipéad as teaghrán.

88

repository_cleanup

Glanadh stórais

Glanadh suas crann oibre an stórais.

89

source_string_added_in_the_upload

Teaghrán foinse curtha leis san uaslódáil

Cuireadh teaghrán foinse leis agus comhad uaslódáilte á phróiseáil.

90

source_string_added_in_the_repository

Teaghrán foinse curtha leis an stórlann

Cuireadh teaghrán foinse leis agus sioncrónú á dhéanamh ón stór.

91

project_backed_up

Cúltaca déanta den tionscadal

Cruthaíodh cúltaca tionscadail.

92

project_restored

Athchóirithe tionscadail

Athchóiríodh tionscadal ó chúltaca.

93

component_restored

Comhpháirt athchóirithe

Athchóiríodh comhpháirt ó chúltaca.

94

user_edit_reverted

Eagarthóireacht úsáideora curtha ar ais

Cuireadh na heagarthóireachtaí uile a roghnaigh úsáideoir ar ceal.

95

project_setting_changed

Athraíodh socruithe tionscadail

Athraíodh socrú tionscadail.

96

component_setting_changed

Athraíodh socrú na comhpháirte

Athraíodh socrú comhpháirte.

97

user_access_changed

Athraíodh rochtain úsáideora

Athraíodh ceadanna rochtana úsáideora.

98

workspace_created

Spás oibre cruthaithe

Cruthaíodh spás oibre.

99

workspace_setting_changed

Athraíodh socruithe an spáis oibre

Athraíodh socrú spás oibre.

100

project_moved

Tionscadal bogtha

Bogadh tionscadal isteach i spás oibre nó amach as.

101

remote_repository_updated

Nuashonraithe ar an stór iargúlta

Críochnaíodh nuashonrú stórais iargúlta.

102

remote_repository_update_failed

Theip ar nuashonrú stórais iargúlta

Theip ar stór iargúlta a nuashonrú.

103

alert_dismissed

Foláireamh curtha ar ceal

Cuireadh foláireamh comhpháirte ar ceal.

104

alert_reopened

Foláireamh athoscailte

Athosclaíodh foláireamh comhpháirte tar éis a chomhthéacs a athrú.

Liosta breiseán a shaincheapadh

Tá liosta na mbreiseán cumraithe ag WEBLATE_ADDONS. Chun breiseán eile a chur leis, níl le déanamh ach ainm an ranga a chur san áireamh sa socrú seo.

Breiseán scríofa

Is féidir leat do bhreiseáin féin a scríobh freisin, fo-aicme de weblate.addons.base.BaseAddon a chruthú chun meiteashonraí na mbreiseán a shainiú, agus ansin glao ar ais a chur i bhfeidhm chun an phróiseáil a dhéanamh.

Scripteanna a rith ón mbreiseán

Is féidir breiseáin a úsáid freisin chun scripteanna seachtracha a rith. Ba ghnách é seo a chomhtháthú le Weblate, ach anois caithfidh tú cód éigin a scríobh chun do script a fhilleadh le breiseán.

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

"""Example pre commit script."""

from __future__ import annotations

from typing import ClassVar

from django.utils.translation import gettext_lazy

from weblate.addons.events import AddonEvent
from weblate.addons.scripts import BaseScriptAddon


class ExamplePreAddon(BaseScriptAddon):
    # Event used to trigger the script
    events: ClassVar[set[AddonEvent]] = {
        AddonEvent.EVENT_PRE_COMMIT,
    }
    # Name of the addon, has to be unique
    name = "weblate.example.pre"
    # Verbose name and long description
    verbose = gettext_lazy("Execute script before commit")
    description = gettext_lazy("This add-on executes a script.")

    # Script to execute
    script = "/bin/true"
    # File to add in commit (for pre commit event)
    # does not have to be set
    add_file = "po/{{ language_code }}.po"

Le haghaidh treoracha suiteála féach Custom quality checks, add-ons, translation services and auto-fixes.

Déantar an script a fhorghníomhú agus an t-eolaire reatha socraithe ag fréamh an stór VCS d'aon chomhpháirt ar leith.

Ina theannta sin, tá na hathróga timpeallachta seo a leanas ar fáil:

WL_VCS

Córas rialaithe leagan a úsáidtear.

WL_REPO

URL stór in aghaidh an tsrutha.

WL_PATH

Conair iomlán chuig stór VCS.

WL_BRANCH

Brainse stórtha cumraithe sa chomhpháirt reatha.

WL_FILEMASK

Masc comhaid don chomhpháirt reatha.

WL_TEMPLATE

Ainm comhaid an teimpléid le haghaidh aistriúcháin aonteangacha (is féidir iad a bheith folamh).

WL_NEW_BASE

Ainm comhaid an chomhaid a úsáidtear chun aistriúcháin nua a chruthú (is féidir iad a bheith folamh).

WL_FILE_FORMAT

Formáid comhaid a úsáidtear sa chomhpháirt reatha.

WL_LANGUAGE

Teanga an aistriúcháin atá próiseáilte faoi láthair (níl ar fáil le haghaidh crúcaí ar leibhéal na gcomhpháirteanna).

WL_PREVIOUS_HEAD

CEANN roimhe seo tar éis nuashonrú (ar fáil ach amháin tar éis an hook iar-nuashonraithe a rith).

WL_COMPONENT_SLUG

Seilide comhpháirte a úsáidtear chun URL a chruthú.

WL_PROJECT_SLUG

Seilide tionscadail a úsáideadh chun URL a chruthú.

WL_COMPONENT_NAME

Ainm na comhpháirte.

WL_PROJECT_NAME

Ainm an tionscadail.

WL_COMPONENT_URL

URL na Comhpháirte.

WL_ENGAGE_URL

URL gabháil leis an tionscadal.

Próiseáil stórtha iar-nuashonraithe

Is féidir é a úsáid chun comhaid aistriúcháin a nuashonrú nuair a athraíonn foinse réamhtheachtacha an VCS. Chun é seo a bhaint amach, cuimhnigh le do thoil nach bhfeiceann Weblate ach comhaid tiomanta don VCS, mar sin ní mór duit athruithe a dhéanamh mar chuid den script.

Mar shampla le Gulp is féidir leat é a dhéanamh ag baint úsáide as an gcód seo a leanas:

#! /bin/sh
gulp --gulpfile gulp-i18n-extract.js
git commit -m 'Update source strings' src/languages/en.lang.json

Próiseáil aistriúcháin a réamhghealladh

Bain úsáid as an script tiomnaithe chun aistriúchán a athrú go huathoibríoch sula gcuirfear sa stór é.

Cuirtear ar aghaidh é mar pharaiméadar amháin ina bhfuil ainm comhaid an aistriúcháin reatha.

Logánú gníomhaíochta breiseán

Coinníonn loga gníomhaíochta na mbreiseán súil ar fheidhmiú an bhreiseáin agus is féidir é a úsáid chun súil a choinneáil ar ghníomhaíocht na mbreiseán.

Taifeadann gach iontráil cibé an bhfuil an phróiseáil ar feitheamh, rathúil, teipthe, nó scipeáilte. Áirítear sna hiontrálacha scipeáilte an chúis nár rith an breiseán, amhail comhpháirt neamh-chomhoiriúnach, gan aon athruithe ábhartha, nó sceideal cumraithe nach bhfuil dlite fós. Is féidir le hiontráil rathúil a chiallaíonn fós gur sheiceáil an breiseán a ionchur ach nach bhfuair sé aon rud le hathrú.

I gcás breiseáin ar fud an raoin feidhme a phróiseálann comhpháirteanna go neamhspleách, bíonn iontráil ar leithligh sa log gníomhaíochta do gach comhpháirt.

Is féidir na logaí a ghearradh tar éis eatramh ama áirithe trí ADDON_ACTIVITY_LOG_EXPIRY a chumrú.