Complements¶

Els complements ofereixen maneres de personalitzar i automatitzar el flux de treball de traducció. Els administradors poden afegir i gestionar complements des del menú Operacions ↓ Complements de cada projecte o component de traducció respectiu. Els complements també es poden instal·lar a tot el lloc a Interfície de gestió.

Suggeriment

També podeu configurar complements mitjançant API, DEFAULT_ADDONS o install_addon.

Els complements que activen l’activació manual es poden executar des de la gestió de complements o mitjançant la API. Els resultats es registren al registre d’activitats del complement.

Events that trigger add-ons¶

Add-on installation¶

Triggered when add-on is being installed.

Component update¶

Triggered whenever a change happens in a component such as:

Strings are changed in the repository.
A string is added.
A new translation is added.

Cada dia¶

S’activa diàriament, però els complements solen dividir la càrrega diària entre components segons BACKGROUND_TASKS.

Event change¶

Triggered after a Change event is created.

Manual trigger¶

S’activa quan un complement s’executa manualment des de la gestió de complements o l’API.

Repository post-add¶

Triggered just after the new translation is added and committed.

Repository post-commit¶

S’activa just després de confirmar els canvis.

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¶

S’ha activat just abans que es cometin els canvis.

Repository pre-push¶

Triggered just before the repository is pushed upstream.

Repository pre-update¶

S’ha activat just abans d’intentar l’actualització del dipòsit.

Unitat després de desar¶

S’ha activat just després de desar la cadena.

Post-sincronització de la unitat¶

Triggered after the string is synchronized with the VCS.

Precreació de la unitat¶

S’ha activat just després de desar la cadena acabada de crear.

Built-in add-ons¶

Traducció automatitzada¶

Add-on ID:

weblate.autotranslate.autotranslate

Configuration:

mode

Mode de traducció automatitzada

Available choices:¶
`suggest`	Afegeix com a suggeriments
`translate`	Afegeix com a traducció
`fuzzy`	Afegeix com a «cal editar»

q

Consulta

Tingueu en compte que traduir totes les cadenes descartarà totes les traduccions existents.

auto_source

Origen de les traduccions automàtiques

Available choices:¶
`others`	Altres components
`mt`	Traducció automàtica

component

Component

Introduïu l’URL amigable del component que s’utilitzarà com a origen. Deixeu-ho en blanc per a utilitzar tots els components del projecte actual.

engines

Motors de traducció automàtica

threshold

Llindar de puntuació

Triggers:

Add-on installation, Component update, Cada dia, Event change

Tradueix automàticament les cadenes fent servir traducció automàtica o altres components.

Vegeu també

CDN de localització de JavaScript¶

Afegit a la versió 4.2.

Add-on ID:

weblate.cdn.cdnjs

Configuration:

`threshold`	Llindar de traducció	El percentatge de cadenes traduïdes que hi ha d’haver perquè la traducció s’inclogui.
`css_selector`	Selector CSS	Selector CSS per a detectar els elements localitzables.
`cookie_name`	Nom de la galeta de llengua	Nom de la galeta que emmagatzema la preferència de llengua.
`files`	Extreu cadenes de fitxers HTML	Llista de noms de fitxer del repositori actual o URL remots que s’analitzaran cercant-hi cadenes traduïbles.

Triggers:

Add-on installation, Cada dia, Repository post-commit, Repository post-remove, Repository post-update

Publica les traduccions en una xarxa de lliurament de continguts per al seu ús en la localització de JavaScript o HTML.

Es pot utilitzar per localitzar pàgines HTML estàtiques o per carregar la localització al codi JavaScript.

Genera un URL únic per al vostre component que podeu incloure a les pàgines HTML per localitzar-los. Vegeu Traduir HTML i JavaScript mitjançant Weblate CDN per a més detalls.

Nota

Aquest complement requereix una configuració addicional al servidor Weblate. LOCALIZE_CDN_PATH configura on s’escriuran els fitxers generats (en un sistema de fitxers), i LOCALIZE_CDN_URL defineix on es serviran (URL). Weblate no fa servir els fitxers i s’ha de configurar externament (normalment utilitzant un servei CDN).

Aquest complement està configurat a Hosted Weblate i serveix els fitxers a través de https://weblate-cdn.com/.

Vegeu també

Translation files CDN¶

Afegit a la versió 2026.5.

Add-on ID:: weblate.cdn.files
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Component update, Repository post-commit, Repository post-remove, Repository post-update

Publishes translation files into a content delivery network.

Publica fitxers de traducció sense convertir-los a un altre format. Els fitxers s’escriuen a sota del directori CDN específic del complement i es publiquen des de LOCALIZE_CDN_URL/<add-on UUID>/. Les traduccions d’un sol fitxer utilitzen el codi d’idioma i l’extensió de fitxer original, per exemple cs.json o de.po. Les traduccions de diversos fitxers es publiquen a sota del codi d’idioma mitjançant camins relacionats amb el directori de traducció. Els components monolingües inclouen el fitxer d’idioma d’origen, mentre que els components bilingües només publiquen fitxers de la llengua de destinació. Vegeu Localization CDN per obtenir una guia de servei segur.

Suprimeix les cadenes buides¶

Afegit a la versió 4.4.

Add-on ID:: weblate.cleanup.blank
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Repository post-commit, Repository post-update

Suprimeix les cadenes sense traducció dels fitxers de traducció.

Utilitzeu-ho per no tenir cap cadena buida als fitxers de traducció (per exemple, si la vostra biblioteca de localització les mostra com a faltes en lloc de tornar a la cadena d’origen).

Vegeu també

Weblate actualitza els fitxers de traducció a més de les traduccions?

Neteja els fitxers de traducció¶

Add-on ID:: weblate.cleanup.generic
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Repository post-update, Repository pre-commit

Actualitzeu tots els fitxers de traducció perquè coincideixin amb el fitxer base monolingüe. Per a la majoria de formats de fitxer, això implica suprimir les claus de traducció obsoletes que ja no existeixen al fitxer base.

Per als formats que contenen contingut addicional a més de les cadenes de traducció (com ara Fitxers HTML, Fitxers RC del Windows, o Format OpenDocument), això també sincronitza el fitxer de traducció amb el fitxer base.

For a one-time cleanup of a single translation file, use Cleanup unused in Manteniment del repositori on that translation instead of installing the add-on.

Vegeu també

Weblate actualitza els fitxers de traducció a més de les traduccions?

Afegeix les llengües que hi manquin¶

Add-on ID:: weblate.consistency.languages
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Cada dia, Repository post-add

Garanteix que tots els components d’un projecte utilitzin el mateix joc de llengües.

Nota

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

