Language definitions used by Weblate
Find a file
Michal Čihař 0ceaab696c fix ordering
2023-12-04 09:24:19 +01:00
.github chore(deps): update pypa/gh-action-pypi-publish action to v1.8.11 2023-11-29 02:52:41 +00:00
.reuse Use REUSE 3.0 for license data 2023-01-13 09:57:28 +01:00
languages-po chore(deps): update modules/cldr-json digest to 245e32c (#1130) 2023-11-02 14:50:26 +01:00
LICENSES Use REUSE 3.0 for license data 2023-01-13 09:57:28 +01:00
modules chore(deps): update modules/iso-codes digest to 3832457 (#1155) 2023-12-04 09:22:10 +01:00
scripts scripts: Use pre-commit to fomrat files 2023-08-18 07:18:32 +02:00
weblate_language_data fix ordering 2023-12-04 09:24:19 +01:00
.deepsource.toml ci: Update isort configuration to use profile 2023-03-22 10:19:33 +01:00
.gitignore Add missing pot file 2020-09-29 12:05:15 +02:00
.gitmodules Update to CLDR 41 2022-07-18 11:28:16 +02:00
.markdownlint.yml Sync with WeblateOrg/meta 2023-01-11 09:42:22 +01:00
.pre-commit-config.yaml chore(deps): update pre-commit hook astral-sh/ruff-pre-commit to v0.1.6 2023-11-17 20:03:11 +00:00
.weblate Add Weblate configuration 2020-09-29 12:46:36 +02:00
.yamllint.yml Sync with WeblateOrg/meta 2023-01-10 11:26:18 +01:00
aliases.csv Update Arabic (Levantine) definition 2023-10-25 13:15:19 +02:00
cldr.csv chore: Updates from submodules 2022-11-02 09:56:39 +01:00
default_countries.csv Update default countries 2023-04-18 13:47:03 +02:00
extraplurals.csv lang: Fix extra plurals definition 2022-07-14 16:52:11 +02:00
gettext.csv chore: Updates from submodules 2022-09-02 08:04:53 +02:00
l10n-guide.csv chore: Add header to the CSV files 2022-07-14 15:00:16 +02:00
languages.csv fix ordering 2023-12-04 09:24:19 +01:00
LICENSE Sync with WeblateOrg/meta 2023-01-07 13:15:15 +01:00
Makefile Use REUSE 3.0 for license data 2023-01-13 09:57:28 +01:00
MANIFEST.in Make Django dependency optional 2020-09-30 08:35:01 +02:00
PLURALS_DIFF.md Update Arabic (Levantine) definition 2023-10-25 13:15:19 +02:00
population.csv chore(deps): update modules/cldr-json digest to 11f0bac (#1096) 2023-10-02 09:20:04 +02:00
pyproject.toml deps: Bump Python version 2023-10-03 07:35:09 +02:00
README.rst Sync with WeblateOrg/meta 2023-04-17 13:29:21 +02:00
requirements-dev.txt chore(deps): update dependency black to v23.11.0 2023-11-08 08:00:33 +00:00
requirements-lint.txt chore(deps): update dependency pre-commit to v3.5.0 2023-10-13 18:54:25 +00:00
requirements-test.txt deps: Cleanup test/lint deps 2023-01-19 14:49:07 +01:00
requirements.txt chore(deps): update dependency translate-toolkit to v3.11.1 2023-11-15 18:56:25 +00:00
SECURITY.md Sync with WeblateOrg/meta 2023-07-14 14:58:31 +02:00
setup.cfg Version bump 2023-11-02 14:52:18 +01:00
setup.py ci: enable ruff in pre-commit 2023-04-04 15:25:39 +02:00
translate.csv chore: Add header to the CSV files 2022-07-14 15:00:16 +02:00

.. image:: https://s.weblate.org/cdn/Logo-Darktext-borders.png
   :alt: Weblate
   :target: https://weblate.org/
   :height: 80px

**Weblate is libre software web-based continuous localization system,
used by over 2500 libre projects and companies in more than 165 countries.**

Language definitions used by `Weblate`_ and free to use by others.

.. image:: https://img.shields.io/badge/website-weblate.org-blue.svg
    :alt: Website
    :target: https://weblate.org/

.. image:: https://hosted.weblate.org/widgets/weblate/-/svg-badge.svg
    :alt: Translation status
    :target: https://hosted.weblate.org/engage/weblate/?utm_source=widget

.. image:: https://bestpractices.coreinfrastructure.org/projects/552/badge
    :alt: CII Best Practices
    :target: https://bestpractices.coreinfrastructure.org/projects/552

.. image:: https://img.shields.io/pypi/v/weblate-language-data.svg
    :target: https://pypi.org/project/weblate-language-data/
    :alt: PyPI package

.. image:: https://readthedocs.org/projects/weblate/badge/
    :alt: Documentation
    :target: https://docs.weblate.org/

Usage
=====

The Python module can be installed from the PyPI:

.. code-block:: sh

    pip install weblate-language-data

It contains several modules containing language definitions and Gettext
translations for them (in a way that they would be discovered by Django when
used as an Django application).

CSV Files
=========

The repository also contains CSV files which are used to generate the Python
code and can be used independently.

* Semicolon delimited files
* Contains language code, name, number of plurals and plural equation

languages.csv
-------------

* Combined from several sources, plurals should match CLDR when available
* Used by `Weblate`_ for language definitions
* Manually edited

aliases.csv
-----------

* Language aliases to map non standard or legacy locales to ones in `languages.csv`
* Manually edited

default_countries.csv
---------------------

* List of default country specific locales
* Used to map them to ones in `languages.csv`
* Manually edited

extraplurals.csv
----------------

* Additional plural variants for some languages
* Usually used in Gettext
* Manually edited

cldr.csv
--------

* Based purely on the CLDR data
* Generated using export-cldr from https://github.com/mlocati/cldr-to-gettext-plural-rules

gettext.csv
-----------

* Based on Gettext defaults
* Generated using export-gettext

translate.csv
-------------

* Extracted from `translate-toolkit`_
* Generated using export-translate

l10n-guide.csv
--------------

* Extracted from the `l10n guide`_
* Generated using export-l10n-guide

languages-po
------------

* Directory containing PO files with langauge names translations
* Extracted from CLDR data

.. _Weblate: https://weblate.org/
.. _translate-toolkit: https://toolkit.translatehouse.org/
.. _l10n guide: https://docs.translatehouse.org/projects/localization-guide/en/latest/

Contributing
============

Contributions are welcome! See `documentation <https://docs.weblate.org/en/latest/contributing/modules.html>`__ for more information.