From c8c7e1546f425c1c1d32cb90c66746b002cda6c4 Mon Sep 17 00:00:00 2001
From: sspanak <doftor.livain@gmail.com>
Date: Mon, 21 Oct 2024 16:56:30 +0300
Subject: [PATCH] help translations

---
 app/build.gradle                              |   8 +-
 app/constants.gradle                          |   4 +-
 app/help-tools.gradle                         |  10 +-
 .../sspanak/tt9/preferences/HelpActivity.java |  18 +-
 .../screens/main/MainSettingsScreen.java      |  13 +
 .../sspanak/tt9/util/SystemSettings.java      |   2 +
 app/src/main/res/xml/prefs.xml                |   1 -
 docs/help/help.en.md                          | 335 +++++++++++++++++
 docs/help/help.es.md                          | 332 +++++++++++++++++
 docs/help/help.ru.md                          | 332 +++++++++++++++++
 docs/user-manual.md                           | 336 +-----------------
 11 files changed, 1044 insertions(+), 347 deletions(-)
 create mode 100644 docs/help/help.en.md
 create mode 100644 docs/help/help.es.md
 create mode 100644 docs/help/help.ru.md
 mode change 100644 => 120000 docs/user-manual.md

diff --git a/app/build.gradle b/app/build.gradle
index 0a85ebd5..7eafc4e9 100644
--- a/app/build.gradle
+++ b/app/build.gradle
@@ -32,11 +32,11 @@ tasks.register('copyDictionaries', Copy) {
 }
 
 tasks.register('convertHelp') {
-	inputs.file HELP_MARKDOWN
-	outputs.file HELP_HTML
+	inputs.dir HELP_MARKDOWN_DIR
+	outputs.dir HELP_HTML_DIR
 
 	doLast {
-		markdownToHTML(HELP_MARKDOWN, HELP_HTML)
+		convertHelpDocs(HELP_MARKDOWN_DIR, HELP_HTML_DIR)
 	}
 }
 
