Home Explore Help
Sign In
Godot
/
godot-docs
mirror of https://github.com/godotengine/godot-docs.git
2
0
Fork 0
Files Issues 0 Wiki
Branch: classref/sync-c2202d3
Branches Tags
godot-docs
/
tutorials
/
assets_pipeline
/
importing_translations.rst

importing_translations.rst 2.0 KB
Permalink History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243444546 
  1. .. _doc_importing_translations:
    2. 

  2. 

  3. Importing translations
    4. 

  4. ======================
    5. 

  5. 

  6. Games and internationalization
    7. 

  7. ------------------------------
    8. 

  8. 

  9. The gaming community isn't monolingual or monocultural. It's made up of
    10. 

  10. many different languages and cultures - just like the Godot community!
    11. 

  11. If you want to allow players to experience your game in their language,
    12. 

  12. one of things you'll need to provide is text translations, which Godot
    13. 

  13. supports via internationalized text.
    14. 

  14. 

  15. In regular desktop or mobile applications, internationalized text is
    16. 

  16. usually located in resource files (or .po files for GNU stuff). Games,
    17. 

  17. however, can use several orders of magnitude more text than
    18. 

  18. applications, so they must support efficient methods for dealing with
    19. 

  19. loads of multilingual text.
    20. 

  20. 

  21. There are two approaches to generate multilingual language games and
    22. 

  22. applications. Both are based on a key:value system. The first is to use
    23. 

  23. one of the languages as the key (usually English), the second is to use a
    24. 

  24. specific identifier. The first approach is probably easier for
    25. 

  25. development if a game is released first in English, later in other
    26. 

  26. languages, but a complete nightmare if working with many languages at
    27. 

  27. the same time.
    28. 

  28. 

  29. In general, games use the second approach and a unique ID is used for
    30. 

  30. each string. This allows you to revise the text while it is being
    31. 

  31. translated to other languages. The unique ID can be a number, a string,
    32. 

  32. or a string with a number (it's just a unique string anyway).
    33. 

  33. 

  34. Supported formats
    35. 

  35. -----------------
    36. 

  36. 

  37. To complete the picture and allow efficient support for translations,
    38. 

  38. Godot has a special importer that can read CSV files. Most spreadsheet
    39. 

  39. editors can export to this format, so the only requirement is that the
    40. 

  40. files have a special arrangement. See
    41. 

  41. :ref:`doc_localization_using_spreadsheets` for detailed info on
    42. 

  42. formatting and importing CSVs.
    43. 

  43. 

  44. If you need a more powerful file format, Godot also supports loading
    45. 

  45. translations written in the gettext ``.po`` format. See
    46. 

  46. :ref:`doc_localization_using_gettext` for details.
    47.