Projectes de traducció¶
Organització de la traducció¶
Weblate organitza el contingut VCS traduïble del projecte/components en una estructura en forma d’arbre. També podeu organitzar components dins d’un projecte mitjançant categories.
The bottom level object is Configuració del projecte, which should hold all translations belonging together (for example translation of an application in several versions and/or accompanying documentation).
El nivell mitjà el crea opcionalment Categoria. Les categories es poden niuar per aconseguir una estructura més complexa.
Al nivell superior, Configuració dels components, que en realitat és el component a traduir, definiu el repositori VCS a utilitzar i la màscara dels fitxers a traduir.
A sobre de Configuració dels components hi ha traduccions individuals, gestionades automàticament per Weblate ja que els fitxers de traducció (que coincideixen amb Filtre de fitxers definits a Configuració dels components) apareixen al repositori VCS.
Weblate admet una àmplia gamma de formats de traducció (tant bilingües com monolingües) compatibles amb Translate Toolkit, vegeu Localization file formats.
Nota
Podeu compartir repositoris VCS clonats mitjançant URL interns del lloc web. És molt recomanable utilitzar aquesta funció quan teniu molts components que comparteixen el mateix VCS. Millora el rendiment i disminueix l’espai de disc necessari.
Afegir projectes i components de traducció¶
Based on your permissions, new translation projects and components can be created. It is always permitted for users with the Add new projects permission, and if your instance uses billing (e.g. like https://hosted.weblate.org/ see Facturació), you can also create those based on your plans allowance from the user account that manages billing. Projects can also be created in a workspace by users who have the Add projects to workspace permission in that workspace. Creating a project without selecting a workspace requires the site-wide Add new projects permission. See Project creation and moves for details.
Suggeriment
Per atorgar permís a tots els usuaris per crear nous projectes, creeu un nou Automatic team assignments per a l’equip de Creadors de projectes.
Podeu veure el vostre pla de facturació actual en una pàgina independent:
La creació del projecte es pot iniciar des d’allà, o utilitzant el menú de la barra de navegació, omplint informació bàsica sobre el projecte de traducció per completar-ne l’addició:
Després de crear el projecte, se us dirigirà directament a la pàgina del projecte:
La creació d’un nou component de traducció es pot iniciar amb un sol clic allà. El procés de creació d’un component té diverses etapes i detecta automàticament la majoria dels paràmetres de traducció. Hi ha diversos enfocaments per crear un component:
- A partir del control de versions
Crea component des del dipòsit de control de versions remot.
- A partir d’un component existent
Crea un component addicional a l’existent escollint diferents fitxers.
- Branca addicional
Creates additional component to existing one, just for different branch. Select a component to load its available remote branches. If loading fails, use Retry to try again.
- Puja fitxers de traduccions
Carregueu fitxers de traducció a Weblate en cas que no disposeu de control de versions o no voleu integrar-lo amb Weblate. Més tard podeu actualitzar el contingut mitjançant la interfície web o API REST del Weblate.
- Tradueix un document
Carregueu un document únic o un fitxer de traducció i traduïu-lo.
- Comença de zero
Creeu un projecte de traducció en blanc i afegiu cadenes manualment.
Un cop tingueu components de traducció existents, també podeu afegir-ne de nous fàcilment per a fitxers o branques addicionals utilitzant el mateix dipòsit.
Primer heu d’emplenar el nom i la ubicació del repositori:
A la pàgina següent, se us presenta una llista de recursos traduïbles descoberts:
If discovery reaches a resource limit, Weblate warns that the list might be incomplete. You can configure missing translation files manually.
Com a darrer pas, reviseu la informació del component de traducció i empleneu els detalls opcionals:
Configuració del projecte¶
Creeu un projecte de traducció i, a continuació, afegiu-hi un component nou per a la traducció. El projecte és com un prestatge, en el qual s’apilen traduccions reals. Tots els components d’un mateix projecte comparteixen suggeriments i el seu diccionari; les traduccions també es propaguen automàticament a través de tots els components d’un sol projecte (tret que estigui desactivat a la configuració del component), vegeu Memòria de Traducció.
Vegeu també
Aquests atributs bàsics configuren i informen els traductors d’un projecte:
Nom del projecte¶
Nom detallat del projecte, utilitzat per mostrar el nom del projecte.
Vegeu també
URL amigable¶
Nom del projecte adequat per a URL.
Lloc web del projecte¶
URL on els traductors poden trobar més informació sobre el projecte.
Aquest és un paràmetre obligatori tret que estigui desactivat per WEBSITE_REQUIRED.
Instruccions de traducció¶
Text que descrigui el procés de localització en el projecte i qualsevol altra informació útil per als traductors. Markdown es pot utilitzar per donar format al text o inserir enllaços.
Good translation instructions explain how contributors should submit translations, what review they should expect, how they can report problems with source strings, and where translations can be tested or when they are released.
Llicència de la traducció¶
Default translation license for components in this project.
Vegeu també
Acord de llicència de col·laboració¶
Acord de llicència de col·laborador predeterminat per als components d’aquest projecte. Markdown es pot utilitzar per donar format al text o inserir enllaços.
Use workspace translation memory¶
Whether to use translation memory shared by projects in the same workspace, see Translation-memory scopes for more details. The workspace has to allow workspace translation memory as well.
The default value can be changed by DEFAULT_WORKSPACE_TM.
Contribute to workspace translation memory¶
Whether to contribute translations to the translation memory shared by projects in the same workspace. The workspace has to allow contribution as well.
The default value can be changed by DEFAULT_WORKSPACE_TM.
Nota
This option is unavailable on Hosted Weblate, it is toggled together with Use workspace translation memory.
Neteja automàticament la memòria de traducció¶
Afegit a la versió 5.13.
Whether to replace older automatically created translation memory entries when a translation becomes active.
La concordança es basa en la mateixa cadena d’origen, component, context i parell d’idiomes font/destinació. Els fitxers de memòria de traducció penjats no es veuen afectats.
Control d’accés¶
Configureu el control d’accés per projecte, vegeu Control d’accés del projecte per a més detalls.
El valor predeterminat es pot canviar mitjançant DEFAULT_ACCESS_CONTROL.
Public sharing¶
Allow anonymous access to the project’s engage pages and rendered status widgets. This setting applies to Private and Custom projects; Public and Protected projects are always publicly shareable.
Public sharing exposes project and component names, including restricted components, together with translation statistics, languages, and progress. It does not grant access to project pages, translations, repositories, or the API.
Changing this setting has no immediate effect while the project is Public or Protected, but the stored value is retained and applies if the project is later changed to Private or Custom. Sitemaps for project, component, and translation pages only include pages that are directly accessible anonymously. Engage sitemaps follow the public sharing setting.
Changing this setting requires the Manage project access permission. The status widget configuration page continues to use normal project access control.
When REQUIRE_LOGIN is enabled, PUBLIC_ENGAGE must also be
enabled for anonymous access to engage pages and sitemaps.
Autenticació de doble factor obligatòria¶
Afegit a la versió 5.7.
Enforce Autenticació de doble factor for all contributors. Users won’t be allowed to perform any operations within the project without having it configured. This also excludes the project from component creation, move, and sharing targets, including GitHub App imports. Site administrators and bot accounts retain their existing exemptions.
Activa les revisions¶
Enable review workflow for translations, see Revisors dedicats.
Activa les revisions d’origen¶
Activeu el flux de treball de revisió per a les cadenes d’origen, vegeu Ressenyes de cadenes d’origen.
Filtre de qualitat de les traduccions¶
Afegit a la versió 5.13.
La política de confirmació determina quines traduccions s’inclouen quan es comprometen els canvis al sistema de control de versions. Aquesta configuració està disponible a nivell de projecte i admet les opcions següents:
Comprometeu totes les traduccions independentment de la qualitat: es comprometran totes les traduccions, incloses les marcades com a que necessiten edició o no revisades.
Omet les traduccions marcades com a que necessiten edició: només es confirmaran les traduccions que no tinguin l’estat «necessita edició», «necessita reescriptura» o «necessitat comprovació».
Inclou només traduccions aprovades: només es comprometran les traduccions que hagin estat aprovades per un revisor. Aquesta opció requereix que Activa les revisions estigui habilitat.
The approved-only policy applies only to translations with reviews enabled. Languages with reviews disabled through Personalització del flux de treball commit all translations, including those marked as needing editing. Source strings follow the same rule using Activa les revisions d’origen.
Components linked to a repository in another project follow their own project’s commit policy.
If the editor shows “Only approved translations are written to the translation file.” or “Approval is required before this translation can be written to the translation file.”, the quality filter prevents writing the translation to the file until it is approved. This notice does not confirm that your current edit was saved; resolve any validation errors before leaving the editor. The project policy description qualifies this as “For languages with reviews enabled, only approved translations are written to the translation file.” Having permission to approve translations does not automatically approve your edits.
For a language that does not use reviews, open its page in the project and choose Settings. Enable Customize translation workflow for this language in this project, then turn Enable reviews off. This requires permission to edit project settings. See Personalització del flux de treball. With the approved-only policy, this makes all translation states eligible for writing to files for that language, including those needing editing.
If reviews are needed, users with both review and bulk-edit permissions can use Edició massiva to approve existing translations they have reviewed. Eligibility for writing to a translation file does not mean the change is immediately committed or pushed; see La mandrosa es compromet and Puja en fer una comissió.
Activa els punts d’inserció¶
Whether unauthenticated Punts d’inserció de notificacions are to be used for this repository.
Àlies de llengua¶
Definiu l’assignació de codis d’idioma quan importeu traduccions a Weblate. Utilitzeu-ho quan els codis d’idioma siguin inconsistents als vostres repositoris i voleu obtenir una visió coherent a Weblate o en cas que vulgueu utilitzar un nom no estàndard dels vostres fitxers de traducció.
El cas d’ús típic podria ser l’assignació de l’anglès americà a l’anglès: en_US:en
Múltiples mapes que s’han de separar per comes: en_GB:en,en_US:en
Utilitzant codi no estàndard: ia_FOO:ia
The mapped language code must resolve to an existing language or be a valid code for a new language. The source code can use non-standard naming from the translation files.
Suggeriment
Els codis d’idioma es mapegen quan coincideixen amb els fitxers de traducció i les coincidències distingeixen entre majúscules i minúscules, així que assegureu-vos d’utilitzar els codis d’idioma font de la mateixa forma que s’utilitza als noms de fitxer.
Addició de traduccions noves¶
Comportament predeterminat per a les sol·licituds de creació de traduccions noves als components d’aquest projecte.
Estil del codi de llengua¶
Default language code style for translations created by Weblate in components in this project.
Vegeu també
Llengua secundària¶
Afegit a la versió 5.11.
Llengua addicional que es mostra juntament amb la llengua d’origen mentre es tradueix.
Opcionalment, també es pot utilitzar com a font per a la traducció automàtica.
Marques de traducció¶
Afegit a la versió 5.11.
Personalització de les comprovacions de qualitat i altres comportaments de Weblate, vegeu Personalització del comportament mitjançant banderes.
Les marques d’espai de treball, projecte, component i traducció es combinen.
Vegeu també
Commit, add, delete, merge, add-on, and merge request messages¶
Plantilles de missatges de sol·licitud de confirmació i fusió per defecte per als components d’aquest projecte.
The default values can be changed by DEFAULT_ADD_MESSAGE,
DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE,
DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE,
DEFAULT_PULL_MESSAGE.
Els valors predeterminats integrats segueixen els compromisos convencionals i inclouen enllaços Weblate quan estiguin disponibles. Utilitzeu Restaura el lloc predeterminat al costat d’un editor de missatges per restaurar la instal·lació per defecte actual d’aquest missatge; per als valors heretats, això també desactiva l’herència per a aquest missatge.
Vegeu també
Configuració dels components¶
Un component és una agrupació d’alguna cosa per a la traducció. Introduïu una ubicació de repositori VCS i una màscara de fitxer per als fitxers que voleu traduir i Weblate s’obté automàticament d’aquest VCS i troba tots els fitxers traduïbles coincidents.
Vegeu també
Podeu trobar alguns exemples de configuracions típiques als Localization file formats.
Nota
Es recomana mantenir els components de traducció a una mida raonable: dividiu la traducció per qualsevol cosa que tingui sentit en el vostre cas (aplicacions o complements individuals, capítols de llibres o llocs web).
Weblate gestiona fàcilment traduccions amb 10000 cadenes, però és més difícil dividir el treball i coordinar-se entre traductors amb components de traducció tan grans.
Si falta la definició d’idioma per a una traducció, es crea una definició buida i s’anomena «cs_CZ (generada)». Hauríeu d’ajustar la definició i informar-ho als autors de Weblate, de manera que els idiomes que falten es puguin incloure a la propera versió.
El component conté tots els paràmetres importants per treballar amb el VCS i per treure’n traduccions:
Nom del component¶
Nom detallat del component, utilitzat per mostrar el nom del component.
Component llimac¶
Nom del component adequat per a URL.
Projecte component¶
Configuració del projecte where the component belongs.
Sistema de control de versions¶
VCS per utilitzar, vegeu Integració del control de versions per a més detalls.
After creating a component, you can switch only between compatible backends offered in the settings form. Switching to another VCS family requires recreating the component. Backends managed by an authenticated integration are available through their provider import flow, not generic component creation.
Vegeu també
Version control parameters¶
Parameters tuning how Weblate interacts with the repository, for example whether to force push or to open pull requests. Only parameters applicable to the selected Sistema de control de versions are shown, see also Version control parameters.
Nota
The settings form silently drops parameters which do not apply to the
selected version control system, but the REST API rejects them. When
changing Sistema de control de versions over the API, clear or replace vcs_params
in the same request. The same applies to
Paràmetres del format de fitxer and Format de fitxer.
Repositori del codi font¶
El repositori VCS s’utilitza per extreure canvis.
Vegeu també
Vegeu Accés als repositoris per obtenir més detalls sobre com especificar URL.
Suggeriment
Pot ser un URL VCS real o weblate://project/component que indica que el repositori s’ha de compartir amb un altre component. Vegeu URL interns del lloc web per a més detalls.
Creating a repository link requires access to the referenced component and permission to edit it. Missing components and components you cannot access produce the same validation error.
URL de pujada al repositori¶
URL del repositori utilitzat per enviar. El comportament d’això depèn de Sistema de control de versions, i això es tracta amb més detall a Impulsant canvis des de Weblate.
Per als dipòsits enllaçats, això no s’utilitza i s’aplica la configuració del component enllaçat.
Vegeu també
Vegeu Accés als repositoris per obtenir més detalls sobre com especificar un URL de repositori i Impulsant canvis des de Weblate per obtenir més detalls sobre com enviar canvis des del Weblate.
Navegador del repositori¶
URL del navegador del dipòsit utilitzat per mostrar els fitxers font (ubicació dels missatges utilitzats). Quan estiguin buits, no es generaran aquests enllaços. Podeu utilitzar Marcatge de plantilla.
Per exemple a GitHub, utilitzeu alguna cosa com: https://github.com/WeblateOrg/hello/blob/{{branch}}/{{filename}}#L{{line}}
In case your paths are relative to different folder (path contains ..), you
might want to strip leading directory by parentdir filter (see
Marcatge de plantilla):
https://github.com/WeblateOrg/hello/blob/{{branch}}/{{filename|parentdir}}#L{{line}}
Vegeu també
Repository browser for translations¶
URL of repository browser used to display translation files. When empty, the Navegador del repositori URL will be used as a fallback. This is useful when source-code files and translation files are hosted in different repositories. It applies to all translation files, including source-language, intermediate, template, and target files. You can use Marcatge de plantilla.
For example on GitHub, use something like:
https://github.com/WeblateOrg/translations/blob/{{branch}}/{{filename}}#L{{line}}
Vegeu també
URL del repositori exportat¶
URL where changes made by Weblate are exported. This is important when Localització contínua is not used, or when there is a need to manually merge changes. You can use Exportador de Git to automate this for Git repositories.
Branca del repositori¶
Quina branca cal pagar des del VCS i on buscar traduccions.
Per als dipòsits enllaçats que utilitzen URL interns del lloc web, aquesta configuració està controlada pel component enllaçat que és propietari del dipòsit. Els components secundaris enllaçats utilitzen el valor d’aquest component.
Branca per a la pujada¶
Branca per impulsar canvis, deixeu-lo en blanc per utilitzar Branca del repositori.
Per als dipòsits enllaçats que utilitzen URL interns del lloc web, aquesta configuració està controlada pel component enllaçat que és propietari del dipòsit. Els components secundaris enllaçats utilitzen el valor d’aquest component.
Nota
This setting is ignored for Mercurial and Subversion.
For Gerrit, this selects the target branch for the review request. Leave it
empty to review against Branca del repositori. Use the short branch name,
not refs/heads/<branch> or refs/for/<branch>. Gerrit push options
can be appended after % in either setting, for example
main%topic=l10n; Gerrit interprets them as the configured Weblate Gerrit
account.
Vegeu també
Filtre de fitxers¶
Mask of files to translate, including path. It should include one «*» replacing language code (see Definicions del llenguatge for info on how this is processed). In case your repository contains more than one translation file (e.g. more gettext domains), you need to create a component for each of them.
Per exemple po/*.po o locale/*/LC_MESSAGES/django.po.
En cas que el vostre nom de fitxer contingui caràcters especials com ara [, ], aquests s’han d’escapar com a [[] o []].
File-mask scans are limited to 100,000 traversal work units and five seconds, including processing the matches. Each visited traversal state and examined directory entry counts toward the work limit, even when it does not match. Exceeding either limit fails the scan without using partial results. Narrow the mask to the relevant directories if a scan exceeds these limits.
Directory symlinks within the repository are supported. Scans skip links outside the repository, links to managed VCS metadata, and directory cycles. The time limit is checked between filesystem operations; it cannot interrupt an operation blocked on storage.
Filtre de fitxers de captures de pantalla¶
Aquesta característica permet descobrir i actualitzar captures de pantalla mitjançant màscares de fitxers de captures de pantalla, utilitzant camins des del dipòsit VCS. Això funciona a nivell de component i requereix l’ús d’un asterisc «*» per substituir el nom del fitxer de captura de pantalla.
Els formats permesos són WebP, JPEG, PNG, APNG i GIF.
Note:
La màscara de fitxer i la màscara de fitxer de captura de pantalla no estan relacionades. Configureu-los per separat.
És un treball manual per enllaçar una captura de pantalla descoberta en un component amb una clau de traducció específica.
Per exemple:
Suposem que el vostre dipòsit VCS té una estructura com aquesta:
component_A
└── docs
├── image1.png
└── image2.jpg
Per al component_A, voleu permetre la descoberta i les actualitzacions de les captures de pantalla PNG. Definiria la màscara del fitxer de captura de pantalla per al component_A com a component_A/docs/*.png. Això vol dir que es poden descobrir i actualitzar qualsevol imatge PNG sota els documents del component_A. Per tant, si voleu actualitzar image1.png, la nova captura de pantalla que proporcioneu s’hauria de anomenar image1.png, coincidint amb el filename existent, i emmagatzemat a component_A/docs/.
For Android projects using Fastlane metadata, a source-language screenshot mask
can point to the metadata screenshot folder, for example
fastlane/metadata/android/en-US/images/phoneScreenshots/*.png. Weblate will
discover matching screenshots on repository update. The discovered screenshots
still need to be associated with source strings in the screenshot management
interface; use image text recognition or source string search there to assign them in bulk.
Fitxer de llengua base monolingüe¶
Base file containing string definitions for Project and component creation.
Edita el fitxer base¶
Si es permet l’edició de cadenes a la Fitxer de llengua base monolingüe.
Fitxer de llengua intermèdia¶
Intermediate language file for Project and component creation. In most cases this is a translation file provided by developers and is used when creating actual source strings.
Quan s’estableixen, les cadenes d’origen es basen en aquest fitxer, però tots els altres idiomes es basen en Fitxer de llengua base monolingüe. En cas que la cadena no es tradueixi a l’idioma d’origen, està prohibida la traducció a altres idiomes. Això proporciona Passarel·la de qualitat per a les cadenes d’origen.
The intermediate file can match an existing language file. While it is configured as intermediate, Weblate does not list it as a regular language in the component language list. Clearing this setting makes the file appear as a regular language again on the next component scan.
Target strings can become read-only while the intermediate file is configured. This happens for strings where the matching source string in the Fitxer de llengua base monolingüe is not translated yet.
Plantilla per a traduccions noves¶
Base file used to generate new translations.
Manteniu aquest camp buit per a la majoria dels formats monoliguals. Normalment poden començar des d’un fitxer buit.
Choose
.potfile with GNU gettext PO files.Trieu un fitxer en blanc sense traduccions, si en teniu.
Trieu Fitxer de llengua base monolingüe per als formats monolingües que necessiten un conjunt complet de claus presents.
Choose Fitxer de llengua base monolingüe for document translations.
Choose any translation file for others.
El fitxer de plantilla pot ser el mateix que el fitxer base en la majoria dels casos.
Suggeriment
En molts formats monolingües, Weblate comença amb un fitxer buit per defecte. Utilitzeu-ho en cas que vulgueu tenir totes les cadenes presents amb un valor buit quan creeu una traducció nova.
Format de fitxer¶
Format de fitxer de traducció, vegeu també Localization file formats.
Paràmetres del format de fitxer¶
Els paràmetres utilitzats per configurar com es processen els fitxers de traducció, vegeu també Paràmetres del format de fitxer.
Adreça per a informes d’errors de les cadenes d’origen¶
Adreça de correu electrònic utilitzada per informar d’errors amunt. Aquesta adreça també rebrà una notificació sobre qualsevol comentari de cadena d’origen fet a Weblate.
Amb el format GNU gettext PO (objecte portàtil), aquesta adreça també la desa Weblate a la capçalera Report-Msgid-Bugs-To del fitxer.
No mostris les coincidències del glossari¶
Amaga el plafó del glossari i les seves coincidències a l’editor de traducció d’aquest component. Quan està activat, els suggeriments de glossari per a aquest component no es calculen i el tauler de glossari (inclosa la seva acció «Afegeix un terme al glossari») s’amaga a l’editor.
Nota
Les autoreferències del glossari sempre s’exclouen de les coincidències fins i tot quan aquesta opció estigui desactivada.
Vegeu també
Contribueix a la memòria de traducció del projecte¶
Controls whether translations from this component are added to the project translation memory.
Vegeu també
Permet la propagació de traduccions¶
You can turn off propagation of translations to this component from other components within the configured workspace propagation scope. By default, propagation stays within the same project. This depends on what you are translating; sometimes it is desirable to reuse a translation more than once.
Normalment és una bona idea desactivar-ho per a traduccions monolingües, tret que utilitzeu els mateixos identificadors en tot el projecte.
El valor predeterminat es pot canviar mitjançant DEFAULT_TRANSLATION_PROPAGATION.
Habilita suggerències¶
Si s’accepten suggeriments de traducció per a aquest component.
Vegeu també
Vots als suggeriments¶
Activa l’emissió de vots per a suggeriments, vegeu Vots als suggeriments.
Vegeu també
Accepta automàticament els suggeriments¶
Accepteu automàticament els suggeriments votats, vegeu Vots als suggeriments.
When the vote threshold is reached, the suggestion can replace an approved translation even if the voters cannot review translations. A replacement returns to the waiting-for-review state when reviews are enabled. Use this setting only when voting should authorize this change.
Read-only strings remain unchanged. Votes are recorded and the suggestion stays pending for a later permitted acceptance.
Vegeu també
Marques de traducció¶
Personalització de les comprovacions de qualitat i altres comportaments de Weblate, vegeu Personalització del comportament mitjançant banderes.
Les marques d’espai de treball, projecte, component i traducció es combinen.
Vegeu també
Comprovacions obligatòries¶
Llista de comprovacions que no es poden ignorar.
This setting can be inherited from the workspace, project, or category (see Settings inheritance). When a new enforced check is inherited, existing failing translations are reverted to the Needs editing state in the background.
Vegeu també
Llicència de la traducció¶
Llicència de la traducció (no cal que sigui la mateixa que la llicència del codi font).
Vegeu també
Acord de llicència de col·laboració¶
Acord de llicència de col·laboració que cal aprovar abans que un usuari pugui traduir aquest component.
Markdown es pot utilitzar per donar format al text o inserir enllaços.
Vegeu també
Addició de traduccions noves¶
Com gestionar les sol·licituds de creació de nous idiomes. Opcions disponibles:
- Contacta amb els responsables
L’usuari pot seleccionar l’idioma desitjat i els responsables del projecte rebran una notificació sobre això. Depèn d’ells afegir (o no) l’idioma al repositori.
- Apunta a l’URL d’instruccions per a la traducció
Es presenta a l’usuari un enllaç a la pàgina que descriu el procés d’inici de noves traduccions. Utilitzeu-ho en cas que es desitgi un procés més formal (per exemple, formar un equip de persones abans de començar la traducció real).
- Crea un fitxer de llengua nou
L’usuari pot seleccionar l’idioma i Weblate crearà automàticament el fitxer i la traducció pot començar.
- Create existing project languages; contact maintainers for new languages
Users can create translations for languages already used as target languages in another non-glossary component in the project. Other languages are requested from maintainers, who approve them by creating the first target translation. See Limiting translation languages for eligibility and API behavior.
- Desactiva l’addició de traduccions noves
No hi haurà cap opció perquè l’usuari comenci una traducció nova.
Suggeriment
Els administradors del projecte poden afegir noves traduccions encara que estigui desactivat aquí quan sigui possible (ja sigui Plantilla per a traduccions noves o el format de fitxer admet començar des d’un fitxer buit).
Gestiona les cadenes¶
Afegit a la versió 4.5.
Configures whether users in Weblate will be allowed to add new strings and remove existing ones. It also enables editing source strings and keys in supported formats. Adjust this to match your localization workflow — how strings are introduced and maintained.
Per als formats bilingües, les cadenes normalment s’extreuen del codi font (per exemple, utilitzant xgettext) i afegir cadenes noves a Weblate hauria d’estar desactivada (es descartarien la propera vegada que actualitzeu els fitxers de traducció). A Weblate podeu gestionar les cadenes per a cada traducció i no fa que les cadenes de totes les traduccions siguin coherents.
Per als formats monolingües, les cadenes es gestionen només en l’idioma d’origen i s’afegeixen o s’eliminen automàticament a les traduccions. Les cadenes apareixen als fitxers de traducció un cop traduïdes.
Suggeriment
És possible que vulgueu activar Edita el fitxer base juntament amb Gestiona les cadenes per als formats monolingües.
Estil del codi de llengua¶
Personalitzeu el codi de llengua utilitzat per a generar el nom de fitxer de les traduccions creades al Weblate.
Nota
Weblate reconeix qualsevol dels codis d’idioma quan analitza fitxers de traducció, la configuració seguint només influeix en com es creen els fitxers nous.
- Per defecte, basat en el format del fitxer
Depenent del format del fitxer, per a la majoria d’ells s’utilitza POSIX.
- Estil POSIX, fent servir un guió baix com a separador
Normalment utilitzat per gettext i eines relacionades, produeix codis de llenguatge com
pt_BR.- Estil POSIX, fent servir un guió baix com a separador, en minúscules
Normalment utilitzat per gettext i eines relacionades, produeix codis de llenguatge com
pt_BR.- Estil POSIX, fent servir un guió baix com a separador, incloent-hi el codi de país
Codi d’idioma d’estil POSIX inclòs el codi del país encara que no sigui necessari (per exemple,
cs_CZ).- Estil POSIX, fent servir un guió baix com a separador, incloent-hi el codi de país, en minúscules
Codi d’idioma d’estil POSIX inclòs el codi del país encara que no sigui necessari (en minúscules) (per exemple,
cs_cz).- Estil BCP, fent servir un guió com a separador
S’utilitza habitualment en plataformes web, produeix codis d’idioma com
pt-BR.- Estil BCP, fent servir un guió com a separador, incloent-hi el codi de país
Codi d’idioma d’estil BCP inclòs el codi del país fins i tot quan no sigui necessari (per exemple,
cs-CZ).- Estil BCP, fent servir un guió com a separador, codis de llengua antics
Utilitza codis heretats per a la notació d’estil xinès i BCP.
- Estil BCP, fent servir un guió com a separador, en minúscules
Notació d’estil BCP, tot en minúscules (per exemple,
cs-cz).- Estil de metadades de l’App Store d’Apple
Estil adequat per penjar metadades a l’App Store d’Apple.
- Estil de metadades de Google Play
Estil adequat per penjar metadades a Google Play Store.
- Estil d’Android
Només s’utilitza a les aplicacions d’Android, produeix codis d’idioma com
pt-rBR.- Estil Linux
Les configuracions regionals, tal com fa servir Linux, utilitzen codis heretats per a la notació d’estil xinès i POSIX.
- Estil Linux, en minúscules
Les configuracions regionals, tal com fa servir Linux, utilitzen codis heretats per a la notació d’estil xinès i POSIX. Minúscules.
Estil de fusió¶
Podeu configurar com es gestionen les actualitzacions del dipòsit amunt. La implementació real depèn de VCS, vegeu Integració del control de versions.
- Rebase
Rebases Weblate es compromet a la part superior del repositori amunt a l’actualització. Això proporciona un historial net sense confirmacions de combinació addicionals.
El canvi de base pot causar problemes en cas de combinacions complicades, així que considereu acuradament si voleu activar-les o no.
You might need to turn on force pushing in Version control parameters, especially when pushing to a different branch.
- Fusiona
Els canvis del repositori amunt es fusionen a Weblate un. Aquesta configuració utilitza l’avançament ràpid quan és possible. Aquesta és la manera més segura, però pot produir moltes confirmacions de combinació.
- Fusiona sense avanç ràpid
Els canvis del repositori aigües amunt es fusionen a Weblate one amb una confirmació de combinació cada vegada (fins i tot quan seria possible un avançament ràpid). Cada canvi de Weblate apareixerà com una confirmació de combinació al repositori de Weblate.
El valor predeterminat es pot canviar mitjançant DEFAULT_MERGE_STYLE.
Commit, add, delete, merge, add-on, and merge request messages¶
Missatge que s’utilitza en fer una traducció, vegeu Marcatge de plantilla.
The default value can be changed by DEFAULT_ADD_MESSAGE,
DEFAULT_ADDON_MESSAGE, DEFAULT_COMMIT_MESSAGE,
DEFAULT_DELETE_MESSAGE, DEFAULT_MERGE_MESSAGE,
DEFAULT_PULL_MESSAGE.
Els valors predeterminats integrats segueixen els compromisos convencionals i inclouen enllaços Weblate quan estiguin disponibles. Utilitzeu Restaura el lloc predeterminat al costat d’un editor de missatges per restaurar la instal·lació per defecte actual d’aquest missatge; per als valors heretats, això també desactiva l’herència per a aquest missatge.
Vegeu també
Puja en fer una comissió¶
Si els canvis compromesos s’han d’enviar automàticament al repositori amunt. Quan està activat, el push s’inicia un cop Weblate confirma els canvis al seu dipòsit subjacent (vegeu La mandrosa es compromet). Per habilitar realment l’empensió El repositori push URL també s’ha de configurar.
Per als dipòsits enllaçats que utilitzen URL interns del lloc web, aquesta configuració està controlada pel component enllaçat que és propietari del dipòsit. Els components secundaris enllaçats utilitzen el valor d’aquest component.
Push on update¶
Afegit a la versió 2026.10.
Whether Weblate pushes after updating the repository from upstream, even when the update did not commit any translations. This applies only when Puja en fer una comissió is enabled.
Turn this off to avoid pushes, and the CI runs they trigger, caused only by upstream changes. This is useful when Weblate’s pull requests are squash-merged, so its commits never appear upstream. Translations committed during the update are still pushed.
Commits made by the update, such as merge commits with the
Estil de fusió set to merge, are then pushed with the next
translation commit. On quiet projects they can accumulate and trigger the
alert about unpushed changes, see REPOSITORY_ALERT_THRESHOLD.
Using rebase avoids most of them.
Per als dipòsits enllaçats que utilitzen URL interns del lloc web, aquesta configuració està controlada pel component enllaçat que és propietari del dipòsit. Els components secundaris enllaçats utilitzen el valor d’aquest component.
Antiguitat dels canvis a publicar¶
Estableix l’antiguitat (en hores) que han de tenir els canvis abans de ser comesats per una tasca en segon pla o per l’ordre de gestió commit_pending. Tots els canvis en un component es comprometen quan hi hagi almenys un canvi anterior a aquest període.
Per als dipòsits enllaçats que utilitzen URL interns del lloc web, aquesta configuració està controlada pel component enllaçat que és propietari del dipòsit. Els components secundaris enllaçats utilitzen el valor d’aquest component.
El valor predeterminat es pot canviar mitjançant COMMIT_PENDING_HOURS.
Suggeriment
Hi ha altres situacions en què es poden confirmar canvis pendents, vegeu La mandrosa es compromet.
Bloca en cas d’error¶
Bloqueja el component (i els components enllaçats, vegeu URL interns del lloc web) a la primera inserció o fusió fallida al seu repositori aigües amunt, o extreure’n. Això evita afegir altres conflictes, que s’haurien de resoldre manualment.
El component es desbloquejarà automàticament quan no quedin errors de repositori.
Per als dipòsits enllaçats que utilitzen URL interns del lloc web, aquesta configuració està controlada pel component enllaçat que és propietari del dipòsit. Els components secundaris enllaçats utilitzen el valor d’aquest component.
Llengua d’origen¶
Llenguatge utilitzat per a les cadenes d’origen. Canvieu-ho si esteu traduint d’una altra cosa que l’anglès.
Suggeriment
En cas que estigueu traduint fitxers bilingües de l’anglès, però també voleu poder fer correccions a la traducció a l’anglès, trieu Anglès (Desenvolupador) com a idioma d’origen per evitar conflictes entre el nom de l’idioma d’origen i la traducció existent.
Per a traduccions monolingües, podeu utilitzar la traducció intermèdia en aquest cas, vegeu Fitxer de llengua intermèdia.
Filtre de llengua¶
Regular expression used to filter the translation when scanning for file mask. It can be used to limit the list of languages managed by Weblate.
The filter also applies when creating a new translation file. In this case, it checks the language code generated according to Estil del codi de llengua.
Nota
Heu d’enumerar els codis d’idioma tal com apareixen al nom del fitxer.
Alguns exemples de filtratge:
Descripció del filtre |
Expressió regular |
|---|---|
Només idiomes seleccionats |
|
Exclou idiomes |
|
Filtra només codis de dues lletres |
|
Exclou fitxers que no siguin d’idioma |
|
Inclou tots els fitxers (per defecte) |
|
Vegeu també
Filtre de claus¶
Afegit a la versió 5.8.
Una expressió regular que s’utilitza per filtrar unitats per les seves claus. Mostra només aquelles unitats les claus de les quals coincideixen amb l’expressió regular que es va establir com a valor d’aquest camp.
Alguns exemples de filtratge:
Descripció del filtre |
Expressió regular |
|---|---|
Selected keys only |
|
Exclou els registres de canvis de la botiga d’aplicacions |
|
Filter prefixed strings |
|
Nota
This filter is only available for components with monolingual file formats.
Expressió regular de les variants¶
Expressió regular utilitzada per determinar les variants d’una cadena, vegeu Variants de corda.
Nota
La majoria dels camps poden ser editats pels propietaris o administradors del projecte, a la interfície de Weblate.
Llengua secundària¶
Afegit a la versió 5.11.
Llengua addicional que es mostra juntament amb la llengua d’origen mentre es tradueix.
Opcionalment, també es pot utilitzar com a font per a la traducció automàtica.
Nota
This setting can be inherited from the project.
Prioritat¶
Els components amb més prioritat es mostren abans als traductors.
Canviat a la versió 4.15: Això ara també afecta l’ordre dels termes del glossari coincidents.
Accés restringit¶
Nota
On Hosted Weblate, this requires a billing plan which permits private projects.
Per defecte, el component és visible per a qualsevol persona que tingui accés al projecte, encara que la persona no pugui realitzar cap canvi al component. Això fa que sigui més fàcil mantenir la coherència de la traducció dins del projecte.
Restricting access at a component or component-list level requires an explicit grant for ordinary users, regardless of their project-level permissions. Grant access by creating a user group and adding users to it, or by using the default custom or private access control groups.
El valor predeterminat es pot canviar a DEFAULT_RESTRICTED_COMPONENT.
Changing this setting in a browser session requires recent credential verification, see Autenticació de doble factor.
Restricted access controls visibility of component pages, translations, API reads, and translation memory for users without component access or Edit project settings permission. Project administrators with that permission can open and manage every component in their project, including restricted ones. Editing strings, reviewing translations, downloading files, and other actions still require their respective permissions from a team scoped to the component or a component list containing it. Project-scoped action permissions do not apply to restricted components, including for project administrators.
Administrative features can access restricted components within their documented scope. Project backups contain all project components. Project and category add-ons process restricted components in their configured scope. Component add-ons can also use cross-component inputs documented by the add-on. Grant management permissions only to users trusted with these effects. See Scope of teams and Complements.
Suggeriment
Project administrators with Edit project settings permission retain access after restricting a component. Other users need an explicit component grant to keep direct access.
Restricted components do not contribute new entries to Memòria de traducció compartida. Project and workspace translation memory entries attributed to an existing restricted component follow the component restriction. Unattributed legacy entries follow the access rules of their translation memory scope. On Hosted Weblate, shared translation memory and restricted components can not be enabled in the same project.
Utilitza com a glossari¶
Afegit a la versió 4.5.
Allows using this component as a glossary. Use when you want to manage terminology separately from normal translations.
Els glossaris són els millors per a:
Garantir l’ús coherent dels termes (p. ex., etiquetes d’interfície d’usuari, noms de productes).
Sharing preferred translations across multiple components or projects.
Donar suport als traductors amb definicions i context.
Nota
Els glossaris no són per a traduccions habituals, sinó només per gestionar termes.
Weblate automatically adds missing glossary languages for languages used in the project. See Language files and synchronization for details.
You can configure how it will be listed using Color del glossari.
El glossari serà accessible en tots els projectes definits per Comparteix en projectes.
A restricted component is not used as a glossary in its own project or in projects where it is shared. Weblate displays a diagnostic when both settings are enabled so that you can either remove restricted access or disable Use as a glossary without changing the component automatically.
Es recomana habilitar Gestiona les cadenes als glossaris per permetre afegir-hi paraules noves.
Vegeu també
Color del glossari¶
Color utilitzat quan es mostren termes d’aquest glossari. Útil per distingir glossaris quan s’utilitzen més d’ells.
Vegeu també
Categoria¶
Les categories estan allà per donar estructura als components d’un projecte. Podeu niar-los per aconseguir una estructura més complexa.
Category settings¶
Les categories poden substituir la mateixa configuració heretada que els projectes i components, com ara la llicència de traducció, l’acord de col·laborador, l’addició de noves traduccions, l’idioma secundari, les marques de traducció i els missatges de confirmació.
Les categories niuades hereten de la seva categoria principal de manera predeterminada. Les categories de primer nivell hereten del projecte. Els components d’una categoria hereten d’aquesta categoria per defecte.
Marcatge de plantilla¶
Weblate utilitza un llenguatge de marques senzill en diversos llocs on es necessita la representació de text. Es basa en The Django template language, de manera que pot ser bastant potent.
Actualment s’utilitza en:
Comprometeu el format del missatge, vegeu Configuració dels components
Template source is limited to 64 KiB of UTF-8 text. A render may execute at most 10,000 loop iterations in total, including nested loops, and produce at most 1 MiB of UTF-8 output. Expanding filters and intermediate values are also bounded. These limits apply both when validating settings and when rendering saved templates. Exceeding a limit fails the render without returning partial output or replacing a generated file.
Template parsing is limited to 1,024 tokens, 2,048 bytes per token, 32 levels of nesting, and 64 terms per condition. Parsing work is limited to 8,388,608 units, calculated as the sum of the squared UTF-8 byte lengths of token contents. Rendering also limits evaluated operations to 8,192, filter applications to 1,024, and cumulative processing work to an 8 MiB budget. These budgets count repeated operations even inside conditions that produce no output. A five-second deadline provides an additional guard. Exceeding any limit fails the render. Errors identify the failed limit or unsupported operation and the relevant filter or tag when available. Multiline parsing and evaluation errors also include the source line number.
Contexts support scalar substitutions, dictionary lookups such as
{{ stats.translated }}, and list or string indexing such as
{{ translations.0.language_code }}. Dictionaries expose read-only items,
keys, and values views; stored keys with these names take precedence.
General attribute access and method calls are not supported.
Supported filters are:
Strings and paths:
parentdir,dirname,stripext,lower,upper,capfirst,title,urlencode,iriencode,cut,addslashes,escape,force_escape,escapejs,linenumbers,slugify,truncatechars,truncatewords,wordcount,wordwrap,linebreaks,linebreaksbr,safe, andphone2numeric.Sequences:
slice,length,first,last,join,make_list,random,safeseq, andescapeseq. Joining requires strings; sequence escaping requires scalar elements.Values and numbers:
default,default_if_none,yesno,add,get_digit,divisibleby,filesizeformat, andpluralize.Formatting:
center,ljust,rjust,floatformat, andstringformat. Padding checks its width before allocation. Numeric conversions are bounded; formatting precision is limited to 1,000 places.stringformataccepts a single conversion with literal flags, width, and precision, without mapping keys or dynamic widths.Dates:
date,time,timesince, andtimeuntil, with bounded format strings and the current time zone.Serialization:
jsonproduces JSON text, andpythonproduces Python literals using JSON-compatible value conversions. Serialized results are subject to the intermediate-value and output limits.
The default, default_if_none, and yesno filters also accept containers.
Defaults can select containers for subsequent iteration, filtering, or serialization;
containers cannot be rendered directly as text.
Django string filters convert bounded scalar data to strings; custom filename filters require strings. Unicode normalization counts combining-character sequences against the work budget. Allocation and work guards can reject an operation even when its final result would fit the output limit.
Supported tags are if / elif / else, for / empty, and
replace, including replacement assignment with as. Conditions support
truth tests, and, or, not, scalar comparisons, and identity checks
against None, True, or False. Membership tests and container comparisons
are not supported. Loops support lists, strings, dictionaries, dictionary views, unpacking,
reversed, and Django’s forloop metadata. This covers the default
pull-request message, including linked components. Conditions cannot suppress
resource-limit errors.
The following Django filters are not supported: urlize, urlizetrunc,
striptags, truncatechars_html, truncatewords_html, dictsort,
dictsortreversed, unordered_list, pprint, and json_script.
Unsupported filters fail validation even in untaken branches.
Before evaluation, the complete context is validated and copied as plain data, including unused values. Context data is limited to an 8 MiB budget and 32 levels of nesting. Application objects must be expanded into supported data before rendering. Add-on commit messages use the English add-on name regardless of the active interface language. Rendered templates return plain text; HTML sinks must escape it.
The following variables are available in the component templates:
{{ language_code }}Codi de llengua
{{ language_name }}Nom de la llengua
{{ component_name }}Nom del component
{{ component_full_name }}Component name prefixed with the project and all parent categories, separated by
/. Built-in message defaults use this value; existing saved templates are unchanged.{{ component_linked_children }}Linked repository components. Each entry provides
full_name(including project and categories),project_name,name, andurl.{{ component_slug }}Component llimac
{{ project_name }}Nom del projecte
{{ project_slug }}Llimac del projecte
{{ url }}Translation URL
{{ filename }}Nom de fitxer de la traducció
{{ stats }}Estadístiques de traducció, això té més atributs, exemples a continuació.
{{ stats.all }}Recompte total de cadenes
{{ stats.fuzzy }}Recompte de cadenes que cal revisar
{{ stats.fuzzy_percent }}Percentatge de cadenes que necessiten revisió
{{ stats.translated }}Les cadenes traduïdes compten
{{ stats.translated_percent }}Per cent de cadenes traduïdes
{{ stats.allchecks }}Nombre de cadenes amb comprovacions fallides
{{ stats.allchecks_percent }}Percentatge de cadenes amb comprovacions fallides
{{ author }}Autor de la confirmació actual, disponible només a l’àmbit de la confirmació.
{{ addon_name }}Nom del complement executat actualment, disponible només al missatge de confirmació del complement.
The Statistics generator additionally
supports a collection of languages and their statistics in component mode.
Use the json or python filter to serialize template values into JSON or
Python literals, including the necessary quoting and escaping.
Les variables següents estan disponibles al navegador del dipòsit o a les plantilles de l’editor:
{{branch}}branca actual
{{line}}línia al fitxer
{{filename}}nom de fitxer, també podeu eliminar les parts principals utilitzant el filtre
parentdir, per exemple{{filename|parentdir}}
Suggeriment
En alguns llocs poden estar disponibles variables addicionals, vegeu Descobriment de components.
Podeu combinar-los amb filtres:
{{ component|title }}
Podeu utilitzar les condicions:
{% if stats.translated_percent > 80 %}Well translated!{% endif %}
Hi ha una etiqueta addicional disponible per substituir caràcters:
{% replace component "-" " " %}
Podeu combinar-lo amb filtres:
{% replace component|capfirst "-" " " %}
També hi ha filtres addicionals per manipular amb noms de fitxer:
Directory of a file: {{ filename|dirname }}
File without extension: {{ filename|stripext }}
File in parent dir: {{ filename|parentdir }}
It can be used multiple times: {{ filename|parentdir|parentdir }}
… i altres funcions de plantilla de Django.
Velocitat d’importació¶
Obtenir el repositori VCS i importar traduccions a Weblate pot ser un procés llarg, depenent de la mida de les traduccions. Aquí teniu alguns consells:
Optimitzar la configuració¶
The default configuration is useful for testing and debugging Weblate, while for a production setup, you should do some adjustments. Many of them have quite a big impact on performance. Please check Configuració de producció for more details, especially:
Configureu Celery per executar tasques de fons (vegeu Tasques de fons amb api)
Comproveu els límits de recursos¶
Si esteu important traduccions o repositoris grans, és possible que us afectin les limitacions de recursos del vostre servidor.
Comproveu la quantitat de memòria lliure, tenir fitxers de traducció guardats a la memòria cau pel sistema operatiu millorarà molt el rendiment.
Les operacions del disc poden ser un coll d’ampolla si hi ha moltes cadenes per processar: el disc és empès tant per Weblate com per la base de dades.
Additional CPU cores might help improve performance of background tasks (see Tasques de fons amb api).
Desactiva els controls innecessaris¶
Alguns controls de qualitat poden ser bastant cars i, si no són necessaris, us poden estalviar temps durant la importació si s’omet. Vegeu CHECK_LIST per obtenir informació sobre la configuració.
Creació automàtica de components¶
En cas que el vostre projecte tingui dotzenes de fitxers de traducció (p. ex., per a diferents dominis de gettext o parts d’aplicacions d’Android), és possible que vulgueu importar-los automàticament. Això es pot aconseguir des de la línia d’ordres utilitzant import_project o import_json, o bé instal·lant el complement Descobriment de components.
Per utilitzar el complement, primer heu de crear un component per a un fitxer de traducció (trieu el que tingui menys probabilitats de canviar el nom o eliminar-lo en el futur) i instal·leu el complement en aquest component.
Per a les ordres de gestió, heu de crear un projecte que contindrà tots els components i després executar import_project o import_json.
Vegeu també