Dodaci

Add-ons provide ways to customize and automate the translation workflow. Admins can add and manage add-ons from the Operations ↓ Add-ons menu of each respective translation project or component. Add-ons can be also installed site-wide in Management interface.

Savjet

You can also configure add-ons using API, DEFAULT_ADDONS, or install_addon.

Add-ons that opt in to manual triggering can be run from add-on management or using the API. Results are recorded in the add-on activity log.

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 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. Grant add-on management permissions only to users trusted with the add-on’s complete input and effect scope. See Opseg timova and Ograničen pristup.

../_images/addons.webp

Events that trigger add-ons

Add-on installation

Triggered when add-on is being installed.

Component update

Pokreće se kad god se dogodi promjena u komponenti kao što je:

  • Izrazi su promijenjeni u repozitoriju.

  • Dodan je jedan izraz.

  • Dodan je jedan novi prijevod.

Dnevno

Pokreće se svakodnevno, ali dodaci obično dijele dnevno opterećenje između komponenti ovisno o BACKGROUND_TASKS.

Promjena događaja

Pokreće se nakon što se stvori događaj promjene.

Manual trigger

Triggered when an add-on is run manually from add-on management or the API.

Repository post-add

Triggered just after the new translation is added and committed.

Repository post-commit

Triggered just after the changes are committed.

Repository post-push

Triggered just after the repository is pushed upstream.

Repository post-remove

Triggered just after a translation is removed.

Repository post-update

Triggered whenever new changes are pulled from the upstream repository.

Repository pre-commit

Triggered just before the changes are committed.

Repository pre-push

Triggered just before the repository is pushed upstream.

Repository pre-update

Triggered just before the repository update is attempted.

Unit post-save

Triggered just after the string is saved.

Unit post-sync

Triggered after the string is synchronized with the VCS.

Unit pre-create

Triggered just after the newly created string is saved.

Ugrađeni dodaci

Evaluacija kvalitete umjetne inteligencije

ID dodatka:

weblate.ai.quality

Konfiguracija:

service

Usluga evaluacije

Dostupne mogućnosti:

anthropic

Anthropic

openai

OpenAI

mistral

Mistral

ollama

Ollama

azure-openai

Azure OpenAI

q

Upit

interval

Učestalost evaluacija

Dostupne mogućnosti:

disabled

Deaktivirano

daily

Dnevno

weekly

Tjedno

monthly

Mjesečno

on_change

Evaluiraj promjene prijevoda

on_update

Evaluiraj aktualiziranja repozitorija

Triggers:

Add-on installation, Component update, Dnevno, Promjena događaja, Manual trigger

Evaluira postojeće prijevode pomoću LLM-a i bilježi provjere kvalitete.

This add-on evaluates existing translations using an LLM service configured under Automatski prijedlozi. 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 Dodaci permissions and validation.

Automation

Added in version 2026.10.

ID dodatka:

weblate.automation.automation

Konfiguracija:

workflow

Radni tok

Enter an automation definition as YAML or JSON.

Triggers:

Component update, Dnevno, Promjena događaja, Manual trigger, Repository post-commit, Repository post-push, Repository post-update

Runs ordered translation operations with conditions and branches.

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.

Više informacija

Automatsko prevođenje

ID dodatka:

weblate.autotranslate.autotranslate

Konfiguracija:

mode

Modus automatskog prevođenja

Dostupne mogućnosti:

suggest

Dodaj kao prijedlog

translate

Dodaj kao prijevod

fuzzy

Dodaj kao „Treba urediti”

approved

Dodaj kao odobreni prijevod

q

Upit

Imaj na umu da će prevođenje svih izraza odbaciti sve postojeće prijevode.

auto_source

Izvor automatskih prijevoda

Dostupne mogućnosti:

others

Ostale prevodilačke komponente

mt

Strojno prevođenje

component

Komponenta

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

Uređaji za strojno prevođenje

Uređaji za strojno prevođenje

threshold

Prag rezultata

Triggers:

Add-on installation, Component update, Dnevno, Promjena događaja

Automatski prevodi izraze koristeći strojno prevođenje ili druge komponente.

To control translation order, use the Automation 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 Prioritet usluga za strojno prevođenje i prevodilačku memoriju; installation order of separate add-ons does not define an execution sequence.

JavaScript mreža za dostavljanje sadržaja (CDN) lokalizacije

Added in version 4.2.

ID dodatka:

weblate.cdn.cdnjs

Konfiguracija:

threshold

Prag prijevoda

Postotak prevedenih izraza koji moraju biti prisutni da bi se prijevod uključio.

css_selector

CSS selektor

CSS selektor za otkrivanje lokalizirajućih elemenata.

cookie_name

Ime kolačića jezika

Ime kolačića koji sprema postavke jezika.

files

Izvuci izraze iz HTML datoteka

Popis datoteka u trenutačnom repozitoriju ili udaljenim URL adresama koje se analiziraju za prevodivim izrazima.

Triggers:

Add-on installation, Dnevno, Repository post-commit, Repository post-remove, Repository post-update

Objavljuje prijevode u mrežu za isporuku sadržaja (CDN) za upotrebu u JavaScriptu ili HTML lokalizaciji.

Can be used to localize static HTML pages, or to load localization in the JavaScript code.

Generates a unique URL for your component you can include in HTML pages to localize them. See Prevođenje HTML-a i JavaScripta pomoću Weblate CDN-a for more details.

Napomena

This add-on requires additional configuration on the Weblate server. LOCALIZE_CDN_PATH configures where generated files will be written (on a filesystem), and LOCALIZE_CDN_URL defines where they will be served (URL). Serving of the files is not done by Weblate and has to be set up externally (typically using a CDN service).

Ovaj je dodatak konfiguriran na Hosted Weblate i poslužuje datoteke preko https://weblate-cdn.com/.

Translation files CDN

Added in version 2026.5.

ID dodatka:

weblate.cdn.files

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Component update, Repository post-commit, Repository post-remove, Repository post-update

Objavljuje prevodilačke datoteke u mrežu za isporuku sadržaja (CDN).

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 Mreža za dostavljanje sadržaja (CDN) lokalizacije for secure serving guidance.

Kotlin SDK CDN

Added in version 2026.10.

ID dodatka:

weblate.cdn.kotlin

Konfiguracija:

maximum_age

Maximum build age (days)

Retires builds this many days after their first registration. Re-registering a build does not extend its age.

maximum_versions

Maximum retained versions

Limits retained builds across all package names. A build is retired when either this limit or the maximum age is reached.

Triggers:

Add-on installation, Component update, Dnevno, Repository post-commit, Repository post-remove, Repository post-update

Publishes Android string and plural resources for registered Kotlin SDK builds.

Upozorenje

The Kotlin SDK API is in beta. 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.

Copy the Gradle plugin configuration from the add-on configuration page. It includes the Weblate server URL, public CDN URL, 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 Tokeni za pristup projektima. 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 the Kotlin SDK repository.

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 Mreža za dostavljanje sadržaja (CDN) lokalizacije 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.

Ukloni prazne izraze

Added in version 4.4.

ID dodatka:

weblate.cleanup.blank

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Repository post-commit, Repository post-update

Uklanja neprevedene izraze iz provodilačke datoteke.

Koristi ovo kako u prevodilačkim datotekama ne bi bilo praznih izraza (na primjer, ako ih tvoja biblioteka lokalizacije prikazuje kao nedostajuće umjesto da koristi izvorni izraz).

Počisti prevodilačke datoteke

ID dodatka:

weblate.cleanup.generic

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Repository post-update, Repository pre-commit