Els idiomes que falten es comproven una vegada cada 24 hores i quan s’afegeixen idiomes nous a Weblate.

A diferència de la majoria d’altres, aquest complement afecta tot el projecte.

Suggeriment

Tradueix automàticament les cadenes afegides recentment amb Traducció automatitzada.

Descobriment de components¶

Add-on ID:

weblate.discovery.discovery

Configuration:

`match`	Expressió regular per a trobar fitxers de traducció	L’expressió regular ha de definir grups amb nom per al component i la llengua.
`file_format`	Format de fitxer	Format de fitxer
`name_template`	Personalitza el nom del component	Utilitzeu la sintaxi de plantilles del Django. Aquesta plantilla ha d’incloure {{ component }}.
`base_file_template`	Defineix el nom de fitxer base monolingüe	Leave empty for bilingual translation files. When set, this template must include {{ component }}.
`new_base_template`	Defineix el fitxer base per a noves traduccions	Filename of file used for creating new translations. For gettext choose .pot file. This template must include {{ component }}.
`intermediate_template`	Fitxer de llengua intermèdia	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 }}.
`language_regex`	Filtre de llengua	Expressió regular per a filtrar fitxers de traducció quan s’escanegen per filtre de fitxers.
`copy_addons`	Clona els complements del component principal als nous components
`remove`	Suprimeix els components dels fitxers inexistents

Triggers:

Add-on installation, Repository post-update

Afegeix o suprimeix automàticament components del projecte basant-se en els canvis de fitxers del sistema de control de versions.

The matching is done using regular expressions enabling complex configuration, but some knowledge is required to do so. The regular expression to match translation files has to contain two named groups to match component and language. All named groups in the regular expression can be used as variables in the template fields.

Requisits de descoberta¶

Per descobrir un component amb èxit, la configuració ha de fer tot el següent:

L’expressió regular ha de definir grups anomenats component i idioma.
Els camps de plantilla utilitzats per anomenar o localitzar fitxers per component han d’incloure {{ component }}, de manera que el valor representat realment canvia per a cada component descobert.
Per als formats monolingües, el component ha de contenir un fitxer que coincideixi amb base_file_template i almenys un fitxer de traducció que coincideixi amb match.

Exemple treballat: `news_<lang>.md`¶

Aquest és un disseny comú de variants d’idioma basat en noms de fitxer:

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.

Regular expression:

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

Component name:

{{ component }}

Discovered file masks:

docs/news_*.md
docs/guide_*.md

En aquest exemple, {{ component }} es resol amb el nom base abans del sufix d’idioma, de manera que docs/news_en.md, docs/news_pt_BR.md i docs/news_pt-BR.md es converteixen tots en el component news.

You can use Django template markup in all filename fields, for example:

{{ component }}: El nom del component s’ha analitzat des del grup de concordança component
{{ component|title }}: Nom de fitxer del component amb la primera lletra en majúscula
{{ path }}: {{ component }}: Custom match group from the regular expression

Un cop premeu Desa, es presentarà una vista prèvia dels components coincidents, des d’on podeu comprovar si la configuració s’adapta realment a les vostres necessitats:

Component discovery examples¶

L’exemple treballat anterior cobreix el disseny de variants basat en noms de fitxer més comú. Els exemples següents mostren altres estructures de repositoris amb les quals podeu coincidir.

One folder per language¶

Una carpeta per llengua que conté els fitxers de traducció per als components.

Regular expression:

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

Matching files:

cs/application.po
cs/website.po
de/application.po
de/website.po

Disposició de configuracions regionals del gettext¶

Estructura habitual per a emmagatzemar els fitxers PO del gettext.

Regular expression:

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

Matching files:

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¶

Utilitzar tant el nom del component com el de la llengua al nom del fitxer.

Regular expression:

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

Matching files:

src/locale/application.cs.po
src/locale/website.cs.po
src/locale/application.de.po
src/locale/website.de.po

Repeated language code¶

Utilitzar la llengua tant al camí com al nom del fitxer.

Regular expression:

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

Matching files:

locale/cs/application/cs.po
locale/cs/website/cs.po
locale/de/application/de.po
locale/de/website/de.po

Split Android strings¶

Cadenes de recursos d’Android, dividides en diversos fitxers.

Regular expression:

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

Matching files:

res/values-cs/strings-about.xml
res/values-cs/strings-help.xml
res/values-de/strings-about.xml
res/values-de/strings-help.xml

Matching multiple paths¶

Projecte multimòdul de Maven amb traduccions de propietats de Java.

Regular expression:

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

Component name:

{{ originalHierarchy }}: {{ component }}

Matching files:

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

Suggeriment

El complement de descoberta de components utilitza URL interns del lloc web. És una manera convenient de compartir la configuració de VCS entre diversos components. Els components enllaçats utilitzen el dipòsit local del component principal configurat omplint weblate://project/main-component al camp Repositori del codi font (a Operacions ↓ Configuració ↓ Sistema de control de versions) de cada component respectiu. Això també estalvia temps amb la configuració i els recursos del sistema.

Suggeriment

Assegureu-vos que el nou component contingui el conjunt complet d’idiomes traduïbles amb Afegeix les llengües que hi manquin.

Vegeu també

Fedora Messaging¶

Afegit a la versió 5.15.

Add-on ID:

weblate.fedora_messaging.publish

Configuration:

