Last updated on 31 July 2023
It happens that you come across a spoken message in an app and think, “Oh, if only this message was expressed differently,” or you feel that the name of a certain option or feature should be different. fortunately, with Jieshuo screen reader, this is possible.
A few months ago, Jieshuo introduced a feature that allows users to modify app’s translation strings according to their liking. And recently, it added the ability to share those modifications with Jieshuo servers for other users to find and download.
Table of Contents
Using custom translations:
To be able to use translation edits, follow these steps: Go to Jieshuo settings > advanced settings > language settings, and then check the “use custom translation” option.editing translation strings:
In the language settings, you’ll find a list of all available translation strings. Each string contains the translation key or original text, along with the default translation or the Chinese name if the string has not been added to the default translation yet. The translation key represents the identifier associated with the string, while the default translation provides the translated version of the text.
To edit a string, double-tap on it. This will allow you to clear the translation text and enter the desired text or make changes according to your preference. Once you’re done, tap “OK” to save the modifications, or tap “Cancel” to go back without making any changes. Keeping the translation text empty means that the default translation text will be used. Remember to tap “Save” when you’re done with all your modifications; otherwise, you will lose your edits if you go back without saving.
When a new string is added by the developer, it appears at the end of the list. To reach quickly the end of the translation strings list tap “more options,” then “to end.”
In the original string content, there are clues related to the function of the feature or option. The original string and the translation string provide hints about the type of string the user is dealing with. Here are some examples:
- Title: Usually used for option names, setting sections, feature titles, and modes.
- Summary: Provides short explanations for options and features.
- Message: Refers to the spoken messages of Jieshuo, such as the messages announcing the suspension and resuming of features.
- Command: refers to a function contained in the list of functions found in the main menu, which can be assigned to gestures and added to auto clicks, preceded by the “%” sign. (Some commands may not be in this list, but they can be still work with autoclicks).
- Voice cmd: Relates to Jieshuo’s voice assistant settings and voice commands.
- Sound: the names of the events that are included in the sound schemes.
- Default: Refers to default actions assigned to some gestures and volume key presses.
- %d or %s (or both) in the translated string represents certain information and how it should be spoken. For example, the battery level, charging state, number of lines or characters, uppercase letter sorting, and others.
To search for a specific text in the translation strings, tap on “enter keyword,” then type the text that you want to search for. Tap on “Next result” to move to the next available result and “previous result” to move to the previous one.
Importing and exporting strings:
Importing custom translation files
To import a translation modifications file created by someone else, follow these steps: In language settings, tap on “More options,” then select “Import.” Jieshuo will scan and find all available files. You can place the file inside Jieshuo resources where Jieshuo already exports your strings.
Jieshuo will provide you with the paths and names of available files. Double-tap a file to start the import process. After that, you will see a message explaining that you can choose to overwrite or merge the modifications, and recommending that you export your modifications first to avoid losing them. Also you will find a list of all the edits included in the file.
If you select “overwrite,” the previous modifications will be replaced with the newly imported file, and any changes you made will be lost. If you choose “merge,” the new imported file will be combined with the old modifications. Any old modifications not changed in the new file will be kept, and new modifications will be added. In case of conflicts between modifications in the two versions, the new one will take effect. You can tap “Cancel” to go back without importing.
Exporting:
In “More options” also, you have the option to export your modifications. They will be saved in the resources folder in Jieshuo’s main folder.
Uploading/downloading translations:
uploading to the server
It is now possible to upload your modifications to the Jieshuo servers. From “More options,” tap on “Share.” You will see a text box where you can type a description or comment about the shared strings. Tap “OK” to share.
Downloading shared translations:
In “More options,” you will also find the option to download. It will take you to a new section that contains translations. You can search and navigate the list. When you double-tap a translation, you can see the comments about the translation. Tap “comment” to add your own comment. Tap “Download” to download the file. The downloaded file will be saved to the downloads folder in Jieshuo’s main folder. Then, you will be asked if you want to import it, with the same dialogue and options presented in the import section.
Notes:
1. Some edits may not take effect until you restart Jieshuo or even force stop and relaunch it.
2. When you change a command, you need to reassign the gestures based on the new name if you have assigned a gesture to it or if it is the default text assigned to a gesture in the strings.
3. When downloading translations from others, it is advisable to download from trusted sources or review the changes to ensure the quality of the translation.
4. To return to the default strings and delete all the custom modifications, select “Default” from “More options” in the language settings, and then tap “OK.”
Comments