mirror of
https://gh.wpcy.net/https://github.com/WeblateOrg/weblate.git
synced 2026-05-29 03:44:04 +08:00
66 lines
2.6 KiB
ReStructuredText
Vendored
66 lines
2.6 KiB
ReStructuredText
Vendored
Managing translations
|
|
=====================
|
|
|
|
.. _adding-translation:
|
|
|
|
Adding new translations
|
|
-----------------------
|
|
|
|
New strings can be made available for translation when they appear in the base file,
|
|
called :guilabel:`Template for new translations` (see :ref:`component`).
|
|
If your file format doesn't require such a file, as is the case with most monolingual
|
|
translation flows, you can start with blank files).
|
|
|
|
New languages can be added right away when requested by a user in Weblate, or a
|
|
notification will be sent to project admins for approval and manual addition.
|
|
This can be done using :guilabel:`Start new translation` in :ref:`component`.
|
|
|
|
.. note::
|
|
|
|
Project admins can always start translation within Weblate directly.
|
|
|
|
Language files added manually to the VCS are added to the component when Weblate updates
|
|
the repository. About repository update settings, see :ref:`update-vcs`.
|
|
|
|
.. _variants:
|
|
|
|
String variants
|
|
---------------
|
|
|
|
Variants are useful to group several strings together so that translators can
|
|
see all variants of the string at one place. You can define regular expression
|
|
to group the strings in the :ref:`component`:
|
|
|
|
.. image:: /images/variants-settings.png
|
|
|
|
In case the :guilabel:`Key` matches the expression, the matching part is
|
|
removed to generate root key of the variant. All strings with same root key are
|
|
then part of single variants group, including the translation exactly matching
|
|
the root key and not matching the expression.
|
|
|
|
The following table lists some usage examples:
|
|
|
|
+---------------------------+-------------------------------+-----------------------------------------------+
|
|
| Use case | Regular expression variant | Matched translation keys |
|
|
+===========================+===============================+===============================================+
|
|
| Suffix identification | ``(Short|Min)$`` | ``monthShort``, ``monthMin``, ``month`` |
|
|
+---------------------------+-------------------------------+-----------------------------------------------+
|
|
| Inline identification | ``#[SML]`` | ``dial#S.key``, ``dial#M.key``, ``dial.key`` |
|
|
+---------------------------+-------------------------------+-----------------------------------------------+
|
|
|
|
The variant is later grouped when translating:
|
|
|
|
.. image:: /images/variants-translate.png
|
|
|
|
.. _labels:
|
|
|
|
String labels
|
|
-------------
|
|
|
|
Split component translation strings into categories by text and colour in the project configuration.
|
|
|
|
.. image:: /images/labels.png
|
|
|
|
.. hint::
|
|
|
|
Labels can be assigned to units in :ref:`additional` by bulk editing, or using the :ref:`addon-weblate.flags.bulk` addon.
|