`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:

Event change

Envia notificacions a un intercanvi AMQP compatible amb Fedora Messaging.

Fedora Messaging és un editor basat en AMQP per a tots els canvis que es produeixen a Weblate. Podeu connectar serveis addicionals als canvis que es produeixin a Weblate fent servir això.

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¶

El cos consta dels següents camps (tenint en compte que estan disponibles per a l’esdeveniment):

change_id: Numerical ID of change
action: Verbose name of the change.
timestamp: ISO formatted timestamp
target: New value of the change (eg. new translation of the string)
old: Old value of the change (eg. previous translation of the string)
source: Source string.
url: URL absolut per veure l’objecte relacionat.
author: Nom d’usuari de l’autor (pot ser diferent de l’usuari, per exemple quan s’accepten suggeriments)
user: Acting username
project: Llimac del projecte
component: Component llimac
translation: Codi d’idioma de traducció

Message headers¶

Hi ha capçaleres addicionals que també podeu utilitzar per a l’encaminament:

action: Verbose name of the change.
project: Llimac del projecte
component: Component llimac

Example messages¶

Repository merge event:

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

New source string event:

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

Resource update event:

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

Project removal event:

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

New contributor event:

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

New translation event:

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

Vegeu també

Edició massiva¶

Add-on ID:

weblate.flags.bulk

Configuration:

q

Consulta

state

Estat a definir

Available choices:¶
`-1`	No canviïs
`10`	Cal editar
`11`	Needs editing (Needs rewriting)
`12`	Needs editing (Needs checking)
`20`	Traduït
`30`	Aprovada

add_flags

Marques de traducció que s’afegiran

remove_flags

Marques de traducció que se suprimiran

add_labels

Etiquetes que s’afegiran

remove_labels

Etiquetes que se suprimiran

Triggers:

Add-on installation, Component update

Edita marques, etiquetes o estats de les cadenes de manera massiva.

Exemples:

Etiqueta les cadenes noves automàticament¶
Search query	`NOT has:label`
Etiquetes que s’afegiran	recent

Marcant totes les cadenes del registre de canvis Fitxers de metadades de botiga d’aplicacions només de lectura¶
Search query	`language:en AND key:changelogs/`
Marques de traducció que s’afegiran	`read-only`

Marking certain strings read-only¶
Search query	source:r"^\`\`[.a-zA-Z0-9_-]*\`\`$" I idioma:en
Marques de traducció que s’afegiran	`read-only`

Vegeu també

Flag unchanged translations as «Needs rewriting»¶

Add-on ID:: weblate.flags.same_edit
Configuration:: This add-on has no configuration.
Triggers:: Precreació de la unitat

Whenever a new translatable string is imported from the VCS and it matches a source string, it is flagged as needing rewriting in Weblate. Especially useful for file formats that include source strings for untranslated strings.

Suggeriment

També és possible que vulgueu reforçar la comprovació Traducció no modificada afegint el senyalador strict-same a Marques de traducció.

Vegeu també

Estats de traducció

Flag new source strings as «Needs checking»¶

Add-on ID:: weblate.flags.source_edit
Configuration:: This add-on has no configuration.
Triggers:: Precreació de la unitat

Whenever a new source string is imported from the VCS, it is flagged as needing checking in Weblate. This way you can easily filter and edit source strings written by the developers.

Vegeu també

Estats de traducció

Flag new translations as «Needs rewriting»¶

Add-on ID:: weblate.flags.target_edit
Configuration:: This add-on has no configuration.
Triggers:: Precreació de la unitat

Whenever a new translatable string is imported from the VCS, it is flagged as needing rewriting in Weblate. This way you can easily filter and edit translations created by the developers.

Vegeu també

Estats de traducció

Flag updated translations from repository as «Needs rewriting»¶

Add-on ID:: weblate.flags.target_repo_update
Configuration:: This add-on has no configuration.
Triggers:: Post-sincronització de la unitat

Whenever a string translation is changed from the VCS, it is flagged as needing rewriting in Weblate. Especially useful if translation files are often updated manually or by an external service.

Vegeu també

Estats de traducció

Omple les cadenes de només lectura amb l’origen¶

Afegit a la versió 4.18.

Add-on ID:: weblate.generate.fill_read_only
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Component update, Cada dia

Omple la traducció de les cadenes de només lectura amb la cadena d’origen.

Generador d’estadístiques¶

Add-on ID:

weblate.generate.generate

Configuration:

`filename`	Nom del fitxer generat
`template`	Contingut del fitxer generat

Triggers:

Add-on installation, Repository pre-commit

Genera un fitxer que conté informació detallada de l’estat de la traducció.

You can use a Django template in both filename and content, see Marcatge de plantilla for a detailed markup description.

For example generating a summary file for each translation:

Nom del fitxer generat

locale/{{ language_code }}.json

Content

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

Vegeu també

Marcatge de plantilla

Preomple la traducció amb l’origen¶

Afegit a la versió 4.11.

Add-on ID:: weblate.generate.prefill
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Component update, Cada dia

Omple les cadenes de traducció amb la cadena d’origen.

Totes les cadenes no traduïdes del component s’ompliran amb la cadena d’origen i es marcaran com a que necessiten edició. Utilitzeu-ho quan no pugueu tenir cadenes buides als fitxers de traducció. .. INICI AUTOGENERAT: weblate.generate.pseudolocale .. Aquesta secció es genera automàticament per ./manage.py list_addons. No editeu manualment.

Generació de pseudolocalitzacions¶

Afegit a la versió 4.5.

Add-on ID:

weblate.generate.pseudolocale

Configuration:

`source`	Cadenes d’origen
`target`	Traducció de destinació	Se sobreescriuran totes les cadenes d’aquesta traducció
`prefix`	Text estàtic al davant
`var_prefix`	Text variable al davant
`suffix`	Text estàtic al darrere
`var_suffix`	Text variable al darrere
`var_multiplier`	Multiplicador de text variable	Quantes vegades es repetirà el text variable depenent de la longitud de la cadena d’origen.
`include_readonly`	Inclou les cadenes de només lectura

Triggers:

Add-on installation, Component update, Cada dia

Genera una traducció afegint un prefix i un sufix a les cadenes d’origen de manera automàtica.

Els pseudolocales són útils per trobar cadenes que no estan preparades per a la localització. Això es fa modificant totes les cadenes d’origen traduïbles per tal que sigui fàcil detectar cadenes no alterades quan s’executa l’aplicació en l’idioma pseudolocal.

També és possible trobar cadenes els homòlegs localitzats de les quals no s’ajustin al disseny.

L’ús de les parts variables fa possible buscar cadenes que potser no encaixen a la interfície d’usuari després de la localització; amplia el text en funció de la longitud de la cadena d’origen. Els textos variables es repeteixen per la longitud del text multiplicada pel multiplicador. Per exemple, Hola món amb text variable _ i el multiplicador variable d’1 es converteix en Hola món___________: el text es repeteix una vegada per a cada caràcter de la cadena d’origen.

Les cadenes es generaran fent servir el patró següent:

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

Suggeriment

Podeu utilitzar idiomes reals per fer proves, però hi ha pseudolocals dedicats disponibles a Weblate: en_XA i ar_XB.

Suggeriment

Podeu utilitzar aquest complement per iniciar la traducció a una nova configuració regional d’un idioma existent o similar. Un cop afegiu la traducció al component, aneu al complement. Exemple: Si teniu fr i voleu començar la traducció fr_CA, simplement establiu fr com a font, fr_CA com a destinació i deixeu el prefix i el sufix en blanc.

Desinstal·leu el complement un cop hàgiu omplert la traducció nova per evitar que Weblate canviï les traduccions fetes després de la còpia.

Col·laboradors als comentaris¶

Add-on ID:: weblate.gettext.authors
Configuration:: This add-on has no configuration.
Triggers:: Repository pre-commit

Actualitza la part de comentaris de la capçalera del fitxer PO per a incloure-hi els noms dels col·laboradors i els anys de les contribucions.

La capçalera del fitxer PO tindrà aquest aspecte:

# Michal Čihař <michal@weblate.org>, 2012, 2018, 2019, 2020.
# Pavel Borecki <pavel@example.com>, 2018, 2019.
# Filip Hron <filip@example.com>, 2018, 2019.
# anonymous <noreply@weblate.org>, 2019.

Actualitza la variable ALL_LINGUAS del fitxer «configure»¶

Add-on ID:: weblate.gettext.configure
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Cada dia, 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.

Personalitza la sortida del gettext¶

S’ha eliminat a la versió 5.13: Replaced by Paràmetres del format de fitxer.

Actualitza la plantilla de gettext (Django)¶

Afegit a la versió 5.17.

Add-on ID:

weblate.gettext.django

Configuration:

interval

Freqüència d’actualització

Amb quina freqüència el complement hauria d’actualitzar el fitxer POT quan s’actualitza el component.

Available choices:¶
`daily`	Cada dia
`weekly`	Weekly
`monthly`	Cada mes

normalize_header

Normalitza la capçalera del POT

Actualitza les capçaleres del gettext i substitueix els comentaris d’espai reservat del POT.

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.

Available choices:¶
`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

