abouttreesummaryrefslogcommitdiff
path: root/CONTRIBUTING.md
diff options
context:
space:
mode:
authorJules Aguillon2022-05-29 12:27:46 +0200
committerJules Aguillon2022-05-29 12:27:46 +0200
commit2e81cb5cf717ef68df9bd66d2af1c7f5ccaaa3fe (patch)
tree6349235c0f0e63371a910428be3915fad016eef5 /CONTRIBUTING.md
parent89dfc782a7985053728d54072fb104728796a843 (diff)
downloadunexpected-keyboard-2e81cb5cf717ef68df9bd66d2af1c7f5ccaaa3fe.tar.gz
unexpected-keyboard-2e81cb5cf717ef68df9bd66d2af1c7f5ccaaa3fe.zip
Automatically place localized keys on the layouts
Layouts no longer need to mention every localized keys and dead keys. They are now placed automatically starting from the second row on the bottom-right corner. The "loc " prefix is not removed to still be able to define a more optimal and consistent placement for some extra keys (eg. 'ß' near 's'). Programming layouts no longer need to place every dead keys.
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r--CONTRIBUTING.md9
1 files changed, 4 insertions, 5 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 4a107b1..8a31530 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -83,17 +83,16 @@ make installd
A programming layout must contains every ASCII characters.
The current programming layouts are: QWERTY, Dvorak.
-Ideally, programming layouts should allow to type every Latin-script languages
-by containing every dead-keys. See for example: 0bf7ff5 (Latvian), 573c13f (Swedish).
-It is also possible to add some characters that are hidden in other languages,
-for example 93e84ba (ß), though the space is limited.
-
Layouts are defined in XML, see `res/xml/qwerty.xml`. An entry must be added to
the layout option in `res/values/arrays.xml`, to both `pref_layout_values`
(correspond to the file name) and `pref_layout_entries` (display name).
The layout must also be referenced in `srcs/juloo.keyboard2/Config.java` in
`layoutId_of_string`.
+Keys with a name starting in `loc ` are hidden unless they are configured for
+the user's installed languages in `res/xml/method.xml`. These keys are optional
+and will be added automatically when necessary.
+
Some users cannot easily type the characters close the the edges of the screen
due to a bulky phone case. It is best to avoid placing important characters
there (such as the digits or punctuation).