@@ -58,7 +58,7 @@ tasks.register('updateManifest') {
 clean {
 	delete LANGUAGES_OUTPUT_DIR
 	delete DICTIONARIES_OUTPUT_DIR
-	delete HELP_HTML
+	delete HELP_HTML_DIR
 }
 
 // using the exported Closures directly causes weird values, hence the extra wrappers here
diff --git a/app/constants.gradle b/app/constants.gradle
index a72b130c..4c96c664 100644
--- a/app/constants.gradle
+++ b/app/constants.gradle
@@ -10,8 +10,8 @@ def ROOT_DIR = "${project.rootDir}/app"
 def MAIN_ASSETS_DIR = "${ROOT_DIR}/src/main/assets"
 def FULL_VERSION_ASSETS_DIR = "${ROOT_DIR}/src/full/assets"
 
-ext.HELP_MARKDOWN = "${project.rootDir}/docs/user-manual.md"
-ext.HELP_HTML = "${MAIN_ASSETS_DIR}/help.html"
+ext.HELP_MARKDOWN_DIR = "${project.rootDir}/docs/help"
+ext.HELP_HTML_DIR = "${MAIN_ASSETS_DIR}/help"
 
 ext.LANGUAGES_INPUT_DIR = "${ROOT_DIR}/${LANGUAGES_DIR_NAME}"
 ext.DEFINITIONS_INPUT_DIR = "${LANGUAGES_INPUT_DIR}/${DEFINITIONS_DIR_NAME}"
diff --git a/app/help-tools.gradle b/app/help-tools.gradle
index 0c147aa0..b8d343e7 100644
--- a/app/help-tools.gradle
+++ b/app/help-tools.gradle
@@ -1,4 +1,10 @@
-ext.markdownToHTML = { markdownPath, htmlPath ->
+ext.convertHelpDocs = {markdownDir, htmlDir ->
+    fileTree(markdownDir).getFiles().parallelStream().forEach { File markdownPath ->
+        markdownToHtml(markdownPath.path, "${htmlDir}/${markdownPath.name.replaceAll("\\.md\$", ".html")}")
+    }
+}
+
+static markdownToHtml(markdownPath, htmlPath) {
     def text = new File(markdownPath).text
 
     text = convertHeaders(text)
@@ -63,7 +69,7 @@ static convertHeaders(markdown) {
             }
 
             def header = line.replaceAll("^#+", "").trim()
-            def anchor = header.toLowerCase().replaceAll("[^a-z0-9]+", "-").replaceAll("[\\-]+\$", "")
+            def anchor = header.toLowerCase().replaceAll("[^\\d\\p{L}]+", "-").replaceAll("[\\-]+\$", "")
 
             return "<h${headerNumber} id=\"${anchor}\">${header}</h${headerNumber}>"
         } else {
diff --git a/app/src/main/java/io/github/sspanak/tt9/preferences/HelpActivity.java b/app/src/main/java/io/github/sspanak/tt9/preferences/HelpActivity.java
index c98031b2..b7eb51a9 100644
--- a/app/src/main/java/io/github/sspanak/tt9/preferences/HelpActivity.java
+++ b/app/src/main/java/io/github/sspanak/tt9/preferences/HelpActivity.java
@@ -3,12 +3,14 @@ package io.github.sspanak.tt9.preferences;
 import android.content.res.AssetManager;
 
 import java.io.BufferedReader;
+import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
 import java.nio.charset.StandardCharsets;
 
 import io.github.sspanak.tt9.ui.WebViewActivity;
 import io.github.sspanak.tt9.util.Logger;
+import io.github.sspanak.tt9.util.SystemSettings;
 
 public class HelpActivity extends WebViewActivity {
 	@Override
@@ -18,9 +20,8 @@ public class HelpActivity extends WebViewActivity {
 
 	@Override
 	protected String getText() {
-		AssetManager assets = getAssets();
 		try {
-			InputStream stream = assets.open("help.html");
+			InputStream stream = getHelpFileStream();
 			BufferedReader reader = new BufferedReader(new InputStreamReader(stream, StandardCharsets.UTF_8));
 			StringBuilder builder = new StringBuilder();
 			String line;
@@ -29,8 +30,19 @@ public class HelpActivity extends WebViewActivity {
 			}
 			return builder.toString();
 		} catch (Exception e) {
-			Logger.e(getClass().getSimpleName(), "Failed opening the help.html file.");
+			Logger.e(getClass().getSimpleName(), "Failed opening the help HTML document.");
 			return "";
 		}
 	}
+
+	private InputStream getHelpFileStream() throws IOException {
+		AssetManager assets = getAssets();
+		String systemLanguage = SystemSettings.getLocale().replaceFirst("_\\w+$", "");
+
+		try {
+			return assets.open("help/help." + systemLanguage + ".html");
+		} catch (IOException ignored) {
+			return assets.open("help/help.en.html");
+		}
+	}
 }
diff --git a/app/src/main/java/io/github/sspanak/tt9/preferences/screens/main/MainSettingsScreen.java b/app/src/main/java/io/github/sspanak/tt9/preferences/screens/main/MainSettingsScreen.java
index 250ecf96..12be3d34 100644
--- a/app/src/main/java/io/github/sspanak/tt9/preferences/screens/main/MainSettingsScreen.java
+++ b/app/src/main/java/io/github/sspanak/tt9/preferences/screens/main/MainSettingsScreen.java
@@ -25,6 +25,7 @@ public class MainSettingsScreen extends BaseScreenFragment {
 	public void onCreate() {
 		createSettingsSection();
 		createAboutSection();
+		updateHelpButtonDescription();
 		resetFontSize(false);
 	}
 
@@ -51,6 +52,18 @@ public class MainSettingsScreen extends BaseScreenFragment {
 	}
 
 
+	private void updateHelpButtonDescription() {
+		Preference help = findPreference("screen_help");
+		if (help == null) {
+			return;
+		}
+
+		String systemLanguage = SystemSettings.getLocale().replaceAll("_\\w+$", "");
+		boolean missingLanguage = !systemLanguage.equals("en") && !systemLanguage.equals("es") && !systemLanguage.equals("ru");
+		help.setSummary(missingLanguage ? "English only" : "");
+	}
+
+
 	private void createSettingsSection() {
 		boolean isTT9On = SystemSettings.isTT9Enabled(activity);
 
diff --git a/app/src/main/java/io/github/sspanak/tt9/util/SystemSettings.java b/app/src/main/java/io/github/sspanak/tt9/util/SystemSettings.java
index 7b425154..36bef94c 100644
--- a/app/src/main/java/io/github/sspanak/tt9/util/SystemSettings.java
+++ b/app/src/main/java/io/github/sspanak/tt9/util/SystemSettings.java
@@ -7,6 +7,7 @@ import android.provider.Settings;
 import android.view.inputmethod.InputMethodInfo;
 import android.view.inputmethod.InputMethodManager;
 
+import androidx.annotation.NonNull;
 import androidx.annotation.Nullable;
 
 import java.util.Locale;
@@ -41,6 +42,7 @@ public class SystemSettings {
 		return false;
 	}
 
+	@NonNull
 	public static String getLocale() {
 		Locale locale = Build.VERSION.SDK_INT >= Build.VERSION_CODES.N ? LocaleList.getDefault().get(0) : Locale.getDefault();
 		String country = locale.getCountry();
diff --git a/app/src/main/res/xml/prefs.xml b/app/src/main/res/xml/prefs.xml
index bac5506a..59b2af25 100644
--- a/app/src/main/res/xml/prefs.xml
+++ b/app/src/main/res/xml/prefs.xml
@@ -5,7 +5,6 @@
 
 	<Preference
 		app:key="screen_help"
-		app:summary="English only"
 		app:title="@string/pref_help">
 		<intent
 			android:action="android.intent.action.VIEW"
diff --git a/docs/help/help.en.md b/docs/help/help.en.md
new file mode 100644
index 00000000..655e8f1a
--- /dev/null
+++ b/docs/help/help.en.md
@@ -0,0 +1,335 @@
+# Traditional T9
+This manual explains how to configure and use Traditional T9 in different scenarios. For installation instructions and information about the "lite" and "full" versions, please consult the [Installation Guide](https://github.com/sspanak/tt9/blob/master/docs/installation.md) on GitHub. Finally, you may want to check out the [main repository page](https://github.com/sspanak/tt9), which includes all source code, a developer's guide, the privacy policy, and supplementary documentation.
+
+## Initial Setup
+After installing, first, you need to enable Traditional T9 as an Android keyboard. To do so, click on the launcher icon. If you need to take any action, all options besides Initial Setup will be disabled, and there will be a label: "TT9 is disabled". Go to Initial Setup and enable it.
+
+_If you don't see the icon right after installing, restart your phone, and it should appear. It is due to Android trying to save some battery life by not refreshing the newly installed apps list._
+
+### Using on a touchscreen-only phone
+On touchscreen devices, it is also highly recommended to disable the system spell checker. It can not be used when typing with the number keys, so you can save some battery life by disabling it.
+
+Another problem is, that it may show a confusing "Add Word" popup dialog, which adds words to the default system keyboard (usually, Gboard) and not to Traditional T9's dictionary. Again, to avoid such situations, the system spell checker must be disabled.
+
+If you need to perform this step, the "System Spell Checker" item on the Initial Setup screen will be active. Click it to disable the system component. If you there is no such item, then you don't need to do anything else.
+
+After you are done with the setup, check out the [On-screen Keypad section](#on-screen-keypad) for more tips and tricks.
+
+### Enabling Predictive Mode
+Predictive Mode requires a language dictionary to be loaded to provide word suggestions. You can toggle the enabled languages and load their dictionaries from Settings Screen → [Languages](#language-options). In case, you have forgotten to load some dictionary, Traditional T9 will do it for you automatically when you start typing. For more information, [see below](#language-options).
+
+#### Notes for low-end phones
+Dictionary loading may saturate low-end phones. When using the TT9 "lite" version, this will cause Android to abort the operation. If loading takes more than 30 seconds, plug in the charger or ensure the screen stays on during loading.
+
+You can avoid the above by using the "full" version instead.
+
+#### Notes for Android 13 or higher
+By default, the notifications for newly installed apps are disabled. It is recommended to enable them. This way you will get notified when there are dictionary updates, and once you choose to install them, TT9 will show the loading progress. New updates are released at most once a month, so you don't have to worry about getting too much spam.
+
+You can enable the notifications by going to Settings → Languages and toggling Dictionary Notifications.
+
+_If you decide to keep them off, TT9 will continue to work without problems, but you will have to manage the dictionaries manually._
+
+## Hotkeys
+
+All hotkeys can be reconfigured or disabled from Settings → Keypad → Select Hotkeys.
+
+### Typing Keys
+
+#### Previous Suggestion key (Default: D-pad Left):
+Select the previous word/letter suggestion.
+
+#### Next Suggestion key (Default: D-pad Right):
+Select the next word/letter suggestion.
+
+#### Filter Suggestions key (Default: D-pad Up):
+_Predictive mode only._
+
+- **Single press**: Filter the suggestion list, leaving out only the ones that start with the current word. It doesn't matter if it is a complete word or not. For example, type "remin" and press Filter. It will leave out all words starting with "remin": "remin" itself, "remind", "reminds", "reminded", "reminding", and so on.
+- **Double press**: Expand the filter to the full suggestion. For example, type "remin" and press Filter twice. It will first filter by "remin", then expand the filter to "remind". You can keep expanding the filter until you get to the longest dictionary word.
+
+Filtering is also useful for typing unknown words. Let's say you want to type "Anakin", which is not in the dictionary. Start with "A", then press Filter to hide "B" and "C". Now press 6-key. Since the filter is on, in addition to the real dictionary words, it will provide all possible combinations for 1+6: "A..." + "m", "n", "o". Select "n" and press Filter to confirm your selection and produce "An". Now pressing the 2-key, will provide "An..." + "a", "b", and "c". Select "a", and keep going, until you get "Anakin".
+
+When filtering is enabled, the base text will become bold and italicized.
+
+#### Clear Filter key (Default: D-pad Down):
+_Predictive mode only._
+
+Clear the suggestion filter, if applied.
+
+#### D-pad Center (OK or ENTER):
+- When suggestions are displayed, type the currently selected suggestion.
+- Otherwise, perform the default action for the current application (e.g. send a message, go to a URL, or just type a new line).
+
+_**Note:** Every application decides on its own what to do when OK is pressed and TT9 has no control over this._
+
+_**Note 2:** In messaging applications, you need to enable their "Send with ENTER" or similarly named setting, to send messages with OK. If the application has no such setting, it usually means it disallows sending messages this way._
+
+#### 0-key:
+- **In 123 mode:**
+  - **Press:** type "0".
+  - **Hold:** type special/math characters.
+  - **Hold "0", then press Shift (Default: hold "0", press "✱"):** type currency characters
+- **In ABC mode:**
+  - **Press:** type space, newline, or special/math characters.
+  - **Hold:** type "0".
+  - **Press "0", then press Shift (Default: press "0", "✱"):** type currency characters
+- **In Predictive mode:**
+  - **Press:** type space, newline, or special/math characters.
+  - **Double press:** type the character assigned in Predictive mode settings. (Default: ".")
+  - **Hold:** type "0".
+  - **Press "0", then press Shift (Default: press "0", "✱"):** type currency characters
+
+#### 1-key:
+- **In 123 mode:**
+  - **Press:** type "1".
+  - **Hold:** type sentence characters
+- **In ABC mode:**
+  - **Press:** type sentence characters
+  - **Hold:** type "1".
+- **In Predictive mode:**
+  - **Press:** type sentence characters
+  - **Press multiple times:** type emoji
+  - **Press 1-1-3:** type custom added emoji (you must have added some using [the Add Word key](#add-word-key))
+  - **Hold:** type "1".
+
+
+#### 2- to 9-key:
+- **In 123 mode:** type the respective number
+- **In ABC and Predictive mode:** type a letter or hold to type the respective number.
+
+### Function Keys
+
+#### Add Word Key:
+Add a new word to the dictionary for the current language.
+
+You can also add new emojis and then access them by pressing 1-1-3. Regardless of the currently selected language, all emojis will be available in all languages.
+
+#### Backspace Key (Back, Del, or Backspace):
+Just deletes text.
+
+If your phone has a dedicated "Del" or "Clear" key, you do not need to set anything in the Settings, unless you want to have another Backspace. In this case, the blank option: "--" will be automatically preselected.
+
+On phones which have a combined "Delete"/"Back", that key will be selected automatically. However, you can assign the "Backspace" function to another key, so "Back" will only navigate back.
+
+_**NB:** Using "Back" as backspace does not work in all applications, most notably Firefox, Spotify, and Termux. They can take full control of the key and redefine its function, meaning it will do whatever the app authors intended. Unfortunately, nothing can be done, because "Back" plays a special role in Android and its usage is restricted by the system._
+
+_**NB 2:** Holding the "Back" key will always trigger the default system action (i.e. show the running applications list)._
+
+_In these cases, you could assign another key (all other keys are fully usable), or use the on-screen backspace._
+
+#### Next Input Mode Key (Default: press #):
+Cycle the input modes (abc → Predictive → 123).
+
+_Predictive mode is not available in password fields._
+
+_In number-only fields, changing the mode is not possible. In such cases, the key reverts to its default function (i.e. type "#")._
+
+#### Edit Text Key:
+Show the text editing panel, which allows you to select, cut, copy, and paste text. You can close the panel by pressing the "✱" key again or, in most applications, by pressing the Back button. Details are available [below](#text-editing).
+
+#### Next Language Key (Default: hold #):
+Select the next language, when multiple languages have been enabled from the Settings.
+
+#### Select Keyboard Key:
+Open the Android Change Keyboard dialog where you can select between all installed keyboards.
+
+#### Shift Key (Default: press ✱):
+- **When typing text:** Toggle between uppercase and lowercase.
+- **When typing special characters with the 0-key**: Display the next character group.
+
+#### Show Settings Key:
+Open the Settings configuration screen. It is where you can choose languages for typing, configure the keypad hotkeys, change the application appearance, or improve compatibility with your phone.
+
+#### Voice Input Key:
+Activate the voice input on the phones that support it. See [below](#voice-input) for more info.
+
+#### Command-List Key / aka Command Palette / (Default: hold ✱):
+Show a list of all commands (or functions).
+
+Many phones have only two or three "free" buttons that can be used as hotkeys. But, Traditional T9 has many more functions, meaning there is simply no room for all of them on the keypad. The Command Palette resolves this problem. It allows invoking the additional functions (or commands) using key combos.
+
+Below is a list of the possible commands:
+- **Show the Settings Screen (Default Combo: hold ✱, 1-key).** Same as pressing [Show Settings](#show-settings-key).
+- **Add a Word (Default Combo: hold ✱, 2-key).** Same as pressing [Add Word](#add-word-key).
+- **Voice Input (Default Combo: hold ✱, 3-key).** Same as pressing [Voice Input](#voice-input-key).
+- **Edit Text (Default Combo: hold ✱, 5-key).** Same as pressing [Edit Text](#edit-text-key)
+- **Select a Different Keyboard (Default Combo: hold ✱, 8-key).** Same as pressing [Select Keyboard](#select-keyboard-key).
+
+_This key does not do anything when the Screen Layout is set to "Virtual Keypad" because all keys for all possible functions are already available on the screen._
+
+## Voice Input
+The voice input function allows for speech-to-text input, similar to Gboard. Like all other keyboards, Traditional T9 does not perform speech recognition by itself, but it asks your phone to do it.
+
+_The Voice Input button is hidden on devices that do not support it._
+
+### Supported Devices
+On devices with Google Services, it will use the Google Cloud infrastructure to convert your words to text. You must connect to a Wi-Fi network or enable mobile data for this method to work.
+
+On devices without Google, if the device has a voice assistant app or the native keyboard supports voice input, whichever is available will be used for speech recognition. Note that this method is considerably less capable than Google. It will not work in a noisy environment and will usually recognize only simple phrases, such as: "open calendar" or "play music" and similar. The advantage is that it will work offline.
+
+Other phones without Google will generally not support voice input. Chinese phones do not have speech recognition capabilities due to Chinese security policies. On these phones, it may be possible to enable voice input support by installing the Google application, package name: "com.google.android.googlequicksearchbox".
+
+## On-screen Keypad
+On touchscreen-only phones, a fully functional on-screen keypad is available and it will be enabled automatically. If, for some reason, your phone was not detected to have a touchscreen, enable it by going to Settings → Appearance → On-Screen Layout, and selecting "Virtual Numpad".
+
+If you do have both a touchscreen and a hardware keypad and prefer having more screen space, disable the software keys from Settings → Appearance.
+
+It is also recommended to disable the special behavior of the "Back" key working as "Backspace". It is useful only for a hardware keypad. Usually, it will happen automatically too, but if it does not, go to Settings → Keypad → Select Hotkeys → Backspace key, then select the "--" option.
+
+### Virtual Keys Overview
+The on-screen keypad works the same as the numpad of a phone with hardware keys. If a key provides a single function, it has one label (or icon) indicating that function. And if the key provides a secondary "hold" function, it has two smaller labels (or icons), one below the other.
+
+The Left F4 key (the bottom one on the left-hand side) supports extra functions using swiping. Swipe horizontally to switch to the last used keyboard or swipe vertically to display the keyboard selection dialog and switch to a different keyboard.
+
+### Resizing the Keyboard Panel While Typing
+In some cases, you may find that the Virtual Keypad is taking up too much screen space, preventing you from seeing what you are typing or some application elements. If so, you can resize it by either holding and dragging the Settings/Command Palette key or by dragging the Status Bar (it is where the current language or typing mode is displayed). When the height becomes too small, the layout will automatically be switched to "Function keys" or "Suggestion list only". Respectively, when resizing up, the layout will change to "Virtual Keypad". You can also double-tap the status bar to minimize or maximize instantly.
+
+_Resizing Traditional T9 also results in resizing the current application. Doing both is computationally very expensive. It may cause flickering or stuttering on many phones, even higher-end ones._
+
+### Changing the Key Height
+It is also possible to change the on-screen key height. To do so, go to Settings → Appearance → On-screen Key Height and adjust it as desired.
+
+The default setting of 100% is a good balance between usable button size and screen space taken. However, if you have large fingers, you may want to increase the setting a bit, while if you use TT9 on a larger screen, like a tablet, you may want to decrease it.
+
+_If the available screen space is limited, TT9 will ignore this setting and reduce its height automatically, to leave enough room for the current application._
+
+## Text Editing
+From the Text Editing panel, you can select, cut, copy, and paste text, similar to what is possible with a computer keyboard. To exit Text Editing, press the "✱" key, or the Back key (except in web browsers, Spotify, and a few more applications). Or press the letters key on the On-screen Keyboard.
+
+Below is a list of the possible text commands:
+1. Select the previous character (like Shift+Left on a computer keyboard)
+2. Select none
+3. Select the next character (like Shift+Right)
+4. Select the previous word (like Ctrl+Shift+Left)
+5. Select all
+6. Select the next word (like Ctrl+Shift+Right)
+7. Cut
+8. Copy
+9. Paste
+
+For easier editing, backspace, space, and OK keys are also active.
+
+## Settings Screen
+On the Settings screen, you can choose languages for typing, configure the keypad hotkeys, change the application appearance, or improve compatibility with your phone.
+
+### How to access the Settings?
+
+#### Method 1
+Click on the Traditional T9 launcher icon.
+
+#### Method 2 (using a touchscreen)
+- Tap on a text or a number field to wake up TT9.
+- Use the on-screen gear button.
+
+#### Method 3 (using a physical keyboard)
+- Start typing in a text or a number field to wake up TT9.
+- Open the commands list using the on-screen tools button or by pressing the assigned hotkey [Default: Hold ✱].
+- Press the 2-key.
+
+### Navigating Around the Settings
+If you have a device with a hardware keypad, there are two ways of navigating around the Settings.
+
+1. Use the Up/Down keys for scrolling and OK for opening or activating an option.
+2. Press the 1-9 keys to select the respective option and double-press them to open/activate it. Double-pressing will work no matter where you are on the screen. For example, even if you are at the top double-pressing the 3-key will activate the third option. Finally, the 0-key is a convenient shortcut for scrolling to the end but does not open the last option.
+
+### Language Options
+
+#### Loading a Dictionary
+After enabling one or more new languages, you must load the respective dictionaries for Predictive Mode. Once a dictionary is loaded, it will stay there until you use one of the "delete" options. This means you can enable and disable languages without reloading their dictionaries every time. Just do it once, only the first time.
+
+It also means that if you need to start using language X, you can safely disable all other languages, load only dictionary X (and save time!), and then re-enable all languages you used before.
+
+Have in mind reloading a dictionary will reset the suggestion popularity to the factory defaults. However, there should be nothing to worry about. For the most part, you will see little to no difference in the suggestion order, unless you often use uncommon words.
+
+#### Automatic Dictionary Loading
+
+If you skip or forget to load a dictionary from the Settings screen, it will happen automatically later, when you go to an application where you can type, and switch to Predictive Mode. You will be prompted to wait until it completes and after that, you can start typing right away.
+
+If you delete one or more dictionaries, they will NOT reload automatically. You will have to do so manually. Only dictionaries for newly enabled languages will load automatically.
+
+#### Deleting a Dictionary
+If you have stopped using languages X or Y, you could disable them and also use "Delete Unselected", to free some storage space.
+
+To delete everything, regardless of the selection, use "Delete All".
+
+In all cases, your custom-added words will be preserved and restored once you reload the respective dictionary.
+
+#### Added Words
+The "Export" option allows you to export all added words, for all languages, including any added emoji, to a CSV file. Then, you can use the CSV file to make Traditional T9 better! Go to GitHub and share the words in a [new issue](https://github.com/sspanak/tt9/issues) or [pull request](https://github.com/sspanak/tt9/issues). After being reviewed and approved, they will be included in the next version.
+
+With "Import", you can import a previously exported CSV. However, there are some restrictions:
+- You can import only words consisting of letters. Apostrophes, dashes, other punctuation, or special characters are not allowed.
+- Emojis are not allowed.
+- One CSV file can contain a maximum of 250 words.
+- You can import up to 1000 words, meaning you can import at most 4 files X 250 words. Beyond that limit, you can still add words while typing.
+
+Using "Delete", you can search for and delete misspelled words or others that you don't want in the dictionary.
+
+### Compatibility Options & Troubleshooting
+For several applications or devices, it is possible to enable special options, which will make Traditional T9 work better with them. You can find them at the end of each settings screen, under the Compatibility section.
+
+#### Alternative suggestion scrolling method
+_In: Settings → Appearance._
+
+On some devices, in Predictive Mode, you may not be able may not be able to scroll the list to the end, or you may need to scroll backward and forward several times until the last suggestion appears. The problem occurs sometimes on Android 9 or earlier. Enable the option, if you are experiencing this issue.
+
+
+#### Always on top
+_In: Settings → Appearance._
+
+On some phones, especially Sonim XP3plus (XP3900), Traditional T9 may not appear when you start to type, or it may be partially covered by the soft keys. In other cases, there may be white bars around it. The problem may occur in one particular application or all of them. To prevent it, enable the "Always on Top" option.
+
+#### Key repeat protection
+_In: Settings → Keypad._
+
+CAT S22 Flip and Qin F21 phones are known for their low-quality keypads, which degrade quickly over time and start registering multiple clicks for a single key press. You may notice this when typing or navigating the phone menus.
+
+For CAT phones the recommended setting is 50-75 ms. For Qin F21, try with 20-30 ms. If you are still experiencing the issue, increase the value a bit, but generally try to keep it as low as possible.
+
+
+_**Note:** The higher the value you set, the slower you will have to type. TT9 will ignore very quick key presses._
+
+_**Note 2:** Besides the above, Qin phones may also fail to detect long presses. Unfortunately, in this case, nothing can be done._
+
+#### Send messages with OK in Facebook Messenger
+_In: Settings → Initial Setup._
+
+Sending with OK in Messenger has been no longer possible since the June 2024 update. The recent app redesign caused the Send button to become unreachable for all keyboards. If you have technical knowledge and an idea of how to re-enable this feature, please write in [this GitHub issue](https://github.com/sspanak/tt9/issues/558).
+
+#### Telegram/Snapchat stickers and emoji panels won't open
+This happens if you are using one of the small-sized layouts. Currently, there is no permanent fix, but you can use the following workaround:
+- Go to Settings → Appearance and enable On-Screen Numpad.
+- Go back to the chat and click the emoji or the stickers button. They will now appear.
+- You can now go back to the settings and disable the on-screen numpad. The emoji and sticker panels will remain accessible until you restart the app or the phone.
+
+#### Traditional T9 does not appear immediately in some applications
+If you have opened an application where you can type, but TT9 does not appear automatically, just start typing and it will. Alternatively, pressing the hotkeys to change [the input mode](#next-input-mode-key-default-press-) or the [language](#next-language-key-default-hold-) can also bring up TT9, when it is hidden.
+
+On some devices, TT9 may remain invisible, no matter what you do. In such cases, you have to enable [Always on Top](#always-on-top).
+
+**Long explanation.** The reason for this problem is Android is primarily designed for touchscreen devices. Hence, it expects you to touch the text/number field to show the keyboard. It is possible to make TT9 appear without this confirmation, but then, in some cases, Android will forget to hide it when it must. For example, it may remain visible after you have dialed a phone number or after you have submitted text in a search field.
+
+For these reasons, to stick with the expected Android standards, the control is in your hands. Just press a key to "touch" the screen and keep typing.
+
+#### On the Qin F21 Pro, holding 2-key or 8-key turns up or down the volume instead of typing a number
+To mitigate this problem, go to Settings → Appearance, and enable "Status Icon". TT9 should detect Qin F21 and enable the settings automatically, but in case auto-detection fails, or you have disabled the icon for some reason, you need to have it enabled, for all keys to work properly.
+
+**Long explanation.** Qin F21 Pro (and possibly F22, too), has a hotkey application that allows assigning Volume Up and Volume Down functions to number keys. By default, the hotkey manager is enabled, and holding 2-key increases the volume, holding 8-key decreases it. However, when there is no status icon, the manager assumes no keyboard is active and adjusts the volume, instead of letting Traditional T9 handle the key and type a number. So, enabling the icon just bypasses the hotkey manager and everything works fine.
+
+#### General problems on Xiaomi phones
+Xiaomi has introduced several non-standard permissions on their phones, which prevent Traditional T9's virtual on-screen keyboard from working properly. More precisely, the "Show Settings" and the "Add Word" keys may not perform their respective functions. To fix this, you must grant the "Display pop-up window" and "Display pop-up window while running in the background" permissions to TT9 from your phone's settings. [This guide](https://parental-control.flashget.com/how-to-enable-display-pop-up-windows-while-running-in-the-background-on-flashget-kids-on-xiaomi) for another application explains how to do it.
+
+It is also highly recommended to grant the "Permanent notification" permission. This is similar to the "Notifications" permission introduced in Android 13. See [above](#notes-for-android-13-or-higher) for more information on why you need it.
+
+_The Xiaomi problems have been discussed in [this GitHub issue](https://github.com/sspanak/tt9/issues/490)._
+
+#### Voice Input takes a very long time to stop
+It is [a known problem](https://issuetracker.google.com/issues/158198432) on Android 10 that Google never fixed. It is not possible to mitigate it on the TT9 side. To stop the Voice Input operation, stay quiet for a couple of seconds. Android turns off the microphone automatically when it can not detect any speech.
+
+#### I need to use a QWERTY layout (touchscreen devices only)
+Traditional T9 is a T9 keyboard and as such, it does not provide a QWERTY-like layout.
+
+If you are still learning to use T9 and need to switch back occasionally, or you find it more convenient to type new words using QWERTY, swipe the Left F4 key to switch to a different keyboard. See the [virtual keys overview](#virtual-keys-overview) for more information.
+
+Most other keyboards allow switching back to Traditional T9 by holding the spacebar or the "change language" key. Check the respective readme or manual for more info.
\ No newline at end of file
diff --git a/docs/help/help.es.md b/docs/help/help.es.md
new file mode 100644
index 00000000..165be089
--- /dev/null
+++ b/docs/help/help.es.md
@@ -0,0 +1,332 @@
+# Traditional T9
+Este manual explica cómo configurar y utilizar el T9 Tradicional en diferentes escenarios. Para obtener instrucciones de instalación e información sobre las versiones "lite" y "full", consulte la [Guía de Instalación](https://github.com/sspanak/tt9/blob/master/docs/installation.md) en GitHub. Finalmente, puede visitar la [página del repositorio principal](https://github.com/sspanak/tt9), que incluye todo el código fuente, una guía para desarrolladores, la política de privacidad y documentación complementaria.
+
+## Configuración Inicial
+Después de instalar, primero debe habilitar T9 Tradicional como teclado de Android. Para hacerlo, haga clic en el icono del lanzador. Si necesita realizar alguna acción, todas las opciones, excepto la Configuración Inicial, estarán deshabilitadas, y habrá una etiqueta: "TT9 está deshabilitado". Vaya a Configuración Inicial y habilítelo.
+
+_Si no ve el icono justo después de la instalación, reinicie su teléfono, y debería aparecer. Esto se debe a que Android intenta ahorrar batería al no actualizar la lista de aplicaciones recién instaladas._
+
+### Uso en un teléfono solo con pantalla táctil
+En los dispositivos con pantalla táctil, también se recomienda deshabilitar el corrector ortográfico del sistema. No se puede usar cuando se escribe con las teclas numéricas, por lo que puede ahorrar algo de batería al desactivarlo.
+
+Otro problema es que puede mostrar un cuadro de diálogo confuso de "Agregar palabra", que agrega palabras al teclado predeterminado del sistema (generalmente Gboard) y no al diccionario de T9 Tradicional. De nuevo, para evitar tales situaciones, debe deshabilitarse el corrector ortográfico del sistema.
+
+Si necesita realizar este paso, el elemento "Corrector Ortográfico del Sistema" en la pantalla de Configuración Inicial estará activo. Haga clic en él para deshabilitar el componente del sistema. Si no aparece ese elemento, entonces no necesita hacer nada más.
+
+Una vez que haya terminado con la configuración, consulte la sección [Teclado en pantalla](#teclado-en-pantalla) para obtener más consejos y trucos.
+
+### Habilitar el Modo Predictivo
+El Modo Predictivo requiere que se cargue un diccionario de idioma para ofrecer sugerencias de palabras. Puede activar o desactivar los idiomas habilitados y cargar sus diccionarios desde la Pantalla de Configuración → [Idiomas](#opciones-de-idioma). En caso de que olvide cargar algún diccionario, T9 Tradicional lo hará automáticamente cuando empiece a escribir. Para más información, [consulte a continuación](#opciones-de-idioma).
+
+#### Notas para teléfonos de gama baja
+La carga del diccionario puede saturar teléfonos de gama baja. Al usar la versión "lite" de TT9, esto puede hacer que Android interrumpa la operación. Si la carga dura más de 30 segundos, conecte el cargador o asegúrese de que la pantalla permanezca encendida durante la carga.
+
+Puede evitar lo anterior usando la versión "full".
+
+#### Notas para Android 13 o superior
+Por defecto, las notificaciones para las aplicaciones recién instaladas están deshabilitadas. Se recomienda habilitarlas. De esta manera, recibirá notificaciones cuando haya actualizaciones de diccionario, y una vez que elija instalarlas, TT9 mostrará el progreso de la carga. Las nuevas actualizaciones se lanzan como máximo una vez al mes, por lo que no tiene que preocuparse por recibir demasiados mensajes.
+
+Puede habilitar las notificaciones yendo a Configuración → Idiomas y activando las Notificaciones de Diccionario.
+
+_Si decide mantenerlas desactivadas, TT9 seguirá funcionando sin problemas, pero tendrá que gestionar los diccionarios manualmente._
+
+## Teclas de Acceso Rápido
+
+Todas las teclas de acceso rápido se pueden reconfigurar o deshabilitar desde Configuración → Teclado → Seleccionar Teclas de Acceso Rápido.
+
+### Teclas de Escritura
+
+#### Tecla de Sugerencia Anterior (Por Defecto: Flecha Izquierda del D-pad):
+Seleccione la sugerencia de palabra/letra anterior.
+
+#### Tecla de Sugerencia Siguiente (Por Defecto: Flecha Derecha del D-pad):
+Seleccione la siguiente sugerencia de palabra/letra.
+
+#### Tecla de Filtrar Sugerencias (Por Defecto: Flecha Arriba del D-pad):
+_Solo en modo predictivo._
+
+- **Una sola pulsación**: Filtra la lista de sugerencias, dejando solo las que comienzan con la palabra actual. No importa si es una palabra completa o no. Por ejemplo, escriba "remin" y presione Filtrar. Dejará solo las palabras que comienzan con "remin": "remin" en sí, "remind", "reminds", "reminded", "reminding", etc.
+- **Doble pulsación**: Expande el filtro a la sugerencia completa. Por ejemplo, escriba "remin" y presione Filtrar dos veces. Primero filtrará por "remin", luego expandirá el filtro a "remind". Puede seguir expandiendo el filtro hasta llegar a la palabra más larga del diccionario.
+
+El filtrado también es útil para escribir palabras desconocidas. Supongamos que quiere escribir "Anakin", que no está en el diccionario. Comience con "A", luego presione Filtrar para ocultar "B" y "C". Ahora presione la tecla 6. Como el filtro está activado, además de las palabras reales del diccionario, proporcionará todas las combinaciones posibles para 1+6: "A..." + "m", "n", "o". Seleccione "n" y presione Filtrar para confirmar su selección y producir "An". Ahora, al presionar la tecla 2, se proporcionará "An..." + "a", "b", y "c". Seleccione "a", y siga hasta obtener "Anakin".
+
+Cuando el filtro está habilitado, el texto base se volverá negrita e itálico.
+
+#### Tecla de Borrar Filtro (Por Defecto: Flecha Abajo del D-pad):
+_Solo en modo predictivo._
+
+Borrar el filtro de sugerencias, si está aplicado.
+
+#### Flecha Central del D-pad (OK o ENTER):
+- Cuando se muestran sugerencias, escribe la sugerencia actualmente seleccionada.
+- De lo contrario, realiza la acción predeterminada para la aplicación actual (por ejemplo, enviar un mensaje, ir a una URL o simplemente escribir una nueva línea).
+
+_**Nota:** Cada aplicación decide por sí misma qué hacer cuando se presiona OK y TT9 no tiene control sobre esto._
+
+_**Nota 2:** En aplicaciones de mensajería, debe habilitar su configuración de "Enviar con ENTER" o una similar para enviar mensajes con OK. Si la aplicación no tiene tal configuración, generalmente significa que no permite enviar mensajes de esta manera._
+
+#### Tecla 0:
+- **En modo 123:**
+  - **Presione:** escribir "0".
+  - **Mantenga presionado:** escribir caracteres especiales/matemáticos.
+  - **Mantenga presionado "0", luego presione Shift (Por Defecto: mantenga presionado "0", presione "✱")**: escribir caracteres de moneda.
+- **En modo ABC:**
+  - **Presione:** escribir espacio, nueva línea o caracteres especiales/matemáticos.
+  - **Mantenga presionado:** escribir "0".
+  - **Presione "0", luego presione Shift (Por Defecto: presione "0", "✱")**: escribir caracteres de moneda.
+- **En modo predictivo:**
+  - **Presione:** escribir espacio, nueva línea o caracteres especiales/matemáticos.
+  - **Doble presión:** escribir el carácter asignado en la configuración del modo predictivo. (Por Defecto: ".")
+  - **Mantenga presionado:** escribir "0".
+  - **Presione "0", luego presione Shift (Por Defecto: presione "0", "✱")**: escribir caracteres de moneda.
+
+#### Tecla 1:
+- **En modo 123:**
+  - **Presione:** escribir "1".
+  - **Mantenga presionado:** escribir caracteres de oración.
+- **En modo ABC:**
+  - **Presione:** escribir caracteres de oración.
+  - **Mantenga presionado:** escribir "1".
+- **En modo predictivo:**
+  - **Presione:** escribir caracteres de oración.
+  - **Presione varias veces:** escribir emoji.
+  - **Presione 1-1-3:** escribir emoji personalizados agregados (debe haber agregado algunos usando la [Tecla de Agregar Palabra](#tecla-de-agregar-palabra)).
+  - **Mantenga presionado:** escribir "1".
+
+#### Teclas del 2 al 9:
+- **En modo 123:** escribir el número respectivo.
+- **En modo ABC y Predictivo:** escribir una letra o mantener presionado para escribir el número respectivo.
+
+### Teclas de Función
+
+#### Tecla de Agregar Palabra:
+Agregar una nueva palabra al diccionario para el idioma actual.
+
+También puede agregar nuevos emojis y luego acceder a ellos presionando 1-1-3. Independientemente del idioma seleccionado, todos los emojis estarán disponibles en todos los idiomas.
+
+#### Tecla de Borrar (Atrás, Del o Retroceso):
+Simplemente elimina el texto.
+
+Si su teléfono tiene una tecla dedicada de "Del" o "Clear", no necesita configurar nada en los Ajustes, a menos que desee tener otra tecla de retroceso. En este caso, la opción en blanco: "--" se preseleccionará automáticamente.
+
+En teléfonos que tienen una tecla combinada de "Eliminar"/"Atrás", esa tecla se seleccionará automáticamente. Sin embargo, puede asignar la función de "Retroceso" a otra tecla, por lo que "Atrás" solo navegará hacia atrás.
+
+_**NB:** Usar "Atrás" como retroceso no funciona en todas las aplicaciones, especialmente en Firefox, Spotify y Termux. Pueden tomar control total de la tecla y redefinir su función, lo que significa que hará lo que los autores de la aplicación pretendan. Desafortunadamente, no se puede hacer nada, porque "Atrás" juega un papel especial en Android y su uso está restringido por el sistema._
+
+_**NB 2:** Mantener presionada la tecla "Atrás" siempre activará la acción predeterminada del sistema (es decir, mostrar la lista de aplicaciones en ejecución)._
+
+_En estos casos, podría asignar otra tecla (todas las demás teclas son completamente utilizables), o usar el retroceso en pantalla._
+
+#### Tecla de Modo de Entrada Siguiente (Por Defecto: presionar #):
+Ciclar entre los modos de entrada (abc → Predictivo → 123).
+
+_El modo predictivo no está disponible en campos de contraseñas._
+
+_En campos de solo números, cambiar el modo no es posible. En tales casos, la tecla vuelve a su función predeterminada (es decir, escribir "#")._
+
+#### Tecla de Editar Texto:
+Mostrar el panel de edición de texto, que permite seleccionar, cortar, copiar y pegar texto. Puede cerrar el panel presionando la tecla "✱" de nuevo o, en la mayoría de las aplicaciones, presionando el botón Atrás. Los detalles están disponibles [a continuación](#edición-de-texto).
+
+#### Tecla de Idioma Siguiente (Por Defecto: mantener presionado #):
+Seleccione el siguiente idioma, cuando varios idiomas hayan sido habilitados desde los Ajustes.
+
+#### Tecla de Seleccionar Teclado:
+Abra el diálogo de Cambiar Teclado de Android, donde puede seleccionar entre todos los teclados instalados.
+
+#### Tecla Shift (Por Defecto: presionar ✱):
+- **Al escribir texto:** Alterna entre mayúsculas y minúsculas.
+- **Al escribir caracteres especiales con la tecla 0:** Muestra el siguiente grupo de caracteres.
+
+#### Tecla de Mostrar Ajustes:
+Abra la pantalla de configuración de Ajustes. Aquí puede elegir los idiomas para escribir, configurar las teclas de acceso rápido del teclado, cambiar la apariencia de la aplicación o mejorar la compatibilidad con su teléfono.
+
+#### Tecla de Entrada por Voz:
+Active la entrada por voz en teléfonos que lo soporten. Consulte [a continuación](#entrada-por-voz) para obtener más información.
+
+#### Tecla de Lista de Comandos / también conocida como Paleta de Comandos / (Por Defecto: mantener presionado ✱):
+Mostrar una lista de todos los comandos (o funciones).
+
+Muchos teléfonos tienen solo dos o tres botones "libres" que se pueden usar como teclas de acceso rápido. Pero T9 Tradicional tiene muchas más funciones, lo que significa que simplemente no hay espacio para todas en el teclado. La Paleta de Comandos resuelve este problema. Permite invocar las funciones adicionales (o comandos) usando combinaciones de teclas.
+
+A continuación se muestra una lista de los posibles comandos:
+- **Mostrar la pantalla de Ajustes (Combinación por Defecto: mantener presionado ✱, tecla 1).** Igual que presionar [Mostrar Ajustes](#tecla-de-mostrar-ajustes).
+- **Agregar una palabra (Combinación por Defecto: mantener presionado ✱, tecla 2).** Igual que presionar [Agregar Palabra](#tecla-de-agregar-palabra).
+- **Entrada por voz (Combinación por Defecto: mantener presionado ✱, tecla 3).** Igual que presionar [Entrada por Voz](#tecla-de-entrada-por-voz).
+- **Editar Texto (Combinación por Defecto: mantener presionado ✱, tecla 5).** Igual que presionar [Editar Texto](#tecla-de-editar-texto).
+- **Seleccionar un teclado diferente (Combinación por Defecto: mantener presionado ✱, tecla 8).** Igual que presionar [Seleccionar Teclado](#tecla-de-seleccionar-teclado).
+
+_Esta tecla no hace nada cuando el diseño de pantalla está configurado en "Teclado Virtual" porque todas las teclas para todas las funciones posibles ya están disponibles en la pantalla._
+
+## Entrada por Voz
+La función de entrada por voz permite la conversión de voz a texto, similar a Gboard. Como todos los demás teclados, T9 Tradicional no realiza el reconocimiento de voz por sí mismo, sino que solicita a tu teléfono que lo haga.
+
+_El botón de Entrada por Voz está oculto en los dispositivos que no la soportan._
+
+### Dispositivos Compatibles
+En dispositivos con Servicios de Google, utilizará la infraestructura de Google Cloud para convertir tus palabras en texto. Debes conectarte a una red Wi-Fi o habilitar datos móviles para que este método funcione.
+
+En dispositivos sin Google, si el dispositivo tiene una aplicación de asistente de voz o el teclado nativo admite entrada por voz, se utilizará lo que esté disponible para el reconocimiento de voz. Ten en cuenta que este método es considerablemente menos capaz que Google. No funcionará en un entorno ruidoso y generalmente solo reconocerá frases simples, como: "abrir calendario" o "reproducir música" y similares. La ventaja es que funcionará sin conexión.
+
+Otros teléfonos sin Google generalmente no admiten la entrada por voz. Los teléfonos chinos no tienen capacidades de reconocimiento de voz debido a políticas de seguridad de China. En estos teléfonos, es posible habilitar el soporte de entrada por voz instalando la aplicación de Google, nombre del paquete: "com.google.android.googlequicksearchbox".
+
+## Teclado en Pantalla
+En teléfonos solo con pantalla táctil, hay un teclado en pantalla totalmente funcional disponible que se activará automáticamente. Si, por alguna razón, tu teléfono no fue detectado como táctil, habilítalo yendo a Configuración → Apariencia → Disposición en Pantalla y seleccionando "Teclado Numérico Virtual".
+
+Si tienes tanto una pantalla táctil como un teclado físico y prefieres tener más espacio en la pantalla, desactiva las teclas de software desde Configuración → Apariencia.
+
+También se recomienda desactivar el comportamiento especial de la tecla "Atrás" para que funcione como "Retroceso". Solo es útil para un teclado físico. Por lo general, esto también sucederá automáticamente, pero si no es así, ve a Configuración → Teclado → Seleccionar Teclas de Función → Tecla Retroceso, luego selecciona la opción "--".
+
+### Descripción General de las Teclas Virtuales
+El teclado en pantalla funciona igual que el teclado numérico de un teléfono con teclas físicas. Si una tecla proporciona una sola función, tiene una etiqueta (o icono) que indica esa función. Y si la tecla proporciona una función secundaria al mantenerla presionada, tiene dos etiquetas más pequeñas (o íconos), una debajo de la otra.
+
+La tecla F4 Izquierda (la inferior del lado izquierdo) admite funciones adicionales mediante deslizamientos. Desliza horizontalmente para cambiar al último teclado usado o desliza verticalmente para mostrar el diálogo de selección de teclado y cambiar a uno diferente.
+
+### Redimensionar el Panel del Teclado Mientras Escribes
+En algunos casos, puede que el teclado virtual ocupe demasiado espacio en la pantalla, impidiéndote ver lo que estás escribiendo o algunos elementos de la aplicación. Si es así, puedes redimensionarlo manteniendo presionada y arrastrando la tecla de Configuración/Paleta de Comandos o arrastrando la Barra de Estado (donde se muestra el idioma actual o el modo de escritura). Cuando la altura se vuelva demasiado pequeña, el diseño cambiará automáticamente a "Teclas de Función" o "Solo lista de sugerencias". Respectivamente, al redimensionar hacia arriba, el diseño cambiará a "Teclado Virtual". También puedes tocar dos veces la barra de estado para minimizar o maximizar instantáneamente.
+
+_Redimensionar T9 Tradicional también redimensiona la aplicación actual. Hacer ambas cosas es computacionalmente muy costoso. Puede causar parpadeos o retrasos en muchos teléfonos, incluso en los de gama alta._
+
+### Cambiar la Altura de las Teclas
+También es posible cambiar la altura de las teclas en pantalla. Para hacerlo, ve a Configuración → Apariencia → Altura de las Teclas en Pantalla y ajústalo como desees.
+
+La configuración predeterminada del 100% es un buen equilibrio entre el tamaño útil de los botones y el espacio de pantalla ocupado. Sin embargo, si tienes dedos grandes, es posible que quieras aumentar la configuración un poco, mientras que si usas TT9 en una pantalla más grande, como una tableta, es posible que quieras reducirla.
+
+_Si el espacio de pantalla disponible es limitado, TT9 ignorará esta configuración y reducirá su altura automáticamente, para dejar suficiente espacio para la aplicación actual._
+
+## Edición de Texto
+Desde el panel de Edición de Texto, puedes seleccionar, cortar, copiar y pegar texto, similar a lo que es posible con un teclado de computadora. Para salir de la Edición de Texto, presiona la tecla "✱", o la tecla Atrás (excepto en navegadores web, Spotify y algunas otras aplicaciones). O presiona la tecla de letras en el teclado en pantalla.
+
+A continuación, se muestra una lista de los posibles comandos de texto:
+1. Seleccionar el carácter anterior (como Shift+Izquierda en un teclado de computadora)
+2. Deseleccionar todo
+3. Seleccionar el siguiente carácter (como Shift+Derecha)
+4. Seleccionar la palabra anterior (como Ctrl+Shift+Izquierda)
+5. Seleccionar todo
+6. Seleccionar la siguiente palabra (como Ctrl+Shift+Derecha)
+7. Cortar
+8. Copiar
+9. Pegar
+
+Para facilitar la edición, las teclas de retroceso, espacio y OK también están activas.
+
+## Pantalla de Configuración
+En la pantalla de Configuración, puedes elegir los idiomas para escribir, configurar las teclas rápidas del teclado, cambiar la apariencia de la aplicación o mejorar la compatibilidad con tu teléfono.
+
+### ¿Cómo acceder a la Configuración?
+
+#### Método 1
+Haz clic en el ícono del lanzador de T9 Tradicional.
+
+#### Método 2 (usando pantalla táctil)
+- Toca en un campo de texto o número para activar TT9.
+- Usa el botón de engranaje en pantalla.
+
+#### Método 3 (usando un teclado físico)
+- Empieza a escribir en un campo de texto o número para activar TT9.
+- Abre la lista de comandos usando el botón de herramientas en pantalla o presionando la tecla asignada [Por Defecto: Mantener presionado ✱].
+- Presiona la tecla 2.
+
+### Navegando en la Configuración
+Si tienes un dispositivo con teclado físico, hay dos formas de navegar en la Configuración.
+
+1. Usa las teclas Arriba/Abajo para desplazarte y OK para abrir o activar una opción.
+2. Presiona las teclas del 1 al 9 para seleccionar la opción respectiva y presiona dos veces para abrir/activar. El doble toque funcionará sin importar dónde estés en la pantalla. Por ejemplo, incluso si estás en la parte superior, presionar dos veces la tecla 3 activará la tercera opción. Finalmente, la tecla 0 es un atajo conveniente para desplazarte hasta el final, pero no abre la última opción.
+
+### Opciones de idioma
+
+#### Cargar un diccionario
+Después de habilitar uno o más idiomas nuevos, debes cargar los diccionarios respectivos para el Modo Predictivo. Una vez cargado un diccionario, permanecerá allí hasta que utilices una de las opciones de "eliminar". Esto significa que puedes habilitar y deshabilitar idiomas sin tener que recargar sus diccionarios cada vez. Solo hazlo una vez, solo la primera vez.
+
+También significa que si necesitas comenzar a usar el idioma X, puedes deshabilitar de manera segura todos los demás idiomas, cargar solo el diccionario X (¡y ahorrar tiempo!), y luego volver a habilitar todos los idiomas que usabas antes.
+
+Ten en cuenta que recargar un diccionario restablecerá la popularidad de las sugerencias a los valores predeterminados de fábrica. Sin embargo, no debería ser motivo de preocupación. En la mayoría de los casos, verás poca o ninguna diferencia en el orden de las sugerencias, a menos que uses palabras inusuales con frecuencia.
+
+#### Carga automática de diccionarios
+
+Si omites o te olvidas de cargar un diccionario desde la pantalla de Configuración, se cargará automáticamente más tarde, cuando vayas a una aplicación donde puedas escribir y cambies al Modo Predictivo. Se te pedirá que esperes hasta que termine y después de eso, podrás comenzar a escribir de inmediato.
+
+Si eliminas uno o más diccionarios, NO se recargarán automáticamente. Tendrás que hacerlo manualmente. Solo se cargarán automáticamente los diccionarios de los idiomas recién habilitados.
+
+#### Eliminar un diccionario
+Si has dejado de usar los idiomas X o Y, podrías deshabilitarlos y también usar "Eliminar no seleccionados" para liberar algo de espacio de almacenamiento.
+
+Para eliminar todo, independientemente de la selección, utiliza "Eliminar todo".
+
+En todos los casos, tus palabras agregadas de forma personalizada se preservarán y se restaurarán una vez que recargues el diccionario respectivo.
+
+#### Palabras añadidas
+La opción "Exportar" te permite exportar todas las palabras añadidas, para todos los idiomas, incluidos los emoji añadidos, a un archivo CSV. Luego, puedes usar el archivo CSV para mejorar Traditional T9. Ve a GitHub y comparte las palabras en un [nuevo issue](https://github.com/sspanak/tt9/issues) o [pull request](https://github.com/sspanak/tt9/issues). Después de ser revisadas y aprobadas, se incluirán en la próxima versión.
+
+Con "Importar", puedes importar un CSV exportado previamente. Sin embargo, hay algunas restricciones:
+- Solo puedes importar palabras que consistan en letras. No se permiten apóstrofes, guiones, otras puntuaciones o caracteres especiales.
+- No se permiten emojis.
+- Un archivo CSV puede contener un máximo de 250 palabras.
+- Puedes importar hasta 1000 palabras, lo que significa que puedes importar como máximo 4 archivos x 250 palabras. Más allá de ese límite, aún puedes agregar palabras mientras escribes.
+
+Con la opción "Eliminar", puedes buscar y eliminar palabras mal escritas u otras que no deseas en el diccionario.
+
+### Opciones de compatibilidad y resolución de problemas
+Para varias aplicaciones o dispositivos, es posible habilitar opciones especiales que harán que Traditional T9 funcione mejor con ellos. Puedes encontrarlas al final de cada pantalla de configuración, en la sección Compatibilidad.
+
+#### Método alternativo de desplazamiento de sugerencias
+_En: Configuración → Apariencia._
+
+En algunos dispositivos, en el Modo Predictivo, es posible que no puedas desplazarte hasta el final de la lista o que necesites desplazarte hacia atrás y hacia adelante varias veces hasta que aparezca la última sugerencia. El problema ocurre a veces en Android 9 o anterior. Habilita la opción si experimentas este problema.
+
+#### Siempre en la parte superior
+_En: Configuración → Apariencia._
+
+En algunos teléfonos, especialmente Sonim XP3plus (XP3900), Traditional T9 puede no aparecer cuando comienzas a escribir o puede estar parcialmente cubierto por las teclas táctiles. En otros casos, puede haber barras blancas a su alrededor. El problema puede ocurrir en una aplicación en particular o en todas ellas. Para evitarlo, habilita la opción "Siempre en la parte superior".
+
+#### Protección contra repetición de teclas
+_En: Configuración → Teclado._
+
+Los teléfonos CAT S22 Flip y Qin F21 son conocidos por sus teclados de baja calidad, que se degradan rápidamente con el tiempo y comienzan a registrar múltiples clics por una sola pulsación de tecla. Es posible que notes esto al escribir o al navegar por los menús del teléfono.
+
+Para los teléfonos CAT, la configuración recomendada es de 50-75 ms. Para el Qin F21, prueba con 20-30 ms. Si aún experimentas el problema, aumenta un poco el valor, pero en general intenta mantenerlo lo más bajo posible.
+
+_**Nota:** Cuanto mayor sea el valor que configures, más lento tendrás que escribir. TT9 ignorará las pulsaciones de teclas muy rápidas._
+
+_**Nota 2:** Además de lo anterior, los teléfonos Qin también pueden fallar al detectar pulsaciones largas. Desafortunadamente, en este caso, no se puede hacer nada._
+
+#### Enviar mensajes con OK en Facebook Messenger
+_En: Configuración → Configuración Inicial._
+
+Enviar con OK en Messenger ya no es posible desde la actualización de junio de 2024. El rediseño reciente de la aplicación hizo que el botón de Enviar fuera inalcanzable para todos los teclados. Si tienes conocimientos técnicos y una idea de cómo volver a habilitar esta función, por favor escribe en [este issue de GitHub](https://github.com/sspanak/tt9/issues/558).
+
+#### Los paneles de stickers y emoji de Telegram/Snapchat no se abren
+Esto ocurre si estás utilizando uno de los diseños de tamaño pequeño. Actualmente, no hay una solución permanente, pero puedes utilizar el siguiente método alternativo:
+- Ve a Configuración → Apariencia y habilita Teclado numérico en pantalla.
+- Vuelve al chat y haz clic en el botón de emoji o stickers. Ahora aparecerán.
+- Puedes volver a la configuración y deshabilitar el teclado numérico en pantalla. Los paneles de emoji y stickers seguirán siendo accesibles hasta que reinicies la aplicación o el teléfono.
+
+#### Traditional T9 no aparece inmediatamente en algunas aplicaciones
+Si has abierto una aplicación donde puedes escribir, pero TT9 no aparece automáticamente, solo comienza a escribir y lo hará. Alternativamente, presionar las teclas de acceso rápido para cambiar [el modo de entrada](#tecla-de-modo-de-entrada-siguiente-por-defecto-presionar) o el [idioma](#tecla-de-idioma-siguiente-por-defecto-mantener-presionado) también puede hacer aparecer TT9, cuando esté oculto.
+
+En algunos dispositivos, TT9 puede permanecer invisible, sin importar lo que hagas. En esos casos, debes habilitar [Siempre en la parte superior](#siempre-en-la-parte-superior).
+
+**Explicación larga.** La razón de este problema es que Android está diseñado principalmente para dispositivos con pantalla táctil. Por lo tanto, espera que toques el campo de texto/número para mostrar el teclado. Es posible hacer que TT9 aparezca sin esta confirmación, pero entonces, en algunos casos, Android olvidará ocultarlo cuando deba hacerlo. Por ejemplo, puede permanecer visible después de marcar un número de teléfono o después de enviar texto en un campo de búsqueda.
+
+Por estas razones, para cumplir con los estándares esperados de Android, el control está en tus manos. Solo presiona una tecla para "tocar" la pantalla y sigue escribiendo.
+
+#### En el Qin F21 Pro, mantener presionadas las teclas 2 o 8 sube o baja el volumen en lugar de escribir un número
+Para mitigar este problema, ve a Configuración → Apariencia, y habilita "Icono de estado". TT9 debería detectar Qin F21 y habilitar la configuración automáticamente, pero en caso de que la detección automática falle o hayas deshabilitado el icono por alguna razón, debes tenerlo habilitado para que todas las teclas funcionen correctamente.
+
+**Explicación larga.** Qin F21 Pro (y posiblemente F22 también), tiene una aplicación de teclas rápidas que permite asignar funciones de subir y bajar volumen a las teclas numéricas. Por defecto, el administrador de teclas rápidas está habilitado, y mantener presionada la tecla 2 aumenta el volumen, mantener presionada la tecla 8 lo disminuye. Sin embargo, cuando no hay icono de estado, el administrador asume que no hay un teclado activo y ajusta el volumen en lugar de permitir que Traditional T9 maneje la tecla y escriba un número. Por lo tanto, habilitar el icono simplemente evita el administrador de teclas rápidas y todo funciona bien.
+
+#### Problemas generales en los teléfonos Xiaomi
+Xiaomi ha introducido varios permisos no estándar en sus teléfonos que impiden que el teclado virtual en pantalla de Traditional T9 funcione correctamente. Más precisamente, las teclas "Mostrar Configuración" y "Agregar Palabra" pueden no realizar sus funciones respectivas. Para solucionarlo, debes otorgar los permisos "Mostrar ventana emergente" y "Mostrar ventana emergente mientras se ejecuta en segundo plano" a TT9 desde la configuración de tu teléfono. [Esta guía](https://parental-control.flashget.com/how-to-enable-display-pop-up-windows-while-running-in-the-background-on-flashget-kids-on-xiaomi) para otra aplicación explica cómo hacerlo.
+
+También se recomienda encarecidamente otorgar el permiso de "Notificación permanente". Esto es similar al permiso de "Notificaciones" introducido en Android 13. Consulta [arriba](#notas-para-android-13-o-superior) para obtener más información sobre por qué lo necesitas.
+
+_Los problemas con Xiaomi se han discutido en [este issue de GitHub](https://github.com/sspanak/tt9/issues/490)._
+
+#### La entrada por voz tarda mucho en detenerse
+Es [un problema conocido](https://issuetracker.google.com/issues/158198432) en Android 10 que Google nunca solucionó. No es posible mitigar este problema en el lado de TT9. Para detener la operación de Entrada por Voz, permanece en silencio durante un par de segundos. Android apaga el micrófono automáticamente cuando no puede detectar ningún habla.
+
+#### Necesito usar un diseño QWERTY (solo dispositivos con pantalla táctil)
+Traditional T9 es un teclado T9 y, como tal, no proporciona un diseño similar a QWERTY.
+
+Si aún estás aprendiendo a usar T9 y necesitas cambiar de vez en cuando, o encuentras más conveniente escribir nuevas palabras usando QWERTY, desliza la tecla F4 izquierda para cambiar a un teclado diferente. Consulta la [visión general de teclas virtuales](#descripción-general-de-las-teclas-virtuales) para obtener más información.
+
+La mayoría de los otros teclados permiten cambiar de nuevo a Traditional T9 manteniendo presionada la barra espaciadora o la tecla de "cambiar idioma". Consulta el respectivo readme o manual para más información.
diff --git a/docs/help/help.ru.md b/docs/help/help.ru.md
new file mode 100644
index 00000000..70cda78a
--- /dev/null
+++ b/docs/help/help.ru.md
@@ -0,0 +1,332 @@
+# Traditional T9
+Этот мануал объясняет, как настроить и использовать Традиционный T9 в различных сценариях. Для инструкций по установке и информации о версиях "lite" и "full", пожалуйста, обратитесь к [Руководству по установке](https://github.com/sspanak/tt9/blob/master/docs/installation.md) на GitHub. Наконец, вы можете ознакомиться с [главной страницей репозитория](https://github.com/sspanak/tt9), где содержится весь исходный код, руководство для разработчиков, политика конфиденциальности и дополнительная документация.
+
+## Начальная настройка
+После установки вам нужно сначала включить Традиционный T9 как клавиатуру Android. Для этого нажмите на значок запуска. Если необходимо предпринять какие-либо действия, все опции, кроме Начальной Настройки, будут отключены, и появится надпись: "TT9 отключен". Перейдите в Начальную Настройку и включите его.
+
+_Если вы не видите значок сразу после установки, перезапустите телефон, и он должен появиться. Это связано с тем, что Android пытается сэкономить заряд батареи, не обновляя список недавно установленных приложений._
+
+### Использование на телефоне только с сенсорным экраном
+На устройствах с сенсорным экраном также настоятельно рекомендуется отключить системную проверку орфографии. Она не может быть использована при наборе с помощью цифровых клавиш, поэтому отключение сэкономит заряд батареи.
+
+Еще одна проблема заключается в том, что может появляться сбивающий с толку диалоговое окно "Добавить слово", которое добавляет слова в словарь системной клавиатуры (обычно это Gboard), а не в словарь Традиционного T9. Опять же, чтобы избежать таких ситуаций, необходимо отключить системную проверку орфографии.
+
+Если вам нужно выполнить этот шаг, пункт "Системная проверка орфографии" на экране Начальной Настройки будет активен. Нажмите на него, чтобы отключить системный компонент. Если такого пункта нет, то вам больше ничего не нужно делать.
+
+Когда настройка завершена, ознакомьтесь с разделом [Экранная клавиатура](#экранная-клавиатура) для получения дополнительных советов и трюков.
+
+### Включение режима Предсказания
+Режим Предсказания требует загрузки языкового словаря для предложения слов. Вы можете включать и загружать словари на экране Настроек → [Языки](#языковые-настройки). В случае, если вы забыли загрузить какой-либо словарь, Традиционный T9 сделает это автоматически, когда вы начнете набирать текст. Более подробную информацию смотрите [ниже](#языковые-настройки).
+
+#### Примечания для слабых телефонов
+Загрузка словарей может перегружать слабые телефоны. При использовании версии TT9 "lite" это может привести к тому, что Android прервёт операцию. Если загрузка занимает больше 30 секунд, подключите зарядное устройство или убедитесь, что экран остаётся включённым во время загрузки.
+
+Вы можете избежать этого, используя вместо этого версию "full".
+
+#### Примечания для Android 13 или выше
+По умолчанию уведомления для недавно установленных приложений отключены. Рекомендуется их включить. Таким образом, вы получите уведомление, когда будут обновления словарей, и как только вы решите их установить, TT9 покажет прогресс загрузки. Новые обновления выпускаются не чаще одного раза в месяц, поэтому не беспокойтесь о чрезмерном количестве уведомлений.
+
+Вы можете включить уведомления, перейдя в Настройки → Языки и включив Уведомления о словарях.
+
+_Если вы решите оставить уведомления отключёнными, TT9 продолжит работать без проблем, но вам придётся управлять словарями вручную._
+
+## Горячие клавиши
+
+Все горячие клавиши можно переназначить или отключить в Настройках → Клавиатура → Выбрать Горячие Клавиши.
+
+### Клавиши набора
+
+#### Клавиша Предыдущего предложения (По умолчанию: Влево на D-pad):
+Выбрать предыдущее слово или предложение буквы.
+
+#### Клавиша Следующего предложения (По умолчанию: Вправо на D-pad):
+Выбрать следующее слово или предложение буквы.
+
+#### Клавиша Фильтра предложений (По умолчанию: Вверх на D-pad):
+_Только в режиме Предсказания._
+
+- **Однократное нажатие**: Отфильтровать список предложений, оставив только те, что начинаются с текущего слова. Не имеет значения, является ли оно полным или нет. Например, наберите "remin" и нажмите Фильтр. Будут оставлены все слова, начинающиеся на "remin": "remin", "remind", "reminds", "reminded", "reminding" и так далее.
+- **Двойное нажатие**: Расширить фильтр до полного предложения. Например, наберите "remin" и дважды нажмите Фильтр. Сначала будет отфильтровано по "remin", затем фильтр расширится до "remind". Вы можете продолжать расширять фильтр, пока не достигнете самого длинного слова в словаре.
+
+Фильтрация также полезна при наборе неизвестных слов. Допустим, вы хотите набрать "Anakin", которого нет в словаре. Начните с "A", затем нажмите Фильтр, чтобы скрыть "B" и "C". Теперь нажмите клавишу 6. Поскольку фильтр включён, в дополнение к реальным словам из словаря будут предложены все возможные комбинации для 1+6: "A..." + "m", "n", "o". Выберите "n" и нажмите Фильтр, чтобы подтвердить свой выбор и получить "An". Теперь нажатие клавиши 2 даст "An..." + "a", "b" и "c". Выберите "a" и продолжайте, пока не наберёте "Anakin".
+
+Когда фильтр включён, базовый текст будет выделен жирным курсивом.
+
+#### Клавиша Сброса фильтра (По умолчанию: Вниз на D-pad):
+_Только в режиме Предсказания._
+
+Очистить фильтр предложений, если он применён.
+
+#### Центральная клавиша D-pad (OK или ENTER):
+- Когда отображаются предложения, ввести текущее выбранное предложение.
+- В противном случае, выполнить действие по умолчанию для текущего приложения (например, отправить сообщение, перейти по URL или просто ввести новую строку).
+
+_**Примечание:** Каждое приложение само решает, что делать при нажатии OK, и TT9 не контролирует это._
+
+_**Примечание 2:** В мессенджерах необходимо включить настройку "Отправлять с ENTER" или аналогичную, чтобы отправлять сообщения с OK. Если в приложении нет такой настройки, это обычно означает, что оно не позволяет отправлять сообщения таким образом._
+
+#### Клавиша 0:
+- **В режиме 123:**
+  - **Нажатие:** ввести "0".
+  - **Удержание:** ввести специальные/математические символы.
+  - **Удержание "0", затем нажатие Shift (По умолчанию: удержание "0", нажатие "✱")**: ввести символы валют
+- **В режиме ABC:**
+  - **Нажатие:** ввести пробел, новую строку или специальные/математические символы.
+  - **Удержание:** ввести "0".
+  - **Нажатие "0", затем нажатие Shift (По умолчанию: нажатие "0", "✱")**: ввести символы валют
+- **В режиме Предсказания:**
+  - **Нажатие:** ввести пробел, новую строку или специальные/математические символы.
+  - **Двойное нажатие:** ввести символ, назначенный в настройках режима Предсказания (по умолчанию: ".").
+  - **Удержание:** ввести "0".
+  - **Нажатие "0", затем нажатие Shift (По умолчанию: нажатие "0", "✱")**: ввести символы валют
+
+#### Клавиша 1:
+- **В режиме 123:**
+  - **Нажатие:** ввести "1".
+  - **Удержание:** ввести символы предложения.
+- **В режиме ABC:**
+  - **Нажатие:** ввести символы предложения.
+  - **Удержание:** ввести "1".
+- **В режиме Предсказания:**
+  - **Нажатие:** ввести символы предложения.
+  - **Многократное нажатие:** ввести эмодзи.
+  - **Нажатие 1-1-3:** ввести пользовательские добавленные эмодзи (необходимо добавить их с помощью [Клавиши добавления слова](#клавиша-добавления-слова)).
+  - **Удержание:** ввести "1".
+
+#### Клавиши 2-9:
+- **В режиме 123:** введите соответствующую цифру
+- **В режимах ABC и Предсказания:** введите букву или удерживайте для ввода соответствующей цифры.
+
+### Функциональные клавиши
+
+#### Клавиша добавления слова:
+Добавляет новое слово в словарь текущего языка.
+
+Также можно добавлять новые эмодзи и затем получать к ним доступ, нажав 1-1-3. Независимо от выбранного языка, все эмодзи будут доступны во всех языках.
+
+#### Клавиша удаления (Назад, Del или Backspace):
+Просто удаляет текст.
+
+Если у вашего телефона есть специальная клавиша «Del» или «Clear», вам не нужно настраивать ничего в Настройках, если только вы не хотите иметь ещё одну клавишу Backspace. В этом случае пустая опция: «--» будет выбрана автоматически.
+
+На телефонах с объединённой клавишей «Del»/«Назад», эта клавиша будет выбрана автоматически. Однако вы можете назначить функцию «Backspace» другой клавише, чтобы клавиша «Назад» только возвращала назад.
+
+_**Примечание:** Использование клавиши «Назад» как Backspace не работает во всех приложениях, особенно в Firefox, Spotify и Termux. Эти приложения могут полностью контролировать клавишу и переназначать её функцию по своему усмотрению. К сожалению, ничего с этим нельзя сделать, так как клавиша «Назад» играет особую роль в Android, и её использование ограничено системой._
+
+_**Примечание 2:** Удерживание клавиши «Назад» всегда вызывает действие по умолчанию системы (например, показывает список запущенных приложений)._
+
+_В этих случаях можно назначить другую клавишу (все остальные клавиши полностью функциональны) или использовать экранную клавишу Backspace._
+
+#### Клавиша смены режима ввода (по умолчанию: нажмите #):
+Переключение режимов ввода (abc → Предсказание → 123).
+
+_Предсказание недоступно в полях пароля._
+
+_В полях, где можно вводить только числа, смена режима невозможна. В таких случаях клавиша возвращается к своей стандартной функции (т.е. ввод «#»)._
+
+#### Клавиша редактирования текста:
+Открывает панель редактирования текста, где можно выбрать, вырезать, копировать и вставлять текст. Закрыть панель можно, снова нажав клавишу «✱» или, в большинстве приложений, нажав кнопку «Назад». Подробности доступны [ниже](#редактирование-текста).
+
+#### Клавиша смены языка (по умолчанию: удерживайте #):
+Выбор следующего языка, если несколько языков были включены в Настройках.
+
+#### Клавиша выбора клавиатуры:
+Открывает диалог смены клавиатуры Android, где можно выбрать любую установленную клавиатуру.
+
+#### Клавиша Shift (по умолчанию: нажмите ✱):
+- **При вводе текста:** переключает между строчными и прописными буквами.
+- **При вводе спецсимволов с клавиши 0:** показывает следующую группу символов.
+
+#### Клавиша настроек:
+Открывает экран настроек. Здесь можно выбрать языки для ввода, настроить горячие клавиши клавиатуры, изменить внешний вид приложения или улучшить совместимость с вашим телефоном.
+
+#### Клавиша голосового ввода:
+Активирует голосовой ввод на телефонах, которые его поддерживают. Подробнее см. [ниже](#голосовой-ввод).
+
+#### Клавиша списка команд / также известна как Пульт команд / (по умолчанию: удерживайте ✱):
+Отображает список всех команд (или функций).
+
+У многих телефонов есть только две или три «свободные» клавиши, которые можно использовать как горячие клавиши. Однако в Traditional T9 доступно намного больше функций, что означает, что просто нет места для всех этих функций на клавиатуре. Пульт команд решает эту проблему, позволяя вызывать дополнительные функции (или команды) с помощью комбинаций клавиш.
+
+Ниже приведён список возможных команд:
+- **Показать экран настроек (Комбинация по умолчанию: удерживайте ✱, клавиша 1).** То же, что и нажатие [Настроек](#клавиша-настроек).
+- **Добавить слово (Комбинация по умолчанию: удерживайте ✱, клавиша 2).** То же, что и нажатие [Добавить слово](#клавиша-добавления-слова).
+- **Голосовой ввод (Комбинация по умолчанию: удерживайте ✱, клавиша 3).** То же, что и нажатие [Голосовой ввод](#клавиша-голосового-ввода).
+- **Редактирование текста (Комбинация по умолчанию: удерживайте ✱, клавиша 5).** То же, что и нажатие [Редактирование текста](#клавиша-редактирования-текста).
+- **Выбрать другую клавиатуру (Комбинация по умолчанию: удерживайте ✱, клавиша 8).** То же, что и нажатие [Выбор клавиатуры](#клавиша-выбора-клавиатуры).
+
+_Эта клавиша не выполняет никаких функций, если макет экрана установлен на «Виртуальная клавиатура», так как все клавиши для всех возможных функций уже доступны на экране._
+
+## Голосовой ввод
+Функция голосового ввода позволяет вводить текст с помощью речи, подобно Gboard. Как и все другие клавиатуры, Traditional T9 не распознает речь самостоятельно, а просит телефон сделать это.
+
+_Кнопка голосового ввода скрыта на устройствах, которые не поддерживают эту функцию._
+
+### Поддерживаемые устройства
+На устройствах с Google Services будет использоваться инфраструктура Google Cloud для преобразования ваших слов в текст. Чтобы этот метод работал, необходимо подключиться к Wi-Fi или включить мобильные данные.
+
+На устройствах без Google, если на устройстве есть приложение голосового помощника или родная клавиатура поддерживает голосовой ввод, будет использоваться доступное средство распознавания речи. Следует отметить, что этот метод значительно уступает Google. Он не работает в шумной обстановке и обычно распознает только простые фразы, такие как: «открыть календарь» или «включить музыку» и подобное. Преимущество в том, что он работает в оффлайн-режиме.
+
+Другие телефоны без Google обычно не поддерживают голосовой ввод. Китайские телефоны не имеют функций распознавания речи из-за политики безопасности Китая. На этих устройствах возможно включение поддержки голосового ввода путём установки приложения Google с именем пакета: «com.google.android.googlequicksearchbox».
+
+## Экранная клавиатура
+На телефонах с только сенсорным экраном доступна полностью функциональная экранная клавиатура, которая включается автоматически. Если по какой-то причине ваш телефон не был распознан как имеющий сенсорный экран, включите её, перейдя в Настройки → Внешний вид → Макет на экране и выбрав «Виртуальная цифровая клавиатура».
+
+Если у вас есть как сенсорный экран, так и аппаратная клавиатура, и вы хотите освободить больше места на экране, отключите программные клавиши в Настройки → Внешний вид.
+
+Также рекомендуется отключить специальное поведение клавиши «Назад», когда она работает как Backspace. Это полезно только для аппаратной клавиатуры. Обычно это происходит автоматически, но если нет, перейдите в Настройки → Клавиатура → Выбор горячих клавиш → Клавиша Backspace и выберите опцию «--».
+
+### Обзор виртуальных клавиш
+Экранная клавиатура работает так же, как цифровая клавиатура телефона с аппаратными клавишами. Если клавиша выполняет одну функцию, она имеет одну метку (или значок), указывающую на эту функцию. Если клавиша имеет вторую функцию при удерживании, она имеет две маленькие метки (или значка), одну под другой.
+
+Клавиша F4 слева (нижняя клавиша с левой стороны) поддерживает дополнительные функции с использованием жестов. Проведите по ней горизонтально, чтобы переключиться на последнюю использованную клавиатуру, или проведите вертикально, чтобы открыть диалог выбора клавиатуры и переключиться на другую клавиатуру.
+
+### Изменение размера панели клавиатуры во время набора текста
+В некоторых случаях вы можете заметить, что Виртуальная клавиатура занимает слишком много места на экране, мешая видеть вводимый текст или элементы приложения. В этом случае вы можете изменить её размер, удерживая и перетаскивая клавишу Настройки/Пульт команд или перетаскивая строку состояния (где отображается текущий язык или режим ввода). Когда высота становится слишком маленькой, макет автоматически переключается на «Функциональные клавиши» или «Только список предложений». При увеличении высоты макет переключится на «Виртуальная клавиатура». Также можно дважды нажать на строку состояния для мгновенного минимизирования или максимизирования.
+
+_Изменение размера Traditional T9 также изменяет размер текущего приложения. Оба процесса требуют значительных вычислительных ресурсов. Это может вызвать мерцание или задержки на многих телефонах, даже на более мощных._
+
+### Изменение высоты клавиш
+Также можно изменить высоту экранных клавиш. Для этого перейдите в Настройки → Внешний вид → Высота клавиш на экране и настройте её по своему усмотрению.
+
+Значение по умолчанию 100% является хорошим балансом между размером кнопок и занимаемым экранным пространством. Однако, если у вас большие пальцы, вы можете немного увеличить этот параметр, а если вы используете TT9 на большом экране, например, на планшете, вы можете уменьшить его.
+
+_Если доступное экранное пространство ограничено, TT9 проигнорирует этот параметр и автоматически уменьшит высоту, чтобы оставить достаточно места для текущего приложения._
+
+## Редактирование текста
+В панели редактирования текста вы можете выделять, вырезать, копировать и вставлять текст, как это делается на компьютерной клавиатуре. Чтобы выйти из режима редактирования текста, нажмите клавишу «✱» или клавишу Назад (кроме веб-браузеров, Spotify и некоторых других приложений). Или нажмите клавишу букв на экранной клавиатуре.
+
+Ниже приведён список возможных текстовых команд:
+1. Выделить предыдущий символ (аналогично Shift+Left на компьютерной клавиатуре)
+2. Снять выделение
+3. Выделить следующий символ (аналогично Shift+Right)
+4. Выделить предыдущее слово (аналогично Ctrl+Shift+Left)
+5. Выделить всё
+6. Выделить следующее слово (аналогично Ctrl+Shift+Right)
+7. Вырезать
+8. Копировать
+9. Вставить
+
+Для удобства редактирования клавиши Backspace, Пробел и OK также активны.
+
+## Экран настроек
+На экране настроек вы можете выбрать языки для ввода, настроить горячие клавиши клавиатуры, изменить внешний вид приложения или улучшить совместимость с вашим телефоном.
+
+### Как получить доступ к настройкам?
+
+#### Способ 1
+Нажмите на значок приложения Traditional T9.
+
+#### Способ 2 (с использованием сенсорного экрана)
+- Нажмите на текстовое или числовое поле, чтобы активировать TT9.
+- Используйте экранную кнопку шестерёнки.
+
+#### Способ 3 (с использованием физической клавиатуры)
+- Начните ввод текста или цифр в поле, чтобы активировать TT9.
+- Откройте список команд, используя экранную кнопку инструментов или нажав назначенную горячую клавишу [по умолчанию: удерживайте ✱].
+- Нажмите клавишу 2.
+
+### Навигация по настройкам
+Если у вас устройство с аппаратной клавиатурой, есть два способа навигации по настройкам.
+
+1. Используйте клавиши Вверх/Вниз для прокрутки и клавишу OK для открытия или активации опции.
+2. Нажмите клавиши 1-9, чтобы выбрать соответствующую опцию, и нажмите их дважды, чтобы открыть/активировать её. Двойное нажатие сработает, независимо от того, где вы находитесь на экране. Например, даже если вы находитесь вверху, двойное нажатие клавиши 3 активирует третью опцию. Наконец, клавиша 0 — это удобный ярлык для прокрутки до конца, но она не открывает последнюю опцию.
+
+### Языковые настройки
+
+#### Загрузка словаря
+После включения одного или нескольких новых языков необходимо загрузить соответствующие словари для режима предсказания. После загрузки словарь останется в памяти до тех пор, пока вы не воспользуетесь одной из опций удаления. Это означает, что вы можете включать и отключать языки, не загружая их словари каждый раз. Делайте это только один раз, только при первом включении.
+
+Это также означает, что если вам нужно начать использовать язык X, вы можете безопасно отключить все другие языки, загрузить только словарь X (и сэкономить время!), а затем снова включить все языки, которые использовали раньше.
+
+Имейте в виду, что повторная загрузка словаря сбросит популярность предложений до заводских настроек. Однако беспокоиться не стоит. В большинстве случаев вы не заметите значительных изменений в порядке предложений, если не используете часто редкие слова.
+
+#### Автоматическая загрузка словаря
+
+Если вы пропустили или забыли загрузить словарь через экран настроек, это произойдёт автоматически позже, когда вы откроете приложение, в котором можно вводить текст, и переключитесь в режим предсказания. Вас попросят подождать, пока загрузка завершится, и затем вы сможете начать вводить текст.
+
+Если вы удалите один или несколько словарей, они НЕ будут загружаться автоматически. Вам придётся делать это вручную. Автоматически будут загружаться только словари для вновь включённых языков.
+
+#### Удаление словаря
+Если вы перестали использовать языки X или Y, вы можете отключить их и также воспользоваться опцией «Удалить невыбранные», чтобы освободить место на устройстве.
+
+Чтобы удалить все словари, независимо от выбора, используйте опцию «Удалить все».
+
+Во всех случаях ваши добавленные вручную слова будут сохранены и восстановлены после повторной загрузки соответствующего словаря.
+
+#### Добавленные слова
+Опция «Экспорт» позволяет экспортировать все добавленные слова для всех языков, включая добавленные эмодзи, в файл CSV. Затем вы можете использовать этот файл CSV, чтобы улучшить Traditional T9! Перейдите на GitHub и поделитесь словами в [новом issue](https://github.com/sspanak/tt9/issues) или [pull request](https://github.com/sspanak/tt9/issues). После проверки и одобрения они будут включены в следующую версию.
+
+С помощью опции «Импорт» вы можете импортировать ранее экспортированный CSV. Однако есть некоторые ограничения:
+- Можно импортировать только слова, состоящие из букв. Апострофы, дефисы, другие знаки препинания или специальные символы не допускаются.
+- Эмодзи не допускаются.
+- Один CSV-файл может содержать максимум 250 слов.
+- Вы можете импортировать до 1000 слов, что означает, что вы можете импортировать максимум 4 файла по 250 слов. После достижения этого лимита вы всё равно сможете добавлять слова во время ввода.
+
+С помощью опции «Удалить» вы можете искать и удалять опечатки или другие слова, которые вы не хотите сохранять в словаре.
+
+### Параметры совместимости и устранение неполадок
+Для нескольких приложений или устройств возможно включить специальные опции, которые сделают Traditional T9 более совместимым с ними. Эти параметры можно найти в конце каждого экрана настроек в разделе Совместимость.
+
+#### Альтернативный метод прокрутки предложений
+_Раздел: Настройки → Внешний вид._
+
+На некоторых устройствах в режиме предсказания вы можете столкнуться с невозможностью прокрутить список до конца или необходимостью несколько раз прокручивать список туда и обратно, пока не появится последнее предложение. Эта проблема иногда возникает на Android 9 и более ранних версиях. Включите эту опцию, если сталкиваетесь с такой проблемой.
+
+#### Всегда сверху
+_Раздел: Настройки → Внешний вид._
+
+На некоторых телефонах, особенно Sonim XP3plus (XP3900), Traditional T9 может не отображаться, когда вы начинаете вводить текст, или быть частично скрытым за сенсорными клавишами. В других случаях могут появляться белые полосы вокруг него. Проблема может возникать в одном конкретном приложении или во всех. Чтобы предотвратить это, включите опцию «Всегда сверху».
+
+#### Защита от повторных нажатий
+_Раздел: Настройки → Клавиатура._
+
+Телефоны CAT S22 Flip и Qin F21 известны низким качеством клавиатур, которые со временем быстро изнашиваются и начинают регистрировать несколько нажатий за одно нажатие клавиши. Вы можете заметить это при вводе текста или навигации по меню телефона.
+
+Для телефонов CAT рекомендуется установить значение 50-75 мс. Для Qin F21 попробуйте с 20-30 мс. Если проблема сохраняется, немного увеличьте значение, но старайтесь держать его как можно ниже.
+
+_**Примечание:** Чем выше значение, тем медленнее вам придётся набирать текст. TT9 будет игнорировать очень быстрые нажатия клавиш._
+
+_**Примечание 2:** Кроме того, телефоны Qin могут не определять длительные нажатия. К сожалению, в этом случае ничего нельзя сделать._
+
+#### Отправка сообщений с OK в Facebook Messenger
+_Раздел: Настройки → Первоначальная настройка._
+
+Отправка сообщений с помощью клавиши OK в Messenger стала невозможной с июня 2024 года. Недавнее обновление приложения сделало кнопку Отправить недоступной для всех клавиатур. Если у вас есть технические знания и идеи, как снова включить эту функцию, напишите в [эту проблему GitHub](https://github.com/sspanak/tt9/issues/558).
+
+#### Не открываются панели стикеров и эмодзи в Telegram/Snapchat
+Это происходит, если вы используете один из маленьких макетов. В настоящее время нет постоянного решения, но можно воспользоваться следующим обходным путём:
+- Перейдите в Настройки → Внешний вид и включите Экранную цифровую клавиатуру.
+- Вернитесь в чат и нажмите кнопку эмодзи или стикеров. Они теперь появятся.
+- Теперь вы можете вернуться в настройки и отключить экранную цифровую клавиатуру. Панели стикеров и эмодзи останутся доступными, пока вы не перезапустите приложение или телефон.
+
+#### Traditional T9 не появляется сразу в некоторых приложениях
+Если вы открыли приложение, где можно вводить текст, но TT9 не появляется автоматически, просто начните вводить, и он появится. Альтернативно, нажатие горячих клавиш для смены [режима ввода](#клавиша-смены-режима-ввода-по-умолчанию-нажмите) или [языка](#клавиша-смены-языка-по-умолчанию-удерживайте) также может вызвать TT9, если он скрыт.
+
+На некоторых устройствах TT9 может оставаться невидимым, что бы вы ни делали. В таких случаях вам придётся включить [Всегда сверху](#всегда-сверху).
+
+**Длинное объяснение.** Проблема заключается в том, что Android в основном предназначен для устройств с сенсорным экраном. Поэтому он ожидает, что вы коснётесь текстового/числового поля, чтобы отобразить клавиатуру. Можно настроить TT9 так, чтобы он появлялся без этого подтверждения, но в некоторых случаях Android забудет скрыть его, когда это необходимо. Например, он может остаться видимым после того, как вы набрали номер телефона или отправили текст в поисковом поле.
+
+По этим причинам, чтобы соответствовать стандартам Android, управление остаётся в ваших руках. Просто нажмите клавишу, чтобы "коснуться" экрана и продолжайте ввод текста.
+
+#### На Qin F21 Pro удерживание клавиши 2 или 8 увеличивает или уменьшает громкость вместо набора числа
+Чтобы решить эту проблему, перейдите в Настройки → Внешний вид и включите «Значок состояния». TT9 должен автоматически обнаружить Qin F21 и включить настройки, но если автоопределение не сработало или вы отключили значок по какой-либо причине, вам необходимо включить его, чтобы все клавиши работали корректно.
+
+**Длинное объяснение.** Qin F21 Pro (и, возможно, F22) имеет приложение горячих клавиш, которое позволяет назначать функции увеличения и уменьшения громкости на цифровые клавиши. По умолчанию менеджер горячих клавиш включён, и удерживание клавиши 2 увеличивает громкость, удерживание клавиши 8 — уменьшает. Однако, когда нет значка состояния, менеджер предполагает, что клавиатура не активна, и регулирует громкость, вместо того чтобы позволить Traditional T9 обрабатывать клавиши для набора чисел. Поэтому включение значка обходит менеджер горячих клавиш, и всё работает нормально.
+
+#### Общие проблемы на телефонах Xiaomi
+Xiaomi ввела несколько нестандартных разрешений на своих телефонах, которые мешают корректной работе виртуальной экранной клавиатуры Traditional T9. Точнее, клавиши «Показать настройки» и «Добавить слово» могут не выполнять свои функции. Чтобы исправить это, необходимо предоставить TT9 разрешения «Отображать всплывающее окно» и «Отображать всплывающее окно в фоновом режиме» в настройках вашего телефона. [Этот гид](https://parental-control.flashget.com/how-to-enable-display-pop-up-windows-while-running-in-the-background-on-flashget-kids-on-xiaomi) для другого приложения объясняет, как это сделать.
+
+Также настоятельно рекомендуется предоставить разрешение «Постоянное уведомление». Это похоже на разрешение «Уведомления», добавленное в Android 13. См. [выше](#примечания-для-android-13-или-выше), чтобы узнать, почему это необходимо.
+
+_Проблемы с Xiaomi обсуждаются в [этом issue GitHub](https://github.com/sspanak/tt9/issues/490)._
+
+#### Голосовой ввод долго не завершается
+Это [известная проблема](https://issuetracker.google.com/issues/158198432) на Android 10, которую Google так и не исправил. Устранить её на стороне TT9 невозможно. Чтобы завершить голосовой ввод, оставайтесь молчаливыми несколько секунд. Android автоматически отключает микрофон, когда не может обнаружить речь.
+
+#### Мне нужно использовать раскладку QWERTY (только сенсорные устройства)
+Traditional T9 — это клавиатура типа T9, и, соответственно, она не предоставляет раскладку, похожую на QWERTY.
+
+Если вы всё ещё учитесь использовать T9 и вам нужно иногда переключаться, или вам удобнее вводить новые слова с помощью QWERTY, проведите по клавише Left F4, чтобы переключиться на другую клавиатуру. См. [обзор виртуальных клавиш](#обзор-виртуальных-клавиш) для получения дополнительной информации.
+
+Большинство других клавиатур позволяет переключиться обратно на Traditional T9, удерживая пробел или клавишу «смены языка». Подробнее см. в соответствующем руководстве или инструкции.
diff --git a/docs/user-manual.md b/docs/user-manual.md
deleted file mode 100644
index 655e8f1a..00000000
--- a/docs/user-manual.md
+++ /dev/null
@@ -1,335 +0,0 @@
-# Traditional T9
-This manual explains how to configure and use Traditional T9 in different scenarios. For installation instructions and information about the "lite" and "full" versions, please consult the [Installation Guide](https://github.com/sspanak/tt9/blob/master/docs/installation.md) on GitHub. Finally, you may want to check out the [main repository page](https://github.com/sspanak/tt9), which includes all source code, a developer's guide, the privacy policy, and supplementary documentation.
-
-## Initial Setup
-After installing, first, you need to enable Traditional T9 as an Android keyboard. To do so, click on the launcher icon. If you need to take any action, all options besides Initial Setup will be disabled, and there will be a label: "TT9 is disabled". Go to Initial Setup and enable it.
-
-_If you don't see the icon right after installing, restart your phone, and it should appear. It is due to Android trying to save some battery life by not refreshing the newly installed apps list._
-
-### Using on a touchscreen-only phone
-On touchscreen devices, it is also highly recommended to disable the system spell checker. It can not be used when typing with the number keys, so you can save some battery life by disabling it.
-
-Another problem is, that it may show a confusing "Add Word" popup dialog, which adds words to the default system keyboard (usually, Gboard) and not to Traditional T9's dictionary. Again, to avoid such situations, the system spell checker must be disabled.
-
-If you need to perform this step, the "System Spell Checker" item on the Initial Setup screen will be active. Click it to disable the system component. If you there is no such item, then you don't need to do anything else.
-
-After you are done with the setup, check out the [On-screen Keypad section](#on-screen-keypad) for more tips and tricks.
-
-### Enabling Predictive Mode
-Predictive Mode requires a language dictionary to be loaded to provide word suggestions. You can toggle the enabled languages and load their dictionaries from Settings Screen → [Languages](#language-options). In case, you have forgotten to load some dictionary, Traditional T9 will do it for you automatically when you start typing. For more information, [see below](#language-options).
-
-#### Notes for low-end phones
-Dictionary loading may saturate low-end phones. When using the TT9 "lite" version, this will cause Android to abort the operation. If loading takes more than 30 seconds, plug in the charger or ensure the screen stays on during loading.
-
-You can avoid the above by using the "full" version instead.
-
-#### Notes for Android 13 or higher
-By default, the notifications for newly installed apps are disabled. It is recommended to enable them. This way you will get notified when there are dictionary updates, and once you choose to install them, TT9 will show the loading progress. New updates are released at most once a month, so you don't have to worry about getting too much spam.
-
-You can enable the notifications by going to Settings → Languages and toggling Dictionary Notifications.
-
-_If you decide to keep them off, TT9 will continue to work without problems, but you will have to manage the dictionaries manually._
-
-## Hotkeys
-
-All hotkeys can be reconfigured or disabled from Settings → Keypad → Select Hotkeys.
-
-### Typing Keys
-
-#### Previous Suggestion key (Default: D-pad Left):
-Select the previous word/letter suggestion.
-
-#### Next Suggestion key (Default: D-pad Right):
-Select the next word/letter suggestion.
-
-#### Filter Suggestions key (Default: D-pad Up):
-_Predictive mode only._
-
-- **Single press**: Filter the suggestion list, leaving out only the ones that start with the current word. It doesn't matter if it is a complete word or not. For example, type "remin" and press Filter. It will leave out all words starting with "remin": "remin" itself, "remind", "reminds", "reminded", "reminding", and so on.
-- **Double press**: Expand the filter to the full suggestion. For example, type "remin" and press Filter twice. It will first filter by "remin", then expand the filter to "remind". You can keep expanding the filter until you get to the longest dictionary word.
-
-Filtering is also useful for typing unknown words. Let's say you want to type "Anakin", which is not in the dictionary. Start with "A", then press Filter to hide "B" and "C". Now press 6-key. Since the filter is on, in addition to the real dictionary words, it will provide all possible combinations for 1+6: "A..." + "m", "n", "o". Select "n" and press Filter to confirm your selection and produce "An". Now pressing the 2-key, will provide "An..." + "a", "b", and "c". Select "a", and keep going, until you get "Anakin".
-
-When filtering is enabled, the base text will become bold and italicized.
-
-#### Clear Filter key (Default: D-pad Down):
-_Predictive mode only._
-
-Clear the suggestion filter, if applied.
-
-#### D-pad Center (OK or ENTER):
-- When suggestions are displayed, type the currently selected suggestion.
-- Otherwise, perform the default action for the current application (e.g. send a message, go to a URL, or just type a new line).
-
-_**Note:** Every application decides on its own what to do when OK is pressed and TT9 has no control over this._
-
-_**Note 2:** In messaging applications, you need to enable their "Send with ENTER" or similarly named setting, to send messages with OK. If the application has no such setting, it usually means it disallows sending messages this way._
-
-#### 0-key:
-- **In 123 mode:**
-  - **Press:** type "0".
-  - **Hold:** type special/math characters.
-  - **Hold "0", then press Shift (Default: hold "0", press "✱"):** type currency characters
-- **In ABC mode:**
-  - **Press:** type space, newline, or special/math characters.
-  - **Hold:** type "0".
-  - **Press "0", then press Shift (Default: press "0", "✱"):** type currency characters
-- **In Predictive mode:**
-  - **Press:** type space, newline, or special/math characters.
-  - **Double press:** type the character assigned in Predictive mode settings. (Default: ".")
-  - **Hold:** type "0".
-  - **Press "0", then press Shift (Default: press "0", "✱"):** type currency characters
-
-#### 1-key:
-- **In 123 mode:**
-  - **Press:** type "1".
-  - **Hold:** type sentence characters
-- **In ABC mode:**
-  - **Press:** type sentence characters
-  - **Hold:** type "1".
-- **In Predictive mode:**
-  - **Press:** type sentence characters
-  - **Press multiple times:** type emoji
-  - **Press 1-1-3:** type custom added emoji (you must have added some using [the Add Word key](#add-word-key))
-  - **Hold:** type "1".
-
-
-#### 2- to 9-key:
-- **In 123 mode:** type the respective number
-- **In ABC and Predictive mode:** type a letter or hold to type the respective number.
-
-### Function Keys
-
-#### Add Word Key:
-Add a new word to the dictionary for the current language.
-
-You can also add new emojis and then access them by pressing 1-1-3. Regardless of the currently selected language, all emojis will be available in all languages.
-
-#### Backspace Key (Back, Del, or Backspace):
-Just deletes text.
-
-If your phone has a dedicated "Del" or "Clear" key, you do not need to set anything in the Settings, unless you want to have another Backspace. In this case, the blank option: "--" will be automatically preselected.
-
-On phones which have a combined "Delete"/"Back", that key will be selected automatically. However, you can assign the "Backspace" function to another key, so "Back" will only navigate back.
-
-_**NB:** Using "Back" as backspace does not work in all applications, most notably Firefox, Spotify, and Termux. They can take full control of the key and redefine its function, meaning it will do whatever the app authors intended. Unfortunately, nothing can be done, because "Back" plays a special role in Android and its usage is restricted by the system._
-
-_**NB 2:** Holding the "Back" key will always trigger the default system action (i.e. show the running applications list)._
-
-_In these cases, you could assign another key (all other keys are fully usable), or use the on-screen backspace._
-
-#### Next Input Mode Key (Default: press #):
-Cycle the input modes (abc → Predictive → 123).
-
-_Predictive mode is not available in password fields._
-
-_In number-only fields, changing the mode is not possible. In such cases, the key reverts to its default function (i.e. type "#")._
-
-#### Edit Text Key:
-Show the text editing panel, which allows you to select, cut, copy, and paste text. You can close the panel by pressing the "✱" key again or, in most applications, by pressing the Back button. Details are available [below](#text-editing).
-
-#### Next Language Key (Default: hold #):
-Select the next language, when multiple languages have been enabled from the Settings.
-
-#### Select Keyboard Key:
-Open the Android Change Keyboard dialog where you can select between all installed keyboards.
-
-#### Shift Key (Default: press ✱):
-- **When typing text:** Toggle between uppercase and lowercase.
-- **When typing special characters with the 0-key**: Display the next character group.
-
-#### Show Settings Key:
-Open the Settings configuration screen. It is where you can choose languages for typing, configure the keypad hotkeys, change the application appearance, or improve compatibility with your phone.
-
-#### Voice Input Key:
-Activate the voice input on the phones that support it. See [below](#voice-input) for more info.
-
-#### Command-List Key / aka Command Palette / (Default: hold ✱):
-Show a list of all commands (or functions).
-
-Many phones have only two or three "free" buttons that can be used as hotkeys. But, Traditional T9 has many more functions, meaning there is simply no room for all of them on the keypad. The Command Palette resolves this problem. It allows invoking the additional functions (or commands) using key combos.
-
-Below is a list of the possible commands:
-- **Show the Settings Screen (Default Combo: hold ✱, 1-key).** Same as pressing [Show Settings](#show-settings-key).
-- **Add a Word (Default Combo: hold ✱, 2-key).** Same as pressing [Add Word](#add-word-key).
-- **Voice Input (Default Combo: hold ✱, 3-key).** Same as pressing [Voice Input](#voice-input-key).
-- **Edit Text (Default Combo: hold ✱, 5-key).** Same as pressing [Edit Text](#edit-text-key)
-- **Select a Different Keyboard (Default Combo: hold ✱, 8-key).** Same as pressing [Select Keyboard](#select-keyboard-key).
-
-_This key does not do anything when the Screen Layout is set to "Virtual Keypad" because all keys for all possible functions are already available on the screen._
-
-## Voice Input
-The voice input function allows for speech-to-text input, similar to Gboard. Like all other keyboards, Traditional T9 does not perform speech recognition by itself, but it asks your phone to do it.
-
-_The Voice Input button is hidden on devices that do not support it._
-
-### Supported Devices
-On devices with Google Services, it will use the Google Cloud infrastructure to convert your words to text. You must connect to a Wi-Fi network or enable mobile data for this method to work.
-
-On devices without Google, if the device has a voice assistant app or the native keyboard supports voice input, whichever is available will be used for speech recognition. Note that this method is considerably less capable than Google. It will not work in a noisy environment and will usually recognize only simple phrases, such as: "open calendar" or "play music" and similar. The advantage is that it will work offline.
-
-Other phones without Google will generally not support voice input. Chinese phones do not have speech recognition capabilities due to Chinese security policies. On these phones, it may be possible to enable voice input support by installing the Google application, package name: "com.google.android.googlequicksearchbox".
-
-## On-screen Keypad
-On touchscreen-only phones, a fully functional on-screen keypad is available and it will be enabled automatically. If, for some reason, your phone was not detected to have a touchscreen, enable it by going to Settings → Appearance → On-Screen Layout, and selecting "Virtual Numpad".
-
-If you do have both a touchscreen and a hardware keypad and prefer having more screen space, disable the software keys from Settings → Appearance.
-
-It is also recommended to disable the special behavior of the "Back" key working as "Backspace". It is useful only for a hardware keypad. Usually, it will happen automatically too, but if it does not, go to Settings → Keypad → Select Hotkeys → Backspace key, then select the "--" option.
-
-### Virtual Keys Overview
-The on-screen keypad works the same as the numpad of a phone with hardware keys. If a key provides a single function, it has one label (or icon) indicating that function. And if the key provides a secondary "hold" function, it has two smaller labels (or icons), one below the other.
-
-The Left F4 key (the bottom one on the left-hand side) supports extra functions using swiping. Swipe horizontally to switch to the last used keyboard or swipe vertically to display the keyboard selection dialog and switch to a different keyboard.
-
-### Resizing the Keyboard Panel While Typing
-In some cases, you may find that the Virtual Keypad is taking up too much screen space, preventing you from seeing what you are typing or some application elements. If so, you can resize it by either holding and dragging the Settings/Command Palette key or by dragging the Status Bar (it is where the current language or typing mode is displayed). When the height becomes too small, the layout will automatically be switched to "Function keys" or "Suggestion list only". Respectively, when resizing up, the layout will change to "Virtual Keypad". You can also double-tap the status bar to minimize or maximize instantly.
-
-_Resizing Traditional T9 also results in resizing the current application. Doing both is computationally very expensive. It may cause flickering or stuttering on many phones, even higher-end ones._
-
-### Changing the Key Height
-It is also possible to change the on-screen key height. To do so, go to Settings → Appearance → On-screen Key Height and adjust it as desired.
-
-The default setting of 100% is a good balance between usable button size and screen space taken. However, if you have large fingers, you may want to increase the setting a bit, while if you use TT9 on a larger screen, like a tablet, you may want to decrease it.
-
-_If the available screen space is limited, TT9 will ignore this setting and reduce its height automatically, to leave enough room for the current application._
-
-## Text Editing
-From the Text Editing panel, you can select, cut, copy, and paste text, similar to what is possible with a computer keyboard. To exit Text Editing, press the "✱" key, or the Back key (except in web browsers, Spotify, and a few more applications). Or press the letters key on the On-screen Keyboard.
-
-Below is a list of the possible text commands:
-1. Select the previous character (like Shift+Left on a computer keyboard)
-2. Select none
-3. Select the next character (like Shift+Right)
-4. Select the previous word (like Ctrl+Shift+Left)
-5. Select all
-6. Select the next word (like Ctrl+Shift+Right)
-7. Cut
-8. Copy
-9. Paste
-
-For easier editing, backspace, space, and OK keys are also active.
-
-## Settings Screen
-On the Settings screen, you can choose languages for typing, configure the keypad hotkeys, change the application appearance, or improve compatibility with your phone.
-
-### How to access the Settings?
-
-#### Method 1
-Click on the Traditional T9 launcher icon.
-
-#### Method 2 (using a touchscreen)
-- Tap on a text or a number field to wake up TT9.
-- Use the on-screen gear button.
-
-#### Method 3 (using a physical keyboard)
-- Start typing in a text or a number field to wake up TT9.
-- Open the commands list using the on-screen tools button or by pressing the assigned hotkey [Default: Hold ✱].
-- Press the 2-key.
-
-### Navigating Around the Settings
-If you have a device with a hardware keypad, there are two ways of navigating around the Settings.
-
-1. Use the Up/Down keys for scrolling and OK for opening or activating an option.
-2. Press the 1-9 keys to select the respective option and double-press them to open/activate it. Double-pressing will work no matter where you are on the screen. For example, even if you are at the top double-pressing the 3-key will activate the third option. Finally, the 0-key is a convenient shortcut for scrolling to the end but does not open the last option.
-
-### Language Options
-
-#### Loading a Dictionary
-After enabling one or more new languages, you must load the respective dictionaries for Predictive Mode. Once a dictionary is loaded, it will stay there until you use one of the "delete" options. This means you can enable and disable languages without reloading their dictionaries every time. Just do it once, only the first time.
-
-It also means that if you need to start using language X, you can safely disable all other languages, load only dictionary X (and save time!), and then re-enable all languages you used before.
-
-Have in mind reloading a dictionary will reset the suggestion popularity to the factory defaults. However, there should be nothing to worry about. For the most part, you will see little to no difference in the suggestion order, unless you often use uncommon words.
-
-#### Automatic Dictionary Loading
-
-If you skip or forget to load a dictionary from the Settings screen, it will happen automatically later, when you go to an application where you can type, and switch to Predictive Mode. You will be prompted to wait until it completes and after that, you can start typing right away.
-
-If you delete one or more dictionaries, they will NOT reload automatically. You will have to do so manually. Only dictionaries for newly enabled languages will load automatically.
-
-#### Deleting a Dictionary
-If you have stopped using languages X or Y, you could disable them and also use "Delete Unselected", to free some storage space.
-
-To delete everything, regardless of the selection, use "Delete All".
-
-In all cases, your custom-added words will be preserved and restored once you reload the respective dictionary.
-
-#### Added Words
-The "Export" option allows you to export all added words, for all languages, including any added emoji, to a CSV file. Then, you can use the CSV file to make Traditional T9 better! Go to GitHub and share the words in a [new issue](https://github.com/sspanak/tt9/issues) or [pull request](https://github.com/sspanak/tt9/issues). After being reviewed and approved, they will be included in the next version.
-
-With "Import", you can import a previously exported CSV. However, there are some restrictions:
-- You can import only words consisting of letters. Apostrophes, dashes, other punctuation, or special characters are not allowed.
-- Emojis are not allowed.
-- One CSV file can contain a maximum of 250 words.
-- You can import up to 1000 words, meaning you can import at most 4 files X 250 words. Beyond that limit, you can still add words while typing.
-
-Using "Delete", you can search for and delete misspelled words or others that you don't want in the dictionary.
-
-### Compatibility Options & Troubleshooting
-For several applications or devices, it is possible to enable special options, which will make Traditional T9 work better with them. You can find them at the end of each settings screen, under the Compatibility section.
-
-#### Alternative suggestion scrolling method
-_In: Settings → Appearance._
-
-On some devices, in Predictive Mode, you may not be able may not be able to scroll the list to the end, or you may need to scroll backward and forward several times until the last suggestion appears. The problem occurs sometimes on Android 9 or earlier. Enable the option, if you are experiencing this issue.
-
-
-#### Always on top
-_In: Settings → Appearance._
-
-On some phones, especially Sonim XP3plus (XP3900), Traditional T9 may not appear when you start to type, or it may be partially covered by the soft keys. In other cases, there may be white bars around it. The problem may occur in one particular application or all of them. To prevent it, enable the "Always on Top" option.
-
-#### Key repeat protection
-_In: Settings → Keypad._
-
-CAT S22 Flip and Qin F21 phones are known for their low-quality keypads, which degrade quickly over time and start registering multiple clicks for a single key press. You may notice this when typing or navigating the phone menus.
-
-For CAT phones the recommended setting is 50-75 ms. For Qin F21, try with 20-30 ms. If you are still experiencing the issue, increase the value a bit, but generally try to keep it as low as possible.
-
-
-_**Note:** The higher the value you set, the slower you will have to type. TT9 will ignore very quick key presses._
-
-_**Note 2:** Besides the above, Qin phones may also fail to detect long presses. Unfortunately, in this case, nothing can be done._
-
-#### Send messages with OK in Facebook Messenger
-_In: Settings → Initial Setup._
-
-Sending with OK in Messenger has been no longer possible since the June 2024 update. The recent app redesign caused the Send button to become unreachable for all keyboards. If you have technical knowledge and an idea of how to re-enable this feature, please write in [this GitHub issue](https://github.com/sspanak/tt9/issues/558).
-
-#### Telegram/Snapchat stickers and emoji panels won't open
-This happens if you are using one of the small-sized layouts. Currently, there is no permanent fix, but you can use the following workaround:
-- Go to Settings → Appearance and enable On-Screen Numpad.
-- Go back to the chat and click the emoji or the stickers button. They will now appear.
-- You can now go back to the settings and disable the on-screen numpad. The emoji and sticker panels will remain accessible until you restart the app or the phone.
-
-#### Traditional T9 does not appear immediately in some applications
-If you have opened an application where you can type, but TT9 does not appear automatically, just start typing and it will. Alternatively, pressing the hotkeys to change [the input mode](#next-input-mode-key-default-press-) or the [language](#next-language-key-default-hold-) can also bring up TT9, when it is hidden.
-
-On some devices, TT9 may remain invisible, no matter what you do. In such cases, you have to enable [Always on Top](#always-on-top).
-
-**Long explanation.** The reason for this problem is Android is primarily designed for touchscreen devices. Hence, it expects you to touch the text/number field to show the keyboard. It is possible to make TT9 appear without this confirmation, but then, in some cases, Android will forget to hide it when it must. For example, it may remain visible after you have dialed a phone number or after you have submitted text in a search field.
-
-For these reasons, to stick with the expected Android standards, the control is in your hands. Just press a key to "touch" the screen and keep typing.
-
-#### On the Qin F21 Pro, holding 2-key or 8-key turns up or down the volume instead of typing a number
-To mitigate this problem, go to Settings → Appearance, and enable "Status Icon". TT9 should detect Qin F21 and enable the settings automatically, but in case auto-detection fails, or you have disabled the icon for some reason, you need to have it enabled, for all keys to work properly.
-
-**Long explanation.** Qin F21 Pro (and possibly F22, too), has a hotkey application that allows assigning Volume Up and Volume Down functions to number keys. By default, the hotkey manager is enabled, and holding 2-key increases the volume, holding 8-key decreases it. However, when there is no status icon, the manager assumes no keyboard is active and adjusts the volume, instead of letting Traditional T9 handle the key and type a number. So, enabling the icon just bypasses the hotkey manager and everything works fine.
-
-#### General problems on Xiaomi phones
-Xiaomi has introduced several non-standard permissions on their phones, which prevent Traditional T9's virtual on-screen keyboard from working properly. More precisely, the "Show Settings" and the "Add Word" keys may not perform their respective functions. To fix this, you must grant the "Display pop-up window" and "Display pop-up window while running in the background" permissions to TT9 from your phone's settings. [This guide](https://parental-control.flashget.com/how-to-enable-display-pop-up-windows-while-running-in-the-background-on-flashget-kids-on-xiaomi) for another application explains how to do it.
-
-It is also highly recommended to grant the "Permanent notification" permission. This is similar to the "Notifications" permission introduced in Android 13. See [above](#notes-for-android-13-or-higher) for more information on why you need it.
-
-_The Xiaomi problems have been discussed in [this GitHub issue](https://github.com/sspanak/tt9/issues/490)._
-
-#### Voice Input takes a very long time to stop
-It is [a known problem](https://issuetracker.google.com/issues/158198432) on Android 10 that Google never fixed. It is not possible to mitigate it on the TT9 side. To stop the Voice Input operation, stay quiet for a couple of seconds. Android turns off the microphone automatically when it can not detect any speech.
-
-#### I need to use a QWERTY layout (touchscreen devices only)
-Traditional T9 is a T9 keyboard and as such, it does not provide a QWERTY-like layout.
-
-If you are still learning to use T9 and need to switch back occasionally, or you find it more convenient to type new words using QWERTY, swipe the Left F4 key to switch to a different keyboard. See the [virtual keys overview](#virtual-keys-overview) for more information.
-
-Most other keyboards allow switching back to Traditional T9 by holding the spacebar or the "change language" key. Check the respective readme or manual for more info.
\ No newline at end of file
diff --git a/docs/user-manual.md b/docs/user-manual.md
new file mode 120000
index 00000000..9d57a964
--- /dev/null
+++ b/docs/user-manual.md
@@ -0,0 +1 @@
+./help/help.en.md
\ No newline at end of file