Actualitza la plantilla de gettext mitjançant l’ordre «makemessages» integrada del Django.

This add-on updates the template configured in Plantilla per a traduccions noves. 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 Actualitza els fitxers PO perquè coincideixin amb el POT (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.

Actualitza el fitxer LINGUAS¶

Add-on ID:: weblate.gettext.linguas
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Cada dia, Repository post-add, Repository post-remove

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

Update POT file (Meson)¶

Afegit a la versió 5.17.

Add-on ID:

weblate.gettext.meson

Configuration:

interval

Freqüència d’actualització

Amb quina freqüència el complement hauria d’actualitzar el fitxer POT quan s’actualitza el component.

Available choices:¶
`daily`	Cada dia
`weekly`	Weekly
`monthly`	Cada mes

normalize_header

Normalitza la capçalera del POT

Actualitza les capçaleres del gettext i substitueix els comentaris d’espai reservat del POT.

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.

Available choices:¶
`file`	Use file format settings
`keep`	Extract locations to the POT file
`omit`	Do not extract locations

comment_mode

Code comments

Trieu si xgettext ha d’extreure cap comentari, tots els comentaris o només els comentaris marcats amb una etiqueta específica.

Available choices:¶
`off`	Do not extract comments
`all`	Extract all comments
`tagged`	Extreu els comentaris amb etiqueta

comment_tag

Comment tag

Etiqueta passada a xgettext per a l’extracció de comentaris quan s’utilitza el mode de comentaris etiquetats.

checks

xgettext checks

Comprovacions addicionals de validació de xgettext a activar per als missatges extrets.

Available choices:¶
`ellipsis-unicode`	punts suspensius-unicode
`space-ellipsis`	space-ellipsis
`quote-unicode`	cita-unicode
`bullet-unicode`	bala-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

Meson preset

Preajust de l’argument integrat de xgettext que coincideix amb la integració de gettext del Meson. El preajust «GLib» afegeix les opcions «keyword» i «format-flag» utilitzades per l’ajudant de gettext del Meson.

Available choices:¶
`glib`	GLib

Triggers:

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

Updates the gettext template using Meson gettext conventions.

This add-on updates the template configured in Plantilla per a traduccions noves. It is available for gettext PO components, and the component must define a template for new translations.

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 Plantilla per a traduccions noves. 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 Plantilla per a traduccions noves, 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.

Genera els fitxers MO¶

Add-on ID:

weblate.gettext.mo

Configuration:

`path`	Camí del fitxer MO generat	Si no s’especifica, s’utilitza la ubicació del fitxer PO.
`fuzzy`	Inclou les cadenes que cal editar	Les cadenes que cal editar («fuzzy») normalment no estan preparades per a ser utilitzades com a traduccions.

Triggers:

Repository pre-commit

Genera un fitxer MO automàticament per a cada fitxer PO canviat.

The location of the generated MO file can be customized and the field for it uses Marcatge de plantilla.

Nota

Si s’elimina una traducció, el seu fitxer PO s’eliminarà del dipòsit, però el fitxer MO generat per aquest complement no ho farà. El fitxer MO s’ha d’eliminar manualment de la xarxa amunt.

Actualitza els fitxers PO perquè coincideixin amb el POT (msgmerge)¶

Canviat a la versió 5.13: La configuració Settings s’ha mogut a Paràmetres del format de fitxer.

Add-on ID:: weblate.gettext.msgmerge
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Repository post-update

Actualitza tots els fitxers PO (com els hàgiu configurat a «Filtre de fitxers») perquè coincideixin amb el fitxer POT (com l’hàgiu configurat a «Plantilla per a noves traduccions») fent servir msgmerge.

Aquest complement és essencial quan es treballa amb fitxers gettext PO on el fitxer POT (plantilla) s’actualitza amb cadenes noves o canvis a les cadenes existents. Quan el fitxer POT s’actualitza al dipòsit, aquest complement fusiona automàticament aquests canvis amb tots els fitxers PO d’idioma, assegurant-se que:

New translatable strings appear in all languages
Removed strings are marked as obsolete
Les cadenes modificades estan marcades com a que necessiten revisió (difuses)

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.

Vegeu també

Actualitza el fitxer POT (Sphinx)¶

Afegit a la versió 5.17.

Add-on ID:

weblate.gettext.sphinx

Configuration:

interval

Freqüència d’actualització

Amb quina freqüència el complement hauria d’actualitzar el fitxer POT quan s’actualitza el component.

Available choices:¶
`daily`	Cada dia
`weekly`	Weekly
`monthly`	Cada mes

normalize_header

Normalitza la capçalera del POT

Actualitza les capçaleres del gettext i substitueix els comentaris d’espai reservat del POT.

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.

Available choices:¶
`file`	Use file format settings
`keep`	Extract locations to the POT file
`omit`	Do not extract locations

filter_mode

Filtering

Opcionalment, elimineu les cadenes que no siguin útils per a traduir després de l’extracció de Sphinx.

Available choices:¶
`none`	Cap
`weblate_docs`	Weblate documentation

Triggers:

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

Actualitza la plantilla de gettext utilitzant el generador de gettext de Sphinx sense carregar la configuració del projecte.

This add-on updates the template configured in Plantilla per a traduccions noves. It is available for gettext PO components, and the component must define a template for new translations.

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.

Update POT file (xgettext)¶

Afegit a la versió 5.17.

Add-on ID:

weblate.gettext.xgettext

Configuration:

interval

Freqüència d’actualització

Amb quina freqüència el complement hauria d’actualitzar el fitxer POT quan s’actualitza el component.

Available choices:¶
`daily`	Cada dia
`weekly`	Weekly
`monthly`	Cada mes

normalize_header

Normalitza la capçalera del POT

Actualitza les capçaleres del gettext i substitueix els comentaris d’espai reservat del POT.

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.

Available choices:¶
`file`	Use file format settings
`keep`	Extract locations to the POT file
`omit`	Do not extract locations

comment_mode

Code comments

Trieu si xgettext ha d’extreure cap comentari, tots els comentaris o només els comentaris marcats amb una etiqueta específica.

Available choices:¶
`off`	Do not extract comments
`all`	Extract all comments
`tagged`	Extreu els comentaris amb etiqueta

comment_tag

Comment tag

Etiqueta passada a xgettext per a l’extracció de comentaris quan s’utilitza el mode de comentaris etiquetats.

checks

xgettext checks

Comprovacions addicionals de validació de xgettext a activar per als missatges extrets.

Available choices:¶
`ellipsis-unicode`	punts suspensius-unicode
`space-ellipsis`	space-ellipsis
`quote-unicode`	cita-unicode
`bullet-unicode`	bala-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

Input source

Trieu si xgettext ha de llegir els fitxers d’origen dels patrons glob o d’un manifest POTFILES/POTFILES.in.

Available choices:¶
`patterns`	Source file patterns
`potfiles`	Manifest POTFILES

language

xgettext language

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

source_patterns

Source file patterns

Patrons glob relatius al repositori separats per salts de línia per a extreure fitxers amb xgettext.

potfiles_path

Camí al POTFILES

Camí al POTFILES o POTFILES.in relatiu al repositori. Els elements es resolen de manera relativa a l’arrel del dipòsit. Si està present juntament amb el manifest, el POTFILES.skip exclou els fitxers llistats de l’extracció.

Triggers:

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

Actualitza la plantilla de gettext utilitzant xgettext als fitxers d’origen seleccionats.

This add-on updates the template configured in Plantilla per a traduccions noves. It is available for gettext PO components, and the component must define a template for new translations.

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.

Fes comissions «squash» al Git¶

Add-on ID:

weblate.git.squash

Configuration:

squash

«Squash» de les comissions

Available choices:¶
`all`	Totes les comissions en una
`language`	Per llengua
`file`	Per fitxer
`author`	Per autor

append_trailers

Afegeix línies al final del missatge de la comissió amb «squash»

Les línies finals s’assemblen a capçaleres de correu RFC 822 i s’afegeixen a la secció final d’un missatge de comissió. Aquestes línies poden contenir indicacions com ara «Co-authored-by: …».

commit_message

Missatge de la comissió

S’utilitzarà aquest missatge de comissió en lloc de la combinació de missatges de les comissions amb «squash».

Triggers:

Add-on installation, Repository post-commit

Fa «squash» de les comissions del Git abans de pujar els canvis.

Suggeriment

Per evitar conflictes innecessaris, es recomana configurar la recepció automàtica de canvis amunt per webhooks o API, vegeu Actualització de repositoris.

Les confirmacions de Git es poden esborrar abans d’impulsar els canvis en un dels modes següents:

Totes les comissions en una
Per llengua
Per fitxer
Per autor

Original commit messages are kept, but authorship is lost unless Per author is selected, or the commit message is customized to include it.

Els missatges de confirmació originals es poden substituir opcionalment amb un missatge de confirmació personalitzat.

Els tràilers (línies de confirmació com Co-authored-by: …) es poden eliminar opcionalment dels missatges de confirmació originals i afegir-los al final del missatge de confirmació esborrat. Això també genera el crèdit adequat de Coautor: per a cada traductor.

Personalitza la sortida JSON¶

Canviat a la versió 5.12: Evita els espais després d’haver afegit l’opció de separadors.

S’ha eliminat a la versió 5.13: Replaced by Paràmetres del format de fitxer.

Reinicialitza el dipòsit a la font¶

Afegit a la versió 5.17.

Add-on ID:: weblate.hosted.reset
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Cada dia

Descarta tots els canvis del dipòsit del Weblate cada nit.

Formata el fitxer de propietats de Java¶

Add-on ID:

weblate.properties.sort

Configuration:

case_sensitive

Activa l’ordenació de claus sensible a majúscules i minúscules

Triggers:

Repository pre-commit

Formata i ordena el fitxer de propietats de Java.

Consolida les noves línies a les d’Unix.
Formatat en majúscules de les seqüències d’escapada Unicode (en cas que estiguin presents).
Strips blank lines and comments.
Sorts the strings by the keys.
Drops duplicate strings.

Supressió de comentaris antics¶

Add-on ID:

weblate.removal.comments

Configuration:

age

Dies d’emmagatzematge

Triggers:

Add-on installation, Cada dia

Defineix un interval de temps per a la supressió de comentaris.

Això pot ser útil per eliminar comentaris antics que podrien haver quedat obsolets. Utilitzar amb cura ja que els comentaris envellint no vol dir que hagin perdut la seva importància.

Supressió de suggeriments antics¶

Add-on ID:

weblate.removal.suggestions

Configuration:

`age`	Dies d’emmagatzematge
`votes`	Llindar de vots	Threshold for removal. Leave empty to remove suggestions regardless of votes. This field has no effect with voting turned off.

Triggers:

Add-on installation, Cada dia

Definiu un interval de temps per a la supressió de suggeriments.

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

Actualitza els fitxers RESX¶

Add-on ID:: weblate.resx.update
Configuration:: This add-on has no configuration.
Triggers:: Add-on installation, Repository post-update

Actualitza tots els fitxers de traducció perquè coincideixin amb el fitxer base monolingüe de la font. Les cadenes no utilitzades se suprimiran, i les noves s’afegiran com a còpies de la cadena d’origen.

Suggeriment

Utilitzeu Neteja els fitxers de traducció si només voleu eliminar les claus de traducció obsoletes.

Vegeu també

Weblate actualitza els fitxers de traducció a més de les traduccions?

Webhooks de Slack¶

Afegit a la versió 5.12.

Add-on ID:

weblate.webhook.slack

Configuration:

`webhook_url`	URL del webhook
`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:

Event change

Envia una notificació a un canal de Slack en base a esdeveniments seleccionats.

Avís

El contingut de la notificació pot mostrar etiquetes HTML. Aquest és un tema conegut que s’abordarà aviat; vegeu https://github.com/WeblateOrg/weblate/issues/15056.

Suggeriment

Per obtenir un URL de webhook, seguiu els passos descrits a la documentació de Slack Incoming Webhooks

Webhook¶

Afegit a la versió 5.11.

Canviat a la versió 5.15: Ara s’ha validat el compliment de la longitud del secret amb l’especificació.

Add-on ID:

weblate.webhook.webhook

Configuration:

`webhook_url`	URL del webhook
`secret`	Secret del webhook	El secret de Standard Webhooks és una cadena codificada en base64.
`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:

Event change

Envia notificacions a serveis externs en base a esdeveniments seleccionats seguint l’especificació Standard Webhooks.

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

Exemple de cos de sol·licitud amb 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"
   ]
}

