summaryrefslogtreecommitdiffstats
path: root/data/README.osk-layouts
diff options
context:
space:
mode:
Diffstat (limited to 'data/README.osk-layouts')
-rw-r--r--data/README.osk-layouts33
1 files changed, 33 insertions, 0 deletions
diff --git a/data/README.osk-layouts b/data/README.osk-layouts
new file mode 100644
index 0000000..e9e668f
--- /dev/null
+++ b/data/README.osk-layouts
@@ -0,0 +1,33 @@
+Gnome-shell OSK layouts are extracted from CLDR layout definitions:
+https://www.unicode.org/cldr/charts/latest/keyboards/layouts/index.html
+
+Updating these involves several steps:
+
+1) Downloading and unzipping the tarball found at:
+ http://www.unicode.org/Public/cldr/latest/keyboards.zip
+
+ This file contains XML files describing the keyboard layouts.
+
+2) Cloning the cldr2json script at:
+ git://repo.or.cz/cldr2json.git
+
+ It will be used to convert the XML files into JSON that can be
+ directly consumed by gnome-shell.
+
+3) Running the script to produce the files:
+ ./cldr2json <input-directory> <output-directory>
+
+ We shall usually use the "android" folder, since that's most
+ complete, and similar to our UI and target sizes. And the target
+ directory must be data/osk-layouts in this repository.
+
+4) Modify gnome-shell-osk-layouts.gresource.xml to include the files
+
+5) Do git add on the updated/new files, and git commit.
+
+
+Or alternatively:
+
+1) Run update-osk-layouts.sh
+
+2) Do git add and git commit