Aktualiziraj sve prevodilačke datoteke kako bi se podudarale s jednojezičnom osnovnom datotekom. Za većinu datotečnih formata to znači uklanjanje prevedenih izraza koji više nisu prisutni u osnovnoj datoteci.

For formats containing additional content besides translation strings (such as HTML datoteke, Windows RC datoteke, or OpenDocument format) this also brings the translation file in sync with the base file.

For a one-time cleanup of a single translation file, use Cleanup unused in Održavanje repozitorija on that translation instead of installing the add-on.

Dodaj nedostajuće jezike

ID dodatka:

weblate.consistency.languages

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Dnevno, Repository post-add

Osigurava korištenje dosljednog skupa jezika za sve komponente u projektu.

Napomena

The components shared from other projects are not considered in this.

Nedostajući jezici se provjeravaju svaka 24 sata i kada se u Weblate dodaju novi jezici.

Za razliku od većine drugih dodataka, ovaj dodatak utječe na cijeli projekt.

Savjet

Automatski prevedi novo dodane izraze s Automatsko prevođenje.

Otkrivanje komponenti

ID dodatka:

weblate.discovery.discovery

Konfiguracija:

match

Regularni izraz za usporedbu s prevodilačkim datotekama

The regular expression must define a named group for component. Also define a named group for language when matching translation files. When the file mask is set, omit language and match the monolingual base or new base file instead.

file_format

Format datoteke

Format datoteke

name_template

Prilagodi ime komponente

Use Django template syntax. This template must include {{ component }}.

base_file_template

Odredi ime osnovne jednojezične datoteke

Leave empty for bilingual translation files. When set, this template must include {{ component }}.

new_base_template

Odredi osnovnu datoteku za nove prijevode

Filename of file used for creating new translations. For gettext choose .pot file. This template must include {{ component }}.

intermediate_template

Datoteka posrednog jezika

Filename of intermediate translation file. In most cases this is a translation file provided by developers and is used when creating actual source strings. This template must include {{ component }}.

filemask_template

Definiraj masku datoteke

Leave empty to match translation files directly. When set, discovery matches the monolingual base or new base file and uses this template as the file mask. Include a language wildcard and {{ component }}, for example locale//{{ component }}.po or docs/{{ component }}_.md.

language_regex

Filtar jezika

Regularni izraz za filtriranje prevodilačkih datoteka prilikom traženja maske datoteke.

copy_addons

Kloniraj dodatke iz glavne komponente u novo stvorene

remove

Ukloni komponente za nepostojeće datoteke

Triggers:

Add-on installation, Repository post-update

Automatski dodaje ili uklanja komponente projekta na temelju promjena datoteka u sustavu za kontrolu verzija.

The matching is done using regular expressions enabling complex configuration, but some knowledge is required to do so. Usually the regular expression to match translation files has to contain two named groups to match component and language. When creating components from a monolingual base or new base file, omit the language group and match that source file instead. All named groups in the regular expression can be used as variables in the template fields.

Discovery requirements

To discover a component successfully, the configuration has to do all of the following:

  • The regular expression must define a component named group. Matching translation files also requires a language named group.

  • Template fields used to name or locate per-component files must include {{ component }}, so the rendered value actually changes for each discovered component.

  • For monolingual formats, the component must contain a file matching base_file_template and at least one translation file matching match, unless you set the file mask (see below).

Discovering components without translation files

