weblate/docs/formats/fluent.rst
Gersona 725bd96349
feat(docs): Automatically generate format features docmentation (#18106)
* initial implementation suggestion

* basic supported features snippets generation

* Add API identifiers, read-only strings and common extensions to features table

* generate doc features snippet files

* autogenerated snippets cleanup

* changelog update

* delete one file to test auto-update

* replace SUPPORTS_FUZZY with file format additional_states flag

* docs: Documentation snippets update

* fix include statetement typo

* fix incorrect monolingual attributes

* minor styling change

* docs: Documentation snippets update

* exclude snippets from being treated as standalone documents

* Set YAMLFormat as both mono/bilingual

* docs: Documentation snippets update

* fix duplicate format IDs

* only use backwards quotes for literals

---------

Co-authored-by: gersona <6675010+gersona@users.noreply.github.com>
Co-authored-by: Michal Čihař <michal@weblate.org>
2026-04-01 15:41:20 +00:00

39 lines
1.5 KiB
ReStructuredText

.. _fluent:
Fluent format
-------------
.. versionadded:: 4.8
.. include:: /snippets/format-in-development.rst
Fluent is a monolingual text format that focuses on asymmetric localization: a
simple string in one language can map to a complex multi-variant translation in
another language.
.. seealso::
`Project Fluent website <https://projectfluent.org/>`_
Example file:
.. literalinclude:: ../../weblate/trans/tests/data/cs.ftl
.. include:: /snippets/format-features/fluent-features.rst
Weblate configuration
+++++++++++++++++++++
+-----------------------------------------------------------------------------------+
| Typical Weblate :ref:`component` |
+================================+==================================================+
| File mask |``locales/*/messages.ftl`` |
+--------------------------------+--------------------------------------------------+
| Monolingual base language file |``locales/en/messages.ftl`` |
+--------------------------------+--------------------------------------------------+
| Template for new translations | `Empty` |
+--------------------------------+--------------------------------------------------+
| File format | `Fluent file` |
+--------------------------------+--------------------------------------------------+