https://github.com/aternus/mymiui-hd2-i18n
myMIUI Internationalization Project
https://github.com/aternus/mymiui-hd2-i18n
Last synced: about 1 year ago
JSON representation
myMIUI Internationalization Project
- Host: GitHub
- URL: https://github.com/aternus/mymiui-hd2-i18n
- Owner: Aternus
- Created: 2012-10-01T17:07:04.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2013-01-15T19:32:08.000Z (over 13 years ago)
- Last Synced: 2025-04-01T08:22:04.692Z (over 1 year ago)
- Language: JavaScript
- Homepage: http://forum.xda-developers.com/showthread.php?t=1639932
- Size: 34.6 MB
- Stars: 1
- Watchers: 2
- Forks: 22
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# myMIUI APK & Framework i18n
## Available Languages
* English
* Chinese
* Danish by larsmew
## Missing Languages
* Greek
* Spanish
* Polish
* Portuguese
* Hebrew
* Dutch
* Russian
* German
* Italian
* Turkish
* Norwegian
* French
* Arabic/Farsi
* Hungarian
* Korean
* Slovenian
* Vietnamese
## How to Translate
GitHub is used for the management of myMIUI i18n Project.
Git is a Distributed Version Control System that allows collaboration on the languages translation process with ease.
### Step 1 - Installing Git & Creating a GitHub account
[Learning how to use Git & GitHub](http://gitimmersion.com/)
### Step 2 - Forking myMIUI-HD2-i18n
In GitHub, on the [original myMIUI-HD2-i18n project page](https://github.com/Aternus/myMIUI-HD2-i18n) __click "Fork"__, then follow the wizard.
If you need more help on how to Fork a project, [click here](https://help.github.com/articles/fork-a-repo).
### Step 3 - Setting your environment (Linux/Cygwin/GitBash)
__Replace any occurences of username with your username.__
#### Make a working directory & Clone the forked REPO
```
cd /
git clone https://github.com/username/myMIUI-HD2-i18n.git
cd myMIUI-HD2-i18n
```
#### Add the remote source REPO of myMIUI-HD2-i18n
```
git remote add source https://github.com/Aternus/myMIUI-HD2-i18n.git
```
### Step 4 - File Structure
```
/_aroma_langs - myMIUI AROMA Installer Language Files
/_mymiui_apk - myMIUI APK Language Files
/_mymiui_framework - myMIUI Framework Language Files
/_sources_crowdin - Crowdin Translated Sources as seen in MIUI 2.4.20
/_sources_MIUI - MIUI Sources as seen in MIUI 2.4.20
```
### Step 5a - Translating - Core Concepts
In order to perform translations there are coupld core concepts you'll have to understand:
* Inside every APK there is a __"res"__ folder which includes all the resources from that APK.
* The folders inside the __"res"__ folder is structured as follows: __resourcetype__-__lc__-r__RC__
```
resourcetype - Resource Type
lc - ISO Language Code (xx)
RC - ISO Region Code (XX)
```
__NOTE:__ [Supported Languages and Regions in Android](http://colincooper.net/blog/2011/02/17/android-supported-language-and-locales/). Region is optional.
* __The resources loading priority is as follows:__
```
[APK values-iw-rIL] > [APK values-iw] > [APK values] > [framework-res.apk values-iw-rIL] > [framework-res.apk values-iw] > [framework-res.apk values]
```
* __The following resource types should be translated:__
```
values
drawable
raw
```
* Framework-res.apk is an APK with the __MAIN__ resources for the whole myMIUI ROM.
If a resource is missing from the APK, the OS will try to load it from framework-res.apk.
### Step 5b - Translating APKs
Now that you understand the basic concept of translations for Android, we can get to work.
Inside __/_mymiui_apk__ & __/_mymiui_framework__ you will find the folders with the names of the APK files, inside each of these should reside a __"res"__ folder.
Inside is the __"res"__ folder most of the folders required for the translation have already been created,
__if not__, please create the folder according to __your language and region__.
In general, to translate the APK you'll need to edit the files residing inside the folder with the __resource type__ of __"values"__.
Although rare, but at times you'll be required to translate __"raw"__ and __"drawable"__ resource types.
Its best to look at an already translated APK for more information and better understanding.
### Step 6 - Saving Changes & Commiting
After you've finished making the required changes, you'll have to add the changed files to the staging index and commit the changes to the repository.
```
git add .
git commit -m "Message describing what you've changed"
```
### Step 7 - Pushing (Uploading) your changes to GitHub & Sharing your changes
After you've finished your working session, its a good idea to share your work with others on your GitHub REPO.
```
git push origin master
```
Now that you have the new commits on GitHub its time to open your GitHub account and make a __"Pull Request"__ to the source myMIUI REPO.
After getting your request, I will review the changes and merge them to the __myMIUI-HD2-i18n source REPO__.
### Step 8 - Being up-to-date with myMIUI-HD2-i18n source REPO
An important concept to grasp with Git is that it's a distributed version control system,
which means you are responsible to stay up to date with what happens with the __source REPO__.
Before working on any files, I strongly suggest pulling the latest changes from the source REPO.
```
git pull source master
```
## Credits
Credits to the original guide on [Learning how to Translate MIUI](https://docs.google.com/document/d/1H8DoN6nnbsOGB_fauBiCcpyB4OAIEHjqEiJX322v45Y/edit).
#####################################################################
.
# myMIUI AROMA Installer i18n
## Available Languages
* English - by aternus
* Greek - by jolas, zach.antre
* Spanish - by darkdyo
* Polish - by kubekpop
* Portuguese - by fadox
* Hebrew - by aternus
* Dutch - by uloga
* Russian - by sergey, aternus
* German - by waldemator
* Italian - by saint tropez
* Turkish - by metra01
* Danish - by pokeman
* Norwegian - by arvter
* French - by patrick lesimple
## Missing Languages
* Arabic/Farsi
* Hungarian
* Korean
* Slovenian
* Vietnamese
## How to Translate
__NOTE:__ The full list of locales is available at __/_aroma_langs__, you should use "en.lang" as the source file.
Translate all strings which appear to the __right__ to the equal sign (=)
Example:
text_next=Next __becomes__ text_next=Next_in_your_language
__NOTES:__
* In the string, there might be styling and new line characters.
* A new line character is represented by a backslash (\).
* Styling characters are similar to HTML/XML tags. They begin with a and end with a (where tag is the actual styling attribute).
* You don't need to translate the styling characters!
* You don't need to alter the new line characters!