Set Define the file mask to discover components from a monolingual base or new base file alone, even when no translation files exist yet. In that mode:

  • Configure Regular expression to match translation files against to match the monolingual base or new base file, and omit the language group. Keep full control over the component capture, for example locale/(?P<component>[^/]+)\.pot or docs/(?P<component>[^/_]+)\.md.

  • Fill Define the file mask with a path that includes both a language wildcard and {{ component }}, for example locale/*/{{ component }}.po or docs/{{ component }}_*.md.

  • Keep using the other filename templates with any named groups from the match expression.

Worked example: news_<lang>.md

This is a common filename-based language variant layout:

  • docs/news_en.md

  • docs/news_cs.md

  • docs/guide_en.md

Use the Filename-based language variants preset for a starting point, then choose the matching file format and review the populated values.

Regularni izraz:

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

Ime komponente:

{{ component }}

Otkrivene maske datoteka:
  • docs/news_*.md

  • docs/guide_*.md

In this example, {{ component }} resolves to the basename before the language suffix, so docs/news_en.md, docs/news_pt_BR.md, and docs/news_pt-BR.md all become the news component.

Označavanje Django predložaka možeš koristiti u svim poljima imena datoteke, na primjer:

{{ component }}

Component name parsed from the component match group

{{ component|title }}

Ime datoteke komponente s početnim velikim slovom

{{ path }}: {{ component }}

Custom match group from the regular expression

Once you hit Save, a preview of matching components will be presented, from where you can check whether the configuration actually matches your needs:

../_images/addon-discovery.webp

Primjeri otkrivanja komponenti

The worked example above covers the most common filename-based variant layout. The following examples show other repository structures you can match.

Pojedinačne mape za jezike

Jedna mapa za svaki jezik, koja sadrži prevodilačke datoteke za komponente.

Regularni izraz:

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

Podudarajuće datoteke:
  • cs/application.po

  • cs/website.po

  • de/application.po

  • de/website.po

Gettext locales layout

Uobičajena struktura za spčremanje gettext PO datoteka.

Regularni izraz:

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

Podudarajuće datoteke:
  • locale/cs/LC_MESSAGES/application.po

  • locale/cs/LC_MESSAGES/website.po

  • locale/de/LC_MESSAGES/application.po

  • locale/de/LC_MESSAGES/website.po

Complex filenames

Upotreba imena komponente i jezika za ime datoteke.

Regularni izraz:

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

Podudarajuće datoteke:
  • src/locale/application.cs.po

  • src/locale/website.cs.po

  • src/locale/application.de.po

  • src/locale/website.de.po

Ponavljajući jezični kodovi

Upotreba jezika za stazu i ime datoteke.

Regularni izraz:

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

Podudarajuće datoteke:
  • locale/cs/application/cs.po

  • locale/cs/website/cs.po

  • locale/de/application/de.po

  • locale/de/website/de.po

Rastavljanje Android izraza

Izrazi resursa za Android, rastavljeni u nekoliko datoteka.

Regularni izraz:

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

Podudarajuće datoteke:
  • res/values-cs/strings-about.xml

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

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

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

Podudaranje više staza

Višemodulni projekt Maven s prijevodima Java svojstava.

Regularni izraz:

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

Ime komponente:

{{ originalHierarchy }}: {{ component }}

Podudarajuće datoteke:
  • 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

Savjet

Component discovery add-on uses Weblate interni URL-ovi. It’s a convenient way to share VCS setup between multiple components. Linked components use the local repository of the main component set up by filling weblate://project/main-component into the Repozitorij izvornog koda field (in Operations ↓ Settings ↓ Version control system) of each respective component. This saves time with configuration and system resources too.

Savjet

Ensure the new component contains the full set of translatable languages with Dodaj nedostajuće jezike.

Fedora Messaging

Added in version 5.15.

ID dodatka:

weblate.fedora_messaging.publish

Konfiguracija:

amqp_url

AMQP broker URL

The AMQP broker URL to connect to.

topic_prefix

Topic prefix

Optional prefix to prepend to generated message topics.

publish_timeout

Publish timeout

How many seconds to wait for the broker delivery acknowledgement.

connection_attempts

Connection attempts

How many times to try connecting to the broker.

retry_delay

Retry delay

How many seconds to wait between connection attempts.

ca_cert

CA certificate bundle (PEM)

Paste only PEM certificate blocks, each starting with „—–BEGIN CERTIFICATE—–” and ending with „—–END CERTIFICATE—–„.

client_key

Client private key (PEM)

Paste a single unencrypted PEM private key block. Encrypted private keys are not supported.

client_cert

Client certificate (PEM)

Paste only the PEM certificate block starting with „—–BEGIN CERTIFICATE—–”; do not paste the output from „openssl x509 -text”.

event_filter

Change events to trigger

Choose which change events should trigger this add-on. Change events to trigger

events

Selected change events

Selected change events

Triggers:

Promjena događaja

Šalje obavijesti u AMQP protokolu koji je kompatibilna s Fedora Messaging sustavom.

Fedora Messaging is AMQP-based publisher for all changes happening in Weblate. You can hook additional services on changes happening in Weblate using this.

Message topic

All messages have topic weblate.<action>.<project>.<category...>.<component>.<translation>. When configured, topic_prefix is prepended to this topic using a single dot separator, for example org.fedoraproject.weblate.project_backed_up.website. The action is lowercase textual representation of action with underscores instead of space, for example resource_updated; see Selected change events for all action identifiers. The remaining parts match Weblate object path segments.

For example, a project backup event for the website project uses weblate.project_backed_up.website. A translation change in the website project, frontend component, and Czech translation uses weblate.translation_changed.website.frontend.cs. The same change in the frontend component inside the parent and child categories uses weblate.translation_changed.website.parent.child.frontend.cs.

Message body

The body consists of following fields (given that they are available for the event):

change_id

Numerical ID of change

action

Potpuno ime promjene.

timestamp

ISO formatirana vremenska oznaka

target

Nova vrijednost promjene (npr. novi prijevod izraza)

old

Stara vrijednost promjene (npr. prijašnji prijevod izraza)

source

Izvorni izraz.

url

Apsolutni URL za prikaz povezanog objekta.

author

Author username (this can be different from user for example when accepting suggestions)

user

Acting username

project

URL identifikator projekta

component

Identifikator komponente

translation

Jezični kod prijevoda

Zaglavlje poruke

Postoje i dodatna zaglavlja koja se mogu koristiti za usmjeravanje:

action

Potpuno ime promjene.

project

URL identifikator projekta

component

Identifikator komponente

Primjeri poruka

Događaj sjedinjavanja repozitorija:

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

Događaj novog izvornog izraza:

{
  "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"]
}

Događaj aktualiziranja resursa:

{
  "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"
}

Događaj uklanjanja projekta:

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

Događaj novog doprinositelja:

{
  "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"]
}

Događaj novog prijevoda:

{
  "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"]
}

Skupno uređivanje

ID dodatka:

weblate.flags.bulk

Konfiguracija:

q

Upit

state

Stanje za postavljanje

Dostupne mogućnosti:

-1

Ne mijenjaj

10

Treba urediti

11

Treba urediti (Treba prepraviti)

12

Treba urediti (Treba provjeriti)

20

Prevedeno

30

Odobreno

add_flags

Source flags to add — all languages

remove_flags

Source flags to remove — all languages

add_translation_flags

Translation flags to add — matching translations

Applies only to matching translations, excluding source strings.

remove_translation_flags

Translation flags to remove — matching translations

Removes locally set flags. Inherited flags remain in effect.

add_labels

Labels to add — all languages

remove_labels

Labels to remove — all languages

Triggers:

Add-on installation, Component update

Skupno uređivanje oznaka, etiketa ili stanja izraza.

Primjeri:

Automatski označi nove izraze

Upit u polju pretrage

NOT has:label

Etikete za dodavanje

nedavni

Označavanje svih App store datoteke metapodataka izraza u dnevniku promjena kao samo-za-čitanje

Upit u polju pretrage

language:en AND key:changelogs/

Prevodilačke oznake za dodavanje

read-only

Označavanje određenih izraza kao samo-za-čitanje

Upit u polju pretrage

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

Prevodilačke oznake za dodavanje

read-only

Označi nepromijenjene prijevode s oznakom „Treba preraditi”

ID dodatka:

weblate.flags.same_edit

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Unit pre-create

Kad god se uveze novi prevodiv izraz iz sustava za kontrolu verzija koji se poklapa s izvornim izrazom, on se u Weblateu označava s oznakom da ga se treba preraditi. To je naročito korisno za datotečne formate koji uključuju neprevedene izvorne izraze.

Savjet

You might also want to tighthen the Nepromijenjen prijevod check by adding strict-same flag to Prevodilačke oznake.

Više informacija

Translation states

Označi nove izvorne izraze s oznakom „Treba pregledati”

ID dodatka:

weblate.flags.source_edit

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Unit pre-create

Kada god se uveze novi izvorni izraz iz sustava za kontrolu verzija, on se u Weblateu označava s oznakom da ga se treba provjeriti. Na taj način možeš jednostavno filtrirati i urediti izvorne izraze koje su napisali programeri.

Više informacija

Translation states

Označi nove prijevode s oznakom „Treba preraditi”

ID dodatka:

weblate.flags.target_edit

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Unit pre-create

Kada god se uveze novi prevodiv izraz iz sustava za kontrolu verzija, on se u Weblateu označava s oznakom da ga se treba preraditi. Na taj način možeš jednostavno filtrirati i urediti prijevode koje su napisali programeri.

Više informacija

Translation states

Označi aktualizirane prijevode iz ropozitorija s oznakom „Treba preraditi”

ID dodatka:

weblate.flags.target_repo_update

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Unit post-sync

Kada god se promijeni prijevod izraza iz sustava za kontrolu verzija, on se u Weblateu označava s oznakom da ga se treba preraditi. Posebno korisno ako se prevodilačke datoteke često aktualiziraju ručno ili putem eksterne usluge.

Više informacija

Translation states

Ispuni izraze samo-za-čitanje s izvorom

Added in version 4.18.

ID dodatka:

weblate.generate.fill_read_only

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Component update, Dnevno

Ispunjava prijevode izraza samo-za-čitanje s izvornim izrazom.

Generator statistike

ID dodatka:

weblate.generate.generate

Konfiguracija:

scope

Output scope

Dostupne mogućnosti:

translation

One file per translation

component

One file per component

filename

Ime stvorene datoteke

template

Sadržaj stvorene datoteke

Triggers:

Add-on installation, Component update, Repository post-add, Repository post-remove, Repository pre-commit

Izrađuje datoteku s detaljnim podatcima o stanju prijevoda.

Django predložak možeš koristiti u imenu datoteke i u sadržaju. Pogledaj Označavanje u predlošcima za detaljan opis označavanja.

Na primjer, generiranje datoteke sažetka za svaki prijevod:

Ime stvorene datoteke

locale/{{ language_code }}.json

Sadržaj
{
   "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.

Više informacija

Označavanje u predlošcima

Unaprijed ispuni prijevod s izvorom

Added in version 4.11.

ID dodatka:

weblate.generate.prefill

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Component update, Dnevno

Ispunjava prevodilačke izraze s izvornim izrazom.

All untranslated strings in the component will be filled with the source string, and marked as needing edit. Use this when you can not have empty strings in the translation files. .. AUTOGENERATED START: weblate.generate.pseudolocale .. This section is automatically generated by ./manage.py list_addons. Do not edit manually.

Izrada pseudolokalnog prijevoda

Added in version 4.5.

ID dodatka:

weblate.generate.pseudolocale

Konfiguracija:

source

Izvorni izrazi

target

Ciljani prijevod

Svi izrazi u ovom prijevodu će se prepisati

prefix

Dodan statični tekst na početku

var_prefix

Dodan varijabilni tekst na početku

suffix

Dodan statični tekst

var_suffix

Dodan varijabilni tekst

var_multiplier

Multiplikator varijabilnog teksta

Koliko puta ponoviti varijabilni tekst ovisno o duljini izvornog izraza.

include_readonly

Uključi izraze samo-za-čitanje

Triggers:

Add-on installation, Component update, Dnevno

Generira prijevod, automatski dodajući prefiks i sufiks izvornim izrazima.

Pseudolocales are useful to find strings that are not prepared for localization. This is done by altering all translatable source strings to make it easy to spot unaltered strings when running the application in the pseudolocale language.

Finding strings whose localized counterparts might not fit the layout is also possible.

Using the variable parts makes it possible to look for strings which might not fit into the user interface after the localization - it extends the text based on the source string length. The variable texts are repeated by length of the text multiplied by the multiplier. For example Hello world with variable text _ and variable multiplier of 1 becomes Hello world___________ - the text is repeated once for each character in the source string.

Izrazi će se izraditi koristeći sljedeći uzorak:

Prepended static text Prepended variable text Source string Appended variable text Appended static text

Savjet

You can use real languages for testing, but there are dedicated pseudolocales available in Weblate - en_XA and ar_XB.

Savjet

You can use this add-on to start translation to a new locale of an existing language or similar language. Once you add the translation to the component, follow to the add-on. Example: If you have fr and want to start fr_CA translation, simply set fr as the source, fr_CA as the target, and leave the prefix and suffix blank.

Uninstall the add-on once you have the new translation filled to prevent Weblate from changing the translations made after the copying.

Aktualiziraj ALL_LINGUAS varijablu u „configure” datoteci

ID dodatka:

weblate.gettext.configure

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Dnevno, Repository post-add, Repository post-remove

Updates the ALL_LINGUAS variable in „configure”, „configure.in” or „configure.ac” files, when a translation is added or removed.

Updates the ALL_LINGUAS variable in configure, configure.in or any configure.ac files, when a translation is added or removed.

Prilagodi gettext rezultat

Removed in version 5.13: Zamijenjeno s Parametri formata datoteke.

Aktualiziraj gettext predložak (Django)

Added in version 5.17.

ID dodatka:

weblate.gettext.django

Konfiguracija:

interval

Učestalost aktualiziranja

Koliko često dodatak treba aktualizirati POT datoteku kada se komponenta osvježi.

Dostupne mogućnosti:

daily

Dnevno

weekly

Tjedno

monthly

Mjesečno

normalize_header

Normaliziraj POT zaglavlje

Updates gettext headers and replaces placeholder POT comments.

location_mode

Source locations

Choose how extraction writes source locations to the POT file. Use this to keep locations in the template while omitting them from translated PO files.

Dostupne mogućnosti:

file

Use file format settings

keep

Extract locations to the POT file

omit

Do not extract locations

Triggers:

Add-on installation, Manual trigger, Repository post-update

Aktualizira gettext predložak pomoću Django-ove ugrađene naredbe makemessages.

This add-on updates the template configured in Predložak za nove prijevode. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Aktualiziraj PO datoteke za poklapanje s POT datotekom (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

Django requirements

This add-on requires xgettext and msguniq. It runs Weblate’s internal extraction wrapper for Django messages instead of invoking a project’s manage.py makemessages, so it does not load project Django settings or applications.

The template for new translations must use the django or djangojs domain. Supported template names are django.pot, djangojs.pot, django.po, and djangojs.po. Weblate infers the source directory from the template path and skips repository locale directories while extracting.

Aktualiziraj LINGUAS datoteku

ID dodatka:

weblate.gettext.linguas

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Dnevno, Repository post-add, Repository post-remove

Updates the LINGUAS file when a translation is added or removed.

Aktualiziraj POT datoteku (Meson)

Added in version 5.17.

ID dodatka:

weblate.gettext.meson

Konfiguracija:

interval

Učestalost aktualiziranja

Koliko često dodatak treba aktualizirati POT datoteku kada se komponenta osvježi.

Dostupne mogućnosti:

daily

Dnevno

weekly

Tjedno

monthly

Mjesečno

normalize_header

Normaliziraj POT zaglavlje

Updates gettext headers and replaces placeholder POT comments.

location_mode

Source locations

Choose how extraction writes source locations to the POT file. Use this to keep locations in the template while omitting them from translated PO files.

Dostupne mogućnosti:

file

Use file format settings

keep

Extract locations to the POT file

omit

Do not extract locations

data_dirs

ITS data directories

Newline-separated repository-relative directories containing an its subdirectory, for example po for po/its. Earlier directories override later directories and bundled rules.

comment_mode

Komentari o kodu

Choose whether xgettext should extract no comments, all comments, or only comments marked with a specific tag.

Dostupne mogućnosti:

off

Ne izdvajaj komentare

all

Izdvoji sve komentare

tagged

Izdvoji komentare s oznakom

comment_tag

Oznake komentara

Tag passed to xgettext for comment extraction when using tagged comment mode.

checks

xgettext provjere

Additional xgettext validation checks to enable for extracted messages.

Dostupne mogućnosti:

ellipsis-unicode

ellipsis-unicode

space-ellipsis

space-ellipsis

quote-unicode

quote-unicode

bullet-unicode

bullet-unicode

keyword

Additional keywords

Newline-separated extra keywords passed to xgettext using –keyword.

keyword_exclusive

Use keywords exclusively

When enabled, passes --keyword without a value to xgettext before the additional keyword, disabling all default keywords so that only the keyword specified above is recognized.

preset

Unaprijed postavljene postavke za Meson

Built-in xgettext argument preset matching Meson gettext integration. The GLib preset adds the keyword and format-flag options used by Meson’s gettext helper.

Dostupne mogućnosti:

glib

GLib

Triggers:

Add-on installation, Manual trigger, Repository post-update

Aktualizira gettext predložak koristeći Meson xgettext konvencije.

This add-on updates the template configured in Predložak za nove prijevode. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Aktualiziraj PO datoteke za poklapanje s POT datotekom (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

Meson requirements

This add-on requires xgettext; it does not invoke Meson. It follows Meson gettext conventions by reading POTFILES or POTFILES.in from the gettext directory and passing the GLib keyword and format-flag preset to xgettext.

The gettext directory is the directory containing the template configured in Predložak za nove prijevode. It must contain meson.build and POTFILES or POTFILES.in. A Meson project meson.build must be present in that directory or one of its parent directories. If both POTFILES and POTFILES.in exist, POTFILES is used. An adjacent POTFILES.skip excludes listed source files from extraction.

Configure this add-on from the existing Meson gettext setup. In most Meson projects, the gettext directory is po/, the template is named after the gettext domain, and po/meson.build calls Meson’s gettext helper. Use the same template path in Predložak za nove prijevode, for example po/example.pot, and keep POTFILES or POTFILES.in next to that meson.build file.

Weblate does not read the source file list from meson.build. It uses POTFILES or POTFILES.in, matching Meson’s gettext convention. When the Meson project uses a non-default gettext directory or domain, mirror that layout in the component template path.

Izradi MO datoteke

ID dodatka:

weblate.gettext.mo

Konfiguracija:

path

Staza stvorene MO datoteke

Ako nije zadano, koristit će se mjesto PO datoteke.

fuzzy

Uključi izraze koje treba urediti

Izrazi koji se trebaju urediti obično nisu gotovi prijevodi.

Triggers:

Repository pre-commit

Automatski izrađuje MO datoteku za svaku promijenjenu PO datoteku.

The location of the generated MO file can be customized and the field for it uses Označavanje u predlošcima.

Napomena

If a translation is removed, its PO file will be deleted from the repository, but the MO file generated by this add-on will not. The MO file must be removed from the upstream manually.

Aktualiziraj PO datoteke za poklapanje s POT datotekom (msgmerge)

Promijenjeno u verziji 5.13: Settings configuration has been moved to Parametri formata datoteke.

ID dodatka:

weblate.gettext.msgmerge

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Repository post-update

Aktualizira sve PO datoteke (kao što su konfigurirane u „Maska datoteke”) kako bi odgovarale POT datoteci (kao što je konfigurirana u „Predložak za nove prijevode”) pomoću msgmerge.

This add-on is essential when working with gettext PO files where the POT (template) file is updated with new strings or changes to existing strings. When the POT file is updated in the repository, this add-on automatically merges those changes into all language PO files, ensuring that:

  • New translatable strings appear in all languages

  • Uklonjeni izrazi su označeni kao zastarjeli

  • Modified strings are marked as needing review (fuzzy)

Most msgmerge command-line options can be set up through file format parameters configuration. Enable the po_remove_obsolete parameter to remove obsolete #~ entries when PO files are saved.

Aktualiziraj POT datoteku (Sphinx)

Added in version 5.17.

ID dodatka:

weblate.gettext.sphinx

Konfiguracija:

interval

Učestalost aktualiziranja

Koliko često dodatak treba aktualizirati POT datoteku kada se komponenta osvježi.

Dostupne mogućnosti:

daily

Dnevno

weekly

Tjedno

monthly

Mjesečno

normalize_header

Normaliziraj POT zaglavlje

Updates gettext headers and replaces placeholder POT comments.

location_mode

Source locations

Choose how extraction writes source locations to the POT file. Use this to keep locations in the template while omitting them from translated PO files.

Dostupne mogućnosti:

file

Use file format settings

keep

Extract locations to the POT file

omit

Do not extract locations

filter_mode

Filtriranje

Opcionalno ukloni izraze koji nisu korisni za prevođenje nakon izdvajanja Sphinxom.

Dostupne mogućnosti:

none

Nepoznato

weblate_docs

Weblate dokumentacija

Triggers:

Add-on installation, Manual trigger, Repository post-update

Aktualizira gettext predložak pomoću Sphinxovog gettext buildera bez učitavanja konfiguracije projekta.

This add-on updates the template configured in Predložak za nove prijevode. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Aktualiziraj PO datoteke za poklapanje s POT datotekom (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

Sphinx requirements

This add-on requires sphinx-build, provided by the sphinx installation extra. The template for new translations must be a .pot file below a locales directory. The directory before locales is used as the Sphinx source directory and must contain conf.py.

Extraction uses Weblate’s bundled Sphinx configuration and does not load the project configuration. Weblate runs the Sphinx gettext builder, normalizes source references to paths relative to the source directory, and copies the generated template back to the configured template path.

Aktualiziraj POT datoteku (xgettext)

Added in version 5.17.

ID dodatka:

weblate.gettext.xgettext

Konfiguracija:

interval

Učestalost aktualiziranja

Koliko često dodatak treba aktualizirati POT datoteku kada se komponenta osvježi.

Dostupne mogućnosti:

daily

Dnevno

weekly

Tjedno

monthly

Mjesečno

normalize_header

Normaliziraj POT zaglavlje

Updates gettext headers and replaces placeholder POT comments.

location_mode

Source locations

Choose how extraction writes source locations to the POT file. Use this to keep locations in the template while omitting them from translated PO files.

Dostupne mogućnosti:

file

Use file format settings

keep

Extract locations to the POT file

omit

Do not extract locations

data_dirs

ITS data directories

Newline-separated repository-relative directories containing an its subdirectory, for example po for po/its. Earlier directories override later directories and bundled rules.

comment_mode

Komentari o kodu

Choose whether xgettext should extract no comments, all comments, or only comments marked with a specific tag.

Dostupne mogućnosti:

off

Ne izdvajaj komentare

all

Izdvoji sve komentare

tagged

Izdvoji komentare s oznakom

comment_tag

Oznake komentara

Tag passed to xgettext for comment extraction when using tagged comment mode.

checks

xgettext provjere

Additional xgettext validation checks to enable for extracted messages.

Dostupne mogućnosti:

ellipsis-unicode

ellipsis-unicode

space-ellipsis

space-ellipsis

quote-unicode

quote-unicode

bullet-unicode

bullet-unicode

keyword

Additional keywords

Newline-separated extra keywords passed to xgettext using –keyword.

keyword_exclusive

Use keywords exclusively

When enabled, passes --keyword without a value to xgettext before the additional keyword, disabling all default keywords so that only the keyword specified above is recognized.

input_mode

Izvor unosa

Odaberi treba li xgettext čitati izvorne datoteke iz glob uzoraka ili iz manifesta POTFILES/POTFILES.in.

Dostupne mogućnosti:

patterns

Uzorci izvornih datoteka

potfiles

POTFILES manifest

language

xgettext jezik

Programming language passed to xgettext, for example Python or C. Leave blank to let xgettext guess the language from file extensions.

source_patterns

Uzorci izvornih datoteka

Novim redcima odvojeni glob uzorci relativni na repozitorij za datoteke koje se trebaju izdvojiti pomoću alata xgettext.

potfiles_path

POTFILES staza

Repository-relative path to POTFILES or POTFILES.in. Entries are resolved relative to the repository root. If present next to the manifest, POTFILES.skip excludes listed files from extraction.

Triggers:

Add-on installation, Manual trigger, Repository post-update

Aktualizira gettext predložak koristeći xgettext na odabranim izvornim datotekama.

This add-on updates the template configured in Predložak za nove prijevode. It is available for gettext PO components, and the component must define a template for new translations.

The selected update frequency applies to automatic runs after repository refreshes. Installing or reconfiguring the add-on runs it immediately, and manual runs from add-on management or the API also bypass the frequency schedule. After a successful update, Weblate commits the changed template and reloads source strings.

The template update does not update translation PO files by itself. Keep Aktualiziraj PO datoteke za poklapanje s POT datotekom (msgmerge) installed when translation files should follow template changes automatically. The install form for this add-on can install that add-on, but existing add-on settings do not show that installation option again.

xgettext requirements

This add-on requires xgettext. Configure either source file patterns or a POTFILES / POTFILES.in manifest. Source file patterns are repository-relative glob patterns and only matching repository files are passed to xgettext.

Entries in POTFILES or POTFILES.in are resolved relative to the repository root. They must be relative paths, stay inside the repository, and point to existing files. Blank lines and lines starting with # are ignored. If a POTFILES.skip file exists next to the manifest, its entries are excluded from extraction.

Automatic repository refresh runs are skipped unless the changed files match the configured source patterns, match files listed in the manifest, change a watched manifest, or change the add-on configuration.

Start from the build-system extraction setup when configuring this add-on. Autotools projects usually keep gettext inputs in po/POTFILES.in and options such as the gettext domain and xgettext flags in po/Makevars or related Makefile.am files. Use manifest mode with the same POTFILES.in when its entries are plain repository-relative source paths, and copy relevant extraction behavior into the add-on settings, for example the language, comment extraction, checks, and additional keyword.

For other build systems, use the source list or extraction command they already run as the source of truth. CMake, custom Makefiles, npm scripts, or project specific extraction scripts often call xgettext directly or generate an intermediate file list. Configure source patterns for simple layouts, or use manifest mode when the project maintains a plain file list. If a build-system manifest contains transformations or prefixes that are not file paths, convert it to plain repository-relative paths before using it as 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 Aktualiziraj POT datoteku (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.

Više informacija

GNU gettext ITS rules and locating rules.

Združi Git izmjene

ID dodatka:

weblate.git.squash

Konfiguracija:

squash

Spremi združivanje

Dostupne mogućnosti:

all

Sve izmjene u jednu

language

Po jeziku

file

Po datoteci

author

Po autoru

author-language

Per author and language

append_trailers

Dodaj krajnje retke združenoj poruci promjena

Krajnji redci sliče RFC 822 zaglavljima e-pošte, na kraju inače slobodnog dijela poruke izmjene, poput „Co-authored-by: …”.

commit_message

Poruka promjena

Umjesto sastavljenih poruka promjena združenih promjena koristit će se ova poruka promjene.

Triggers:

Add-on installation, Repository post-commit

Združi Git izmjene prije prijenosa promjena.

Savjet

To avoid unnecessary conflicts, it is recommended to configure automatic receiving of upstream changes by webhooks or API, see Updating repositories.

Git commits can be squashed prior to pushing changes in one of the following modes:

  • Sve izmjene u jednu

  • Po jeziku

  • Po datoteci

  • Po autoru

  • Per author and language

Izvorne poruke izmjene se čuvaju, ali autorstvo se gubi, ako nije odabrano Po autoru ili ako poruka izmjene nije prilagođena da ga uključi.

The original commit messages can optionally be overridden with a custom commit message.

Trailers (commit lines like Co-authored-by: …) can optionally be removed from the original commit messages and appended to the end of the squashed commit message. This also generates proper Co-authored-by: credit for every translator.

Prilagodi JSON rezultat

Promijenjeno u verziji 5.12: Avoid spaces after separators option added.

Removed in version 5.13: Zamijenjeno s Parametri formata datoteke.

Resetiraj repozitorij na izvorni

Added in version 5.17.

ID dodatka:

weblate.hosted.reset

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Dnevno

Poništava sve promjene u Weblate repozitoriju svake noći.

Formatiraj Java datoteku svojstava

ID dodatka:

weblate.properties.sort

Konfiguracija:

case_sensitive

Aktiviraj razvrstavanje ključeva, razlikuj velika i mala slova

Triggers:

Repository pre-commit

Formatira i raszvrstava Java datoteku svojstava.

  • Consolidates newlines to Unix ones.

  • Uppercase formatting of Unicode escape sequences (in case they are present).

  • Uklanja prazne retke i komentare.

  • Razvrstava izraze prema ključnim riječima.

  • Isključuje duple izraze.

Uklanjanje zastarjelog komentara

ID dodatka:

weblate.removal.comments

Konfiguracija:

age

Broj dana za zadržavanje

Triggers:

Add-on installation, Dnevno

Postavi vrijeme za uklanjanje komentara.

This can be useful to remove old comments which might have become outdated. Use with care as comments getting old does not mean they have lost their importance.

Uklanjanje zastarjelog prijedloga

ID dodatka:

weblate.removal.suggestions

Konfiguracija:

age

Broj dana za zadržavanje

votes

Prag glasanja

Threshold for removal. Leave empty to remove suggestions regardless of votes. This field has no effect with voting turned off.

Triggers:

Add-on installation, Dnevno

Postavi vremensko razdoblje za uklanjanje prijedloga.

Can be very useful in connection with suggestion voting (see Pregled suradnika) to remove suggestions which don’t receive enough positive votes in a given timeframe.

Aktualiziraj RESX datoteke

ID dodatka:

weblate.resx.update

Konfiguracija:

Ovaj dodatak nema konfiguraciju.

Triggers:

Add-on installation, Repository post-update

Aktualiziraj sve prevodilačke datoteke kako bi se podudarale s jednojezičnom osnovnom datotekom izvornog repozitorija. Nekorišteni izrazi se uklanjaju, a novi se dodaju kao kopije izvornog izraza.

Savjet

Use Počisti prevodilačke datoteke if you only want to remove stale translation keys.

Slack Webhooks

Added in version 5.12.

ID dodatka:

weblate.webhook.slack

Konfiguracija:

webhook_url

Webhook URL

event_filter

Change events to trigger

Choose which change events should trigger this add-on. Change events to trigger

events

Selected change events

Selected change events

Triggers:

Promjena događaja

Šalje obavijest jednom Slack kanalu na osnovi odabranih događaja.

Upozorenje

The notification content might show HTML tags. This is a known issue that will be soon addressed; see https://github.com/WeblateOrg/weblate/issues/15056.

Savjet

To obtain a webhook URL, follow the steps outlined in the Slack Incoming Webhooks documentation

Webhook

Added in version 5.11.

Promijenjeno u verziji 5.15: Compliance of the secret length with the specification is now validated.

ID dodatka:

weblate.webhook.webhook

Konfiguracija:

webhook_url

Webhook URL

secret

Webhook tajna

Standardna webhook tajna je niz znakova koji je kodiran u base64 formatu.

event_filter

Change events to trigger

Choose which change events should trigger this add-on. Change events to trigger

events

Selected change events

Selected change events

Triggers:

Promjena događaja

Šalje obavijest eksternoj usluzi na osnovi odabranih događaja, slijedeći Standard Webhooks specifikaciju.

The request payload complies with the Weblate Messaging schema. The action field uses the action name listed in Selected change events. The OpenAPI description can also be found at /api/docs/. Sample request body:

{
   "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"
}

Sample request body with categories:

{
   "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"
   ]
}

Sample request headers:

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

The webhook-signature is a space separated list of HMAC signatures generated using the secret string, the request payload, the webhook-timestamp, and the webhook-id. This ensures the authenticity and integrity of the webhook request.

The provided secret is a base64 encoded string between 24 bytes (192 bits) and 64 bytes (512 bits). It can be prefixed with whsec_ for easy identification.

To verify a request, you can use the Webhook.verify method from the standardwebhooks library or an implementation of the „Standard Webhooks Specification”.

The Automatsko prevođenje mode Add as approved translation creates approved strings when reviews are enabled for the target language. If the project settings or a language workflow override disable reviews, it creates translated strings instead. The configured mode is preserved, including for project-wide and site-wide add-ons whose targets have different review settings. Configuring this mode requires the usual add-on management permission; it does not require the configuring user to be a reviewer.

The Otkrivanje komponenti add-on stops with an error if the repository scan exceeds 100,000 paths or matching translation files would require more than 1,000,000 path-to-mask comparisons. The comparison limit is checked using the number of repository paths multiplied by the number of file masks. These fixed limits bound resource consumption when repository content determines the masks. When either limit is exceeded, discovery does not create or remove components.

Zastarjeli dodaci

Doprinositelji u komentaru

Removed in version 2026.10: Replaced by Contributor comments.

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 Contributor comments instead.

Prilagodi XML rezultat

Added in version 4.15.

Removed in version 5.13: Zamijenjeno s Parametri formata datoteke.

Prilagodi YAML rezultat

Removed in version 5.13: Zamijenjeno s Parametri formata datoteke.

Uobičajeni parametri dodataka

Uređaji za strojno prevođenje

Dostupne mogućnosti:

alibaba

Alibaba

aws

Amazon Translate

anthropic

Anthropic

apertium-apy

Apertium APy

microsoft-translator

Azure UI prevoditelj

azure-openai

Azure OpenAI

baidu

Baidu

cyrtranslit

CyrTranslit

deepl

DeepL

glosbe

Glosbe

google-translate-api-v3

Google Cloud Translation Advanced

google-translate

Google Cloud Translation Basic

ltengine

LTEngine

libretranslate

LibreTranslate

mistral

Mistral

modernmt

ModernMT

mymemory

MyMemory

netease-sight

Netease Sight

ollama

Ollama

openai

OpenAI

sap-translation-hub

Centar SAP prijevoda

systran

Systran

weblate

Weblate

weblate-translation-memory

Weblate prevodilačka memorija

yandex

Yandex

yandex-v2

Yandex v2

youdao-zhiyun

Youdao Zhiyun

tmserver

tmserver

Format datoteke

Dostupne mogućnosti:

apple-xliff

XLIFF 1.2 s Apple proširenjima

appstore

App store datoteke metapodataka

arb

ARB datoteka

aresource

Resurs Android izraza

asciidoc

AsciiDoc datoteka

ass

Napredna SubStation Alpha datoteka titlova

catkeys

Haiku catkeys

cmp-resource

Sastavi resurs za više platforma

csv

CSV datoteka

csv-multi

CSV datoteka s više vrijednosti

csv-simple

Jednostavna CSV datoteka

dokuwiki

DokuWiki tekstualna datoteka

dtd

DTD datoteka

flatxml

Flat XML datoteka

fluent

Fluent datoteka

formatjs

Format.JS JSON datoteka

go-i18n-json

go-i18n v1 JSON datoteka

go-i18n-json-v2

go-i18n v2 JSON datoteka

go-i18n-toml

go-i18n TOML datoteka

gotext

gotext JSON datoteka

gwt

GWT svojstva

html

HTML datoteka

i18next

i18next JSON datoteka v3

i18nextv4

i18next JSON datoteka v4

idml

IDML datoteka

ini

INI datoteka

islu

Inno Setup INI datoteka

joomla

Joomla jezična datoteka

json

JSON datoteka

json-nested

JSON datoteka ugniježdene strukture

laravel

Laravel PHP izrazi

markdown

Markdown datoteka

mdx

MDX file

mediawiki

MediaWiki tekstualna datoteka

mi18n-lang

Jezična datoteka @draggable/i18n

moko-resource

Mobile Kotlin resurs

nextcloud-json

Nextcloud JSON datoteka

odf

OpenDocument datoteka

php

PHP izrazi

po

gettext PO datoteka

po-mono

gettext PO datoteka (jednojezična)

poxliff

XLIFF 1.2 s gettext proširenjima

properties

Java svojstva

rc

RC datoteka

resjson

RESJSON datoteka

resourcedictionary

ResourceDictionary datoteka

resx

Datoteka .NET resursa

ruby-yaml

Ruby YAML datoteka

srt

SubRip datoteka titlova

ssa

SubStation Alpha datoteka titlova

strings

iOS izrazi

stringsdict

Stringsdict datoteka

sub

MicroDVD datoteka titlova

tbx

TermBase eXchange datoteka

toml

TOML datoteka

ts

Qt Linguist translation file (version 2)

ts1

Qt Linguist translation file (version 1)

txt

Obična tekstualna datoteka

webextension

WebExtension JSON datoteka

wxl

WixLocalization datoteka

xliff

XLIFF 1.2 prevodilačka datoteka

xliff2

XLIFF 2.0 prevodilačka datoteka

xlsx

Excel Open XML

xwiki-fullpage

XWiki Full Page

xwiki-java-properties

XWiki Java Properties

xwiki-page-properties

XWiki Page Properties

yaml

YAML datoteka

Change events to trigger

Dostupne mogućnosti:

content

Translation content events

all

All change events

custom

Selected change events

Selected change events

The following change actions can appear in notification payloads. Fedora Messaging uses the identifier column in message topics, while webhook payloads use the name column in the action field.

Dostupne mogućnosti:

ID

Identifier

Ime

Opis

0

resource_updated

Resurs aktualiziran

Jedna prevodilačka datoteka je sinkronizirana sa svojim repozitorijem.

1

translation_completed

Prijevod završen

A language translation became fully translated after an individual edit. Automatic translation, uploads, and bulk edits do not emit this event.

2

translation_changed

Prijevod promijenjen

Jedan korisnik je promijenio jedan postojeći prijevod.

3

comment_added

Komentar dodan

Jednom izrazu je dodan komentar.

4

suggestion_added

Prijedlog dodan

Dodan je prijedlog prijevoda.

5

translation_added

Prijevod dodan

Jedan korisnik je preveo jedan prethodno neprevedeni izraz.

6

automatically_translated

Automatski prevedeno

A translation was added or changed by automatic translation. This is emitted instead of Translation added or Translation changed.

7

suggestion_accepted

Prijedlog prihvaćen

A translation suggestion was accepted as the translation.

8

translation_reverted

Prijevod vraćen

A translation was restored to an earlier value.

9

translation_uploaded

Prijevod prenesen

A translation was added or changed by a translation file upload. This is emitted instead of Translation added or Translation changed.

13

source_string_added

Izvorni izraz dodan

Izvorni izraz je dodan izvan repozitorija ili aktualiziranih prijenosa.

14

component_locked

Komponenta zaključana

Komponenta je zaključana za prevođenje.

15

component_unlocked

Komponenta otključana

Komponenta je otključana za prevođenje.

17

changes_committed

Promjene dodane

Pending component changes were committed.

18

changes_pushed

Promjene prenesene

Repository changes were pushed upstream.

19

repository_reset

Repozitorij resetiran

A repository was reset to its upstream state.

20

repository_merged

Repozitorij sjedinjen

Promjene u repozitoriju glavne grane su spojeni.

21

repository_rebased

Repozitorij premješten

Promjene u repozitoriju su usklađene i postavljene na najnoviju verziju na glavnoj grani.

22

repository_merge_failed

Sjedinjavanje repozitorija neuspjelo

Merging upstream repository changes failed.

23

repository_rebase_failed

Premještanje repozitorija neuspjelo

Rebasing repository changes failed.

24

parsing_failed

Obrada neuspjela

Weblate could not parse a translation file.

25

translation_removed

Prijevod uklonjen

A language translation was removed.

26

suggestion_removed

Prijedlog uklonjen

A translation suggestion was removed.

27

translation_replaced

Prijevod zamijenjen

A translation was changed by a search-and-replace operation. This is emitted instead of Translation changed.

28

repository_push_failed

Slanje u repozitorij neuspjelo

Pushing repository changes upstream failed.

29

suggestion_removed_during_cleanup

Prijedlog uklonjen tijekom čišćenja

An obsolete translation suggestion was removed during cleanup.

30

source_string_changed

Izvorni izraz promijenjen

A source string was edited in Weblate.

31

string_added

Izraz dodan

A new string was added in Weblate.

32

bulk_status_changed

Grupno stanje promijenjeno

The translation state of one or more strings was changed in bulk.

33

visibility_changed

Vidljivost promijenjena

Project or component visibility was changed.

34

user_added

Korisnik dodan

A user was granted access.

35

user_removed

Korisnik uklonjen

A user’s access was removed.

36

translation_approved

Prijevod odobren

A translation was approved during review.

37

marked_for_edit

Označeno za uređivanje

A translation was marked as needing editing.

38

component_removed

Komponenta uklonjena

A translation component was removed.

39

project_removed

Projekt uklonjen

A translation project was removed.

41

project_renamed

Projekt preimenovan

A translation project was renamed.

42

component_renamed

Komponenta preimenovana

A translation component was renamed.

43

moved_component

Komponenta premještena

Jedna komponenta je premještena unutar projekta.

45

contributor_joined

Doprinositelj se pridružio

A user made their first contribution to a translation.

46

announcement_posted

Objava objavljena

An announcement was posted.

47

alert_triggered

Upozorenje aktivirano

A component alert was triggered.

48

language_added

Jezik dodan

A language translation was added.

49

language_requested

Jezik zatražen

A user requested a new language.

50

project_created

Projekt stvoren

A translation project was created.

51

component_created

Komponenta stvorena

A translation component was created.

52

user_invited

Korisnik pozvan

A user was invited to a project.

53

repository_notification_received

Obavijest repozitorija primljena

Weblate je primio obavijest repozitorija od jednog host računala koda.

54

translation_replaced_file_by_upload

Datoteka zamijenjena prenesenim prijevodom

A translation file was replaced by an uploaded file.

55

license_changed

Licenca promijenjena

Project or component license information changed.

56

contributor_license_agreement_changed

Licencni ugovor za doprinositelje promijenjen

The contributor license agreement was changed.

57

screenshot_added

Snimka ekrana dodana

A screenshot was associated with a string.

58

screenshot_uploaded

Snimka ekrana prenesena

A screenshot image was uploaded.

59

string_updated_in_the_repository

Izraz aktualiziran u repozitoriju

A string was changed while synchronizing from the repository.

60

add-on_installed

Dodatak instaliran

An add-on was installed.

61

add-on_configuration_changed

Konfiguracija dodatka promijenjena

An add-on’s configuration was changed.

62

add-on_uninstalled

Dodatak deinstaliran

An add-on was uninstalled.

63

string_removed

Izraz uklonjen

A string was removed from a translation.

64

comment_removed

Komentar uklonjen

A string comment was removed.

65

comment_resolved

Komentar riješen

A string comment was marked as resolved.

66

explanation_updated

Objašnjenje aktualizirano

The explanation for a source string was updated.

67

category_removed

Kategorija uklonjenja

A component category was removed.

68

category_renamed

Kategorija preimenovana

A component category was renamed.

69

category_moved

Kategorija premještena

A component category was moved.

70

saving_string_failed

Spremanje izraza neuspjelo

Weblate could not save a changed string.

71

string_added_in_the_repository

Izraz dodan u repozitorij

A new string was found while synchronizing from the repository.

72

string_updated_in_the_upload

Izraz aktualiziran u prijenos

A string was changed while processing an uploaded file.

73

string_added_in_the_upload

Izraz dodan u prijenos

A new string was found while processing an uploaded file.

74

translation_updated_by_source_upload

Prijevod aktualiziran prijenosom izvora

A translation was synchronized after uploading a source file.

75

component_translation_completed

Prijevod komponente završen

All language translations in a component became fully translated after an individual edit. Automatic translation, uploads, and bulk edits do not emit this event.

76

applied_enforced_check

Primijenjena prisilna provjera

A translation was marked as needing editing by an enforced check.

77

propagated_change

Promjena dijeljenog izraza

A translation edit was propagated to another matching string.

78

file_uploaded

Datoteka prenesena

A file was uploaded to a translation.

79

extra_flags_updated

Dodatne oznake aktualizirane

Additional source-string flags were updated.

80

font_uploaded

Font prenesen

A font was uploaded.

81

font_changed

Font promijenjen

An uploaded font was changed.

82

font_removed

Font uklonjen

An uploaded font was removed.

83

forced_synchronization_of_translations

Prisiljena sinkronizacija prijevoda

Translation files were forcibly synchronized with the repository.

84

forced_rescan_of_translations

Prisiljeno ponovno skeniranje prijevoda

Translation files were forcibly rescanned for changes.

85

screenshot_removed

Snimka ekrana je uklonjena

A screenshot was removed.

86

label_added

Dodana je etiketa

A label was added to a string.

87

label_removed

Etiketa je uklonjena

A label was removed from a string.

88

repository_cleanup

Čišćenje repozitorija

The repository working tree was cleaned up.

89

source_string_added_in_the_upload

Izvorni izraz dodan u prijenos

A source string was added while processing an uploaded file.

90

source_string_added_in_the_repository

Izvorni izraz dodan u repozitorij

A source string was added while synchronizing from the repository.

91

project_backed_up

Project backed up

A project backup was created.

92

project_restored

Project restored

A project was restored from a backup.

93

component_restored

Component restored

A component was restored from a backup.

94

user_edit_reverted

User edit reverted

All selected edits by a user were reverted.

95

project_setting_changed

Project setting changed

A project setting was changed.

96

component_setting_changed

Component setting changed

A component setting was changed.

97

user_access_changed

User access changed

A user’s access permissions were changed.

98

workspace_created

Workspace created

A workspace was created.

99

workspace_setting_changed

Workspace setting changed

A workspace setting was changed.

100

project_moved

Project moved

A project was moved into or out of a workspace.

101

remote_repository_updated

Remote repository updated

A remote repository update was completed.

102

remote_repository_update_failed

Remote repository update failed

Updating a remote repository failed.

103

alert_dismissed

Alert dismissed

A component alert was dismissed.

104

alert_reopened

Alert reopened

A component alert was reopened after its context changed.

Prilagođavanje popisa dodataka

The list of add-ons is configured by WEBLATE_ADDONS. To add another add-on, simply include the absolute class name in this setting.

Pisanje dodatka

You can write your own add-ons too, create a subclass of weblate.addons.base.BaseAddon to define the add-on metadata, and then implement a callback to do the processing.

Više informacija

Developing add-ons

Izvršavanje skripta dodatka

Add-ons can also be used to execute external scripts. This used to be integrated in Weblate, but now you have to write some code to wrap your script with an add-on.

# 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"

For installation instructions see Custom quality checks, add-ons, automatic suggestions and auto-fixes.

The script is executed with the current directory set to the root of the VCS repository for any given component.

Additionally, the following environment variables are available:

WL_VCS

Version control system used.

WL_REPO

URL izvornog repozitorija.

WL_PATH

Apsolutna staza do repozitorija sustava za kontrolu verzija.

WL_BRANCH

Repository branch configured in the current component.

WL_FILEMASK

File mask for current component.

WL_TEMPLATE

Filename of template for monolingual translations (can be empty).

WL_NEW_BASE

Filename of the file used for creating new translations (can be empty).

WL_FILE_FORMAT

Datotečni format koji se koristi u trenutačnoj komponenti.

WL_LANGUAGE

Language of currently processed translation (not available for component-level hooks).

WL_PREVIOUS_HEAD

Previous HEAD after update (only available after running the post-update hook).

WL_COMPONENT_SLUG

Component slug used to construct URL.

WL_PROJECT_SLUG

Project slug used to construct URL.

WL_COMPONENT_NAME

Component name.

WL_PROJECT_NAME

Project name.

WL_COMPONENT_URL

Component URL.

WL_ENGAGE_URL

Project engage URL.

Više informacija

Konfiguracija komponente

Post-update repository processing

Can be used to update translation files when the VCS upstream source changes. To achieve this, please remember Weblate only sees files committed to the VCS, so you need to commit changes as a part of the script.

For example with Gulp you can do it using following code:

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

Obrada prijevoda prije slanja izmjene

Use the commit script to automatically change a translation before it is committed to the repository.

It is passed as a single parameter consisting of the filename of a current translation.

Add-on activity logging

Add-on activity log keeps track of the add-on execution and can be used to keep track of add-on activity.

Each entry records whether processing is pending, successful, failed, or skipped. Skipped entries include the reason the add-on did not run, such as an incompatible component, no relevant changes, or a configured schedule that is not due yet. A successful entry can still mean that the add-on checked its inputs but found nothing to change.

For scope-wide add-ons that process components independently, the activity log contains a separate entry for each component.

The logs can be pruned after a certain time interval by configuring the ADDON_ACTIVITY_LOG_EXPIRY.