Exemples de capçaleres de sol·licituds:

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

La webhook-signature és una llista separada per espais de signatures HMAC generades mitjançant la cadena secret, la càrrega útil de la sol·licitud, el webhook-timestamp i el webhook-id. Això garanteix l’autenticitat i la integritat de la sol·licitud de webhook.

El secret proporcionat és una cadena codificada en base64 entre 24 bytes (192 bits) i 64 bytes (512 bits). Pot ser prefixat amb whsec_ per facilitar la identificació.

Per verificar una sol·licitud, podeu utilitzar el mètode Webhook.verify de la biblioteca standardwebhooks o una implementació de l“«Especificació de Webhooks estàndard».

Vegeu també

Obsolete add-ons¶

Personalitza la sortida XML¶

Afegit a la versió 4.15.

S’ha eliminat a la versió 5.13: Replaced by Paràmetres del format de fitxer.

Personalitza la sortida YAML¶

S’ha eliminat a la versió 5.13: Replaced by Paràmetres del format de fitxer.

Common add-on parameters¶

Motors de traducció automàtica¶

Available choices:¶
`alibaba`	Alibaba
`aws`	Amazon Translate
`anthropic`	Anthropic
`apertium-apy`	Apertium APy
`microsoft-translator`	Azure AI Translator
`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`	SAP Translation Hub
`systran`	Systran
`weblate`	Weblate
`weblate-translation-memory`	Weblate Memòria de traducció
`yandex`	Yandex
`yandex-v2`	Yandex v2
`youdao-zhiyun`	Youdao Zhiyun
`tmserver`	tmserver

