aboutsummaryrefslogtreecommitdiff
path: root/game/localisation/README.md
diff options
context:
space:
mode:
author Hop311 <Hop3114@gmail.com>2023-03-30 15:04:58 +0200
committer GitHub <noreply@github.com>2023-03-30 15:04:58 +0200
commit3384b21177a160f7192a2e4877eea3b29880bf4e (patch)
treedb9c9a37a187e15ef494a700f8afe5d65c3a8b78 /game/localisation/README.md
parent8f213935bdea2400b6809f9d5db45dde3416dedc (diff)
Added Localisation (#77)
* Added Localisation * Removed `.gdignore`s. * Localisation dir path and Locale name cleanup * Incomplete entry warnings + README
Diffstat (limited to 'game/localisation/README.md')
-rw-r--r--game/localisation/README.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/game/localisation/README.md b/game/localisation/README.md
new file mode 100644
index 0000000..401517f
--- /dev/null
+++ b/game/localisation/README.md
@@ -0,0 +1,16 @@
+# Localisation
+
+This folder contains localisations for in-game text. Each sub-folder must be named with a standard locale code, e.g. `en_GB`, to which the localisations contained within it shall apply (Godot's supported locale codes are listed [here](https://docs.godotengine.org/en/latest/tutorials/i18n/locales.html)). These folders contain `.csv` files where each line is interpreted as a key-value pair. Empty lines allow for spacing out/separating sections, and any further entries beyond the first two on a line are ignored, which can be used to add comments at the end of lines. Lines with their key and value empty are skipped, allowing free-standing comments with no preceeding localisation, but lines with only one of their key or value empty, while not loaded as a localisation, will still result in warnings about incomplete entries.
+
+```
+,, Example Localisation Comment
+EXAMPLE_KEY,Example Value
+ANOTHER_EXAMPLE,Another Example, This is a comment
+
+,, Entries with empty keys/values are skipped but can still produce warnings
+THIS,, produces a warning!
+,As, does this!
+,, This doesn't!
+BUT_THIS_DOES
+AND_THIS,
+```