Format de fitxer¶

Available choices:¶
`apple-xliff`	XLIFF 1.2 with Apple extensions
`appstore`	Fitxers de metadades de botiga d’aplicacions
`arb`	Fitxer ARB
`aresource`	Recurs de cadenes de l’Android
`asciidoc`	Fitxer AsciiDoc
`ass`	Fitxer de subtítols Advanced SubStation Alpha
`catkeys`	catkeys del Haiku
`cmp-resource`	Recurs de Compose Multiplatform
`csv`	Fitxer CSV
`csv-multi`	Multivalue CSV file
`csv-simple`	Fitxer CSV simple
`dokuwiki`	Fitxer de text DokuWiki
`dtd`	Fitxer DTD
`flatxml`	Fitxer XML pla
`fluent`	Fitxer Fluent
`formatjs`	Fitxer JSON de Format.JS
`go-i18n-json`	Fitxer JSON de go-i18n v1
`go-i18n-json-v2`	Fitxer JSON de go-i18n v2
`go-i18n-toml`	Fitxer TOML de go-i18n
`gotext`	Fitxer JSON de gotext
`gwt`	Propietats de GWT
`html`	Fitxer HTML
`i18next`	Fitxer JSON i18next v3
`i18nextv4`	Fitxer JSON i18next v4
`idml`	Fitxer IDML
`ini`	Fitxer INI
`islu`	Fitxer INI de l’Inno Setup
`joomla`	Fitxer de llengua del Joomla
`json`	Fitxer JSON
`json-nested`	Fitxer JSON d’estructura imbricada
`laravel`	Cadenes de PHP de Laravel
`markdown`	Fitxer Markdown
`mdx`	MDX file
`mediawiki`	Fitxer de text MediaWiki
`mi18n-lang`	Fitxer lang de @draggable/i18n
`moko-resource`	Recurs de Kotlin per a mòbils
`nextcloud-json`	Fitxer JSON de Nextcloud
`odf`	Fitxer OpenDocument
`php`	Cadenes de PHP
`plainxliff`	Fitxer de traducció XLIFF 1.2
`po`	Fitxer PO del gettext
`po-mono`	Fitxer PO del gettext (monolingüe)
`poxliff`	XLIFF 1.2 amb extensions gettext
`properties`	Java Properties
`rc`	Fitxer RC
`resjson`	Fitxer RESJSON
`resourcedictionary`	Fitxer ResourceDictionary
`resx`	Fitxer de recursos de .NET
`ruby-yaml`	Fitxer YAML de Ruby
`srt`	Fitxer de subtítols del SubRip
`ssa`	Fitxer de subtítols SubStation Alpha
`strings`	Cadenes de l’iOS
`stringsdict`	Fitxer Stringsdict
`sub`	Fitxer de subtítols MicroDVD
`tbx`	Fitxer TermBase eXchange
`toml`	Fitxer TOML
`ts`	Qt Linguist translation file (version 2)
`ts1`	Qt Linguist translation file (version 1)
`txt`	Fitxer de text net
`webextension`	Fitxer JSON de WebExtension
`wxl`	WixLocalization file
`xliff`	XLIFF 1.2 amb suport per a «placeables»
`xliff2`	Fitxer de traducció XLIFF 2.0
`xliff2-placeables`	Fitxer de traducció XLIFF 2.0 amb suport per a «placeables»
`xlsx`	Open XML de l’Excel
`xwiki-fullpage`	Pàgina completa de XWiki
`xwiki-java-properties`	XWiki Java Properties
`xwiki-page-properties`	XWiki Page Properties
`yaml`	Fitxer YAML

Change events to trigger¶

Available choices:¶
`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.

Available choices:¶
ID	Identifier	Nom	Descripció
`0`	`resource_updated`	S’ha actualitzat el recurs	A translation file was synchronized with its repository.
`1`	`translation_completed`	S’ha completat la traducció	A language translation became fully translated after an individual edit. Automatic translation, uploads, and bulk edits do not emit this event.
`2`	`translation_changed`	S’ha canviat la traducció	An existing translation was edited by a user.
`3`	`comment_added`	S’ha afegit un comentari	A comment was added to a string.
`4`	`suggestion_added`	S’ha afegit un suggeriment	A translation suggestion was added.
`5`	`translation_added`	S’ha afegit una traducció	A previously untranslated string was translated by a user.
`6`	`automatically_translated`	Traduïda automàticament	A translation was added or changed by automatic translation. This is emitted instead of Translation added or Translation changed.
`7`	`suggestion_accepted`	S’ha acceptat el suggeriment	A translation suggestion was accepted as the translation.
`8`	`translation_reverted`	S’ha revertit la traducció	A translation was restored to an earlier value.
`9`	`translation_uploaded`	S’ha pujat la traducció	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`	S’ha afegit una cadena d’origen	A source string was added outside repository or upload updates.
`14`	`component_locked`	S’ha blocat el component	A component was locked for translation.
`15`	`component_unlocked`	S’ha desblocat el component	A component was unlocked for translation.
`17`	`changes_committed`	S’han publicat els canvis	Pending component changes were committed.
`18`	`changes_pushed`	S’han pujat els canvis	Repository changes were pushed upstream.
`19`	`repository_reset`	S’ha reinicialitzat el repositori	A repository was reset to its upstream state.
`20`	`repository_merged`	S’ha fusionat el repositori	Upstream repository changes were merged.
`21`	`repository_rebased`	S’ha fet «rebase» al repositori	Repository changes were rebased on upstream.
`22`	`repository_merge_failed`	S’ha produït un error en fusionar el repositori	Merging upstream repository changes failed.
`23`	`repository_rebase_failed`	S’ha produït un error en fer «rebase» al repositori	Rebasing repository changes failed.
`24`	`parsing_failed`	S’ha produït un error en l’anàlisi	Weblate could not parse a translation file.
`25`	`translation_removed`	S’ha suprimit una traducció	A language translation was removed.
`26`	`suggestion_removed`	S’ha suprimit el suggeriment	A translation suggestion was removed.
`27`	`translation_replaced`	S’ha substituït una traducció	A translation was changed by a search-and-replace operation. This is emitted instead of Translation changed.
`28`	`repository_push_failed`	S’ha produït un error en pujar el repositori	Pushing repository changes upstream failed.
`29`	`suggestion_removed_during_cleanup`	S’ha suprimit el suggeriment durant la neteja	An obsolete translation suggestion was removed during cleanup.
`30`	`source_string_changed`	S’ha canviat la cadena d’origen	A source string was edited in Weblate.
`31`	`string_added`	S’ha afegit una cadena	A new string was added in Weblate.
`32`	`bulk_status_changed`	S’ha canviat l’estat de manera massiva	The translation state of one or more strings was changed in bulk.
`33`	`visibility_changed`	S’ha canviat la visibilitat	Project or component visibility was changed.
`34`	`user_added`	S’ha afegit un usuari	A user was granted access.
`35`	`user_removed`	S’ha suprimit un usuari	A user’s access was removed.
`36`	`translation_approved`	S’ha aprovat la traducció	A translation was approved during review.
`37`	`marked_for_edit`	S’ha marcat com a «cal editar»	A translation was marked as needing editing.
`38`	`component_removed`	S’ha suprimit un component	A translation component was removed.
`39`	`project_removed`	S’ha suprimit un projecte	A translation project was removed.
`41`	`project_renamed`	S’ha canviat el nom d’un projecte	A translation project was renamed.
`42`	`component_renamed`	S’ha canviat el nom d’un component	A translation component was renamed.
`43`	`moved_component`	S’ha mogut el component	A component was moved within a project.
`45`	`contributor_joined`	S’ha unit un col·laborador	A user made their first contribution to a translation.
`46`	`announcement_posted`	S’ha publicat un anunci	An announcement was posted.
`47`	`alert_triggered`	S’ha activat una alerta	A component alert was triggered.
`48`	`language_added`	S’ha afegit una llengua	A language translation was added.
`49`	`language_requested`	S’ha sol·licitat una llengua	A user requested a new language.
`50`	`project_created`	S’ha creat un projecte	A translation project was created.
`51`	`component_created`	S’ha creat un component	A translation component was created.
`52`	`user_invited`	S’ha convidat un usuari	A user was invited to a project.
`53`	`repository_notification_received`	S’ha rebut una notificació del repositori	Weblate received a repository notification from a code host.
`54`	`translation_replaced_file_by_upload`	S’ha substituït el fitxer de la traducció per una pujada	A translation file was replaced by an uploaded file.
`55`	`license_changed`	S’ha canviat la llicència	Project or component license information changed.
`56`	`contributor_license_agreement_changed`	Ha canviat l’acord de llicència de col·laboració	The contributor license agreement was changed.
`57`	`screenshot_added`	S’ha afegit una captura de pantalla	A screenshot was associated with a string.
`58`	`screenshot_uploaded`	S’ha pujat una captura de pantalla	A screenshot image was uploaded.
`59`	`string_updated_in_the_repository`	Cadena actualitzada al repositori	A string was changed while synchronizing from the repository.
`60`	`add-on_installed`	S’ha instal·lat un complement	An add-on was installed.
`61`	`add-on_configuration_changed`	S’ha canviat la configuració d’un complement	An add-on’s configuration was changed.
`62`	`add-on_uninstalled`	S’ha desinstal·lat un complement	An add-on was uninstalled.
`63`	`string_removed`	S’ha suprimit una cadena	A string was removed from a translation.
`64`	`comment_removed`	S’ha suprimit un comentari	A string comment was removed.
`65`	`comment_resolved`	S’ha resolt el comentari	A string comment was marked as resolved.
`66`	`explanation_updated`	S’ha actualitzat l’explicació	The explanation for a source string was updated.
`67`	`category_removed`	S’ha suprimit una categoria	A component category was removed.
`68`	`category_renamed`	S’ha canviat de nom una categoria	A component category was renamed.
`69`	`category_moved`	S’ha mogut una categoria	A component category was moved.
`70`	`saving_string_failed`	S’ha produït un error en desar una cadena	Weblate could not save a changed string.
`71`	`string_added_in_the_repository`	Cadena afegida al repositori	A new string was found while synchronizing from the repository.
`72`	`string_updated_in_the_upload`	Cadena actualitzada a la pujada	A string was changed while processing an uploaded file.
`73`	`string_added_in_the_upload`	Cadena afegida a la pujada	A new string was found while processing an uploaded file.
`74`	`translation_updated_by_source_upload`	S’ha actualitzat la traducció amb una pujada de la font	A translation was synchronized after uploading a source file.
`75`	`component_translation_completed`	S’ha completat la traducció del component	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`	S’ha aplicat una comprovació obligatòria	A translation was marked as needing editing by an enforced check.
`77`	`propagated_change`	S’ha propagat un canvi	A translation edit was propagated to another matching string.
`78`	`file_uploaded`	S’ha pujat un fitxer	A file was uploaded to a translation.
`79`	`extra_flags_updated`	S’han actualitzat les marques extres	Additional source-string flags were updated.
`80`	`font_uploaded`	S’ha pujat una font	A font was uploaded.
`81`	`font_changed`	S’ha canviat una font	An uploaded font was changed.
`82`	`font_removed`	S’ha suprimit una font	An uploaded font was removed.
`83`	`forced_synchronization_of_translations`	S’ha forçat la sincronització de les traduccions	Translation files were forcibly synchronized with the repository.
`84`	`forced_rescan_of_translations`	S’ha forçat un reescaneig de les traduccions	Translation files were forcibly rescanned for changes.
`85`	`screenshot_removed`	S’ha suprimit una captura de pantalla	A screenshot was removed.
`86`	`label_added`	S’ha afegit una etiqueta	A label was added to a string.
`87`	`label_removed`	S’ha suprimit una etiqueta	A label was removed from a string.
`88`	`repository_cleanup`	S’ha netejat el repositori	The repository working tree was cleaned up.
`89`	`source_string_added_in_the_upload`	Source string added in the upload	A source string was added while processing an uploaded file.
`90`	`source_string_added_in_the_repository`	Source string added in the repository	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.

Customizing list of add-ons¶

La llista de complements es configura mitjançant WEBLATE_ADDONS. Per afegir un altre complement, només cal incloure el nom absolut de la classe en aquesta configuració.

Writing add-on¶

També podeu escriure els vostres propis complements, crear una subclasse de weblate.addons.base.BaseAddon per definir les metadades del complement i, a continuació, implementar una devolució de trucada per fer el processament.

Vegeu també

Developing add-ons

Executing scripts from add-on¶

Els complements també es poden utilitzar per executar scripts externs. Abans s’integrava a Weblate, però ara heu d’escriure algun codi per embolicar el vostre script amb un complement.

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

Per obtenir instruccions d’instal·lació, consulteu Custom quality checks, add-ons, automatic suggestions and auto-fixes.

L’script s’executa amb el directori actual establert a l’arrel del dipòsit VCS per a qualsevol component determinat.

A més, hi ha disponibles les variables d’entorn següents:

WL_VCS¶: Sistema de control de versions utilitzat.

WL_REPO¶: URL del repositori amunt.

WL_PATH¶: Camí absolut al repositori VCS.

WL_BRANCH¶: Branca del repositori configurada al component actual.

WL_FILEMASK¶: Màscara de fitxer per al component actual.

WL_TEMPLATE¶: Nom del fitxer de la plantilla per a traduccions monolingües (pot estar buit).

WL_NEW_BASE¶: Nom del fitxer utilitzat per crear noves traduccions (pot estar buit).

WL_FILE_FORMAT¶: File format used in current component.

WL_LANGUAGE¶: Idioma de la traducció processada actualment (no disponible per a ganxos a nivell de components).

WL_PREVIOUS_HEAD¶: HEAD anterior després de l’actualització (només disponible després d’executar el ganxo posterior a l’actualització).

WL_COMPONENT_SLUG¶: Slug de components utilitzat per construir l’URL.

WL_PROJECT_SLUG¶: Slug del projecte utilitzat per construir l’URL.

WL_COMPONENT_NAME¶: Nom del component.

WL_PROJECT_NAME¶: Nom del projecte.

WL_COMPONENT_URL¶: URL del component.

WL_ENGAGE_URL¶: URL d’interacció del projecte.

Vegeu també

Configuració dels components

Post-update repository processing¶

Es pot utilitzar per actualitzar fitxers de traducció quan canvia la font ascendent del VCS. Per aconseguir-ho, recordeu que Weblate només veu els fitxers compromesos amb el VCS, de manera que heu de confirmar els canvis com a part de l’script.

Per exemple, amb Gulp, podeu fer-ho utilitzant el codi següent:

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

Pre-commit processing of translations¶

Utilitzeu l’script de confirmació per canviar automàticament una traducció abans que es comprometi al repositori.

Es passa com un únic paràmetre que consisteix en el nom de fitxer d’una traducció actual.

Add-on activity logging¶

El registre d’activitat del complement fa un seguiment de l’execució del complement i es pot utilitzar per fer un seguiment de l’activitat del complement.

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.

Els registres es poden retallar després d’un interval de temps determinat configurant el ADDON_ACTIVITY_LOG_EXPIRY.

Complements¶

Events that trigger add-ons¶

Add-on installation¶

Component update¶

Cada dia¶

Event change¶

Manual trigger¶

Repository post-add¶

Repository post-commit¶

Repository post-push¶

Repository post-remove¶

Repository post-update¶

Repository pre-commit¶

Repository pre-push¶

Repository pre-update¶

Unitat després de desar¶

Post-sincronització de la unitat¶

Precreació de la unitat¶

Built-in add-ons¶

Traducció automatitzada¶

CDN de localització de JavaScript¶

Translation files CDN¶

Suprimeix les cadenes buides¶

Neteja els fitxers de traducció¶

Afegeix les llengües que hi manquin¶

Descobriment de components¶

Requisits de descoberta¶

Exemple treballat: news_<lang>.md¶

Component discovery examples¶

One folder per language¶

Disposició de configuracions regionals del gettext¶

Complex filenames¶

Repeated language code¶

Split Android strings¶

Matching multiple paths¶

Fedora Messaging¶

Message topic¶

Message body¶

Message headers¶

Example messages¶

Edició massiva¶

Flag unchanged translations as «Needs rewriting»¶

Flag new source strings as «Needs checking»¶

Flag new translations as «Needs rewriting»¶

Flag updated translations from repository as «Needs rewriting»¶

Omple les cadenes de només lectura amb l’origen¶

Generador d’estadístiques¶

Preomple la traducció amb l’origen¶

Generació de pseudolocalitzacions¶

Col·laboradors als comentaris¶

Actualitza la variable ALL_LINGUAS del fitxer «configure»¶

Personalitza la sortida del gettext¶

Actualitza la plantilla de gettext (Django)¶

Django requirements¶

Actualitza el fitxer LINGUAS¶

Update POT file (Meson)¶

Meson requirements¶

Genera els fitxers MO¶

Actualitza els fitxers PO perquè coincideixin amb el POT (msgmerge)¶

Actualitza el fitxer POT (Sphinx)¶

Sphinx requirements¶

Update POT file (xgettext)¶

xgettext requirements¶

Fes comissions «squash» al Git¶

Personalitza la sortida JSON¶

Reinicialitza el dipòsit a la font¶

Formata el fitxer de propietats de Java¶

Supressió de comentaris antics¶

Supressió de suggeriments antics¶

Actualitza els fitxers RESX¶

Webhooks de Slack¶

Webhook¶

Obsolete add-ons¶

Personalitza la sortida XML¶

Personalitza la sortida YAML¶

Common add-on parameters¶

Motors de traducció automàtica¶

Format de fitxer¶

Change events to trigger¶

Selected change events¶

Exemple treballat: `news_<lang>.md`¶