ModMii Translation Instructions
===============================


BASIC IMPORTANT INFO
====================
First, download the latest english version of ModMii, either use the ModMii installer or download it from here:
http://code.google.com/p/modmii/downloads/list?can=3&q=&colspec=Filename+Summary+Uploaded+ReleaseDate+Size+DownloadCount

Open support\ModMii.bat file in notepad or some other text editor and you can start translating.


Please only translate the text that come after the word "echo", and also leave any redirects (">") alone. Also be sure to leave any variables alone (ie. %variable%).

Here's an example:
echo * Desired firmware is %FIRM%%REGIONCHANGE%>>"%Drive%"\%guidename%

so after it's translated it looks something like:
echo * le firmware souhaite est %FIRM%%REGIONCHANGE%>>"%Drive%"\%guidename%


Also note that to use special characters or colours use "sfk echo", in these cases be sure not to change "[colour]" or "sfk echo -spat" or "\x##" where ## is any number in hex.

Here's an example:
sfk echo -spat \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 [Red] THIS SOFTWARE IS NOT FOR SALE.

so after it's translated it looks something like:
sfk echo -spat \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 \x20 [Red] ESTE PROGRAMA NO ESTA EN VENTA.


HOW TO GET SPECIAL CHARACTERS TO SHOW UP PROPERLY IN A COMMAND WINDOW
=====================================================================
Here's how to get accents and special characters to display in a command window properly:
( note:  = f1 )

Instead of:
echo Espaiol

Use the following command:
support\sfk echo -spat Espa\xf1iol

Basically just replace the special letter with \x##, where ## is some hex code; for example, if ## is "20" then it will output a space " ", or if ## is "3a" then it will output a colon ":". Not all hex codes are supported by sfk, but I'm pretty sure all the 2 digit hex codes will work. Take a look at this webpage: http://www.addressmunger.com/hex_ascii_tables/

If you figure this out and can get all sorts accents to appear properly in ModMii, it will mean you'll need to replace many "echo" commands with "support\sfk echo -spat" commands.

Note that multiple spaces in a "sfk echo" commands will not appear properly, to get around this add many spaced with \x20
For example:
echo How to Fix Lots of Spaces               in Spanish

so after it's translated it looks something like:
support\sfk echo -spat How to Fix Lots of Spaces \x20 \x20 \x20 \x20 \x20 \x20 \x20 in Espa\xf1iol

As you are translating, please run ModMii so you can make sure all the translated text is centered and fits on the page properly.


BATCH SCRIPTS TO HELP WITH YOUR TRANSLATION
===========================================
I recently built some batch script to help translating ModMii, it's important to understand all of the above before using these scripts

First save all the scripts (ie. Translator_1.bat, Translator_2.bat, Translator_3.bat) to ModMii's support folder (or where ModMii.exe is will also work).

Then run Translator_1.bat


It will number the lines and filter only the lines that you need to translate
(it may miss a few other things that need to be translated but not much, it will probably only miss things like "set somevariable=SomeEnglishText")


Open ModMii_TranslateMe.txt and translate it. You still need to be careful to leave commands, variables and redirects alone (ie. %variable% and "<"). But you can actually use special characters like "" and you can also use multiple spaces (ie "           "). You also do not need to worry about changing "echo" commands to "sfk echo -spat". ModMii will convert that for you in a later step.

You can delete lines that do no need to be translated from ModMii_TranslateMe.txt. For example if you don't want to change a line from the English version just delete the entire line from ModMii_TranslateMe.txt.

When you are done translating ModMii_TranslateMe.txt, run Translator_2.bat.
This could take a long time, and it may error on a few lines when replacing very very very long strings. Make a note of those line #'s that reported errors (just scroll through the cmd line log output after it's finished running).

What this is doing is replacing all special characters (like "") and multiple spaces with \x##. It also replaces all "echo" commands to "sfk echo -spat" commands where appropriate.

Open "ModMii_special_modded.txt" and "ModMii_standard_modded.txt" and manually replace lines that were not replaced in the previous step (ie. the lines that errored). Just manually copy and paste the problem lines into "ModMii_Translation_Numbered.txt" replacing the old line numbers.


Then run Translator_3.bat
This creates ModMii_Translation.bat by removing all the line numbers from "ModMii_Translation_Numbered.txt". At this point you should have a rough translation of ModMii that works when running it. You will have to run it and make sure everything is translated properly and centered. You may need to split one line into two if it doesn't fit all on one line for example.



OTHER FILES THAT MUST BE TRANSLATED
===================================
There are a few other files that you need to translate:

the first one u can just download from here:
http://code.google.com/p/nusad/downloads/list?can=3&q=NUSAutoUpdate&colspec=Filename+Summary+Uploaded+ReleaseDate+Size+DownloadCount

rename it from *.txt to *.bat, then u will be able to test it to make sure it translates properly
You don't need to translate any of the changelog items prior to the first version of the language you are translating (for example, if you are making a Greek translation of v5.0.0 then you don't need to translate the v5.0.0 changelog or lower)

and for the 2nd one you'll need to download the ModMii Installer from here:
http://modmii.googlecode.com/files/ModMii%20Installer.exe

Open a command window where the installer is saved and type
"ModMii Installer.exe" decompiler

If u have trouble using the cmd window to do that, save the above code in a text file, then rename it anything.bat and run it then you will be able to save the source and supporting installer files to a new folder. Then translate the "ModMii Installer.bat" file.


Note that if you like using the Translator_X.bat files to assist in your translation, you can use them to translate the installer and update batch files. To do that, you should rename the original support\ModMii.bat, then rename the installer\update batch file to ModMii.bat and save it to ModMii's support folder. So basically save the new little batch file you want to translate to support\ModMii.bat, then when you're finished using the Translator_X.bat files rename the "ModMii_Translation.bat" file back to "ModMii Installer.bat" or "NUSAutoUpdate-#.#.#.bat" depending on what it is you're translating.



UPDATING GUIDE *.001 FILES
==========================
look inside ModMii's Support\Guide\ folder, inside it are a bunch of *.001 files containing html code. Open those files in notepad and translate them, make sure to leave tags alone (ie. <br>). It should be very simple to translate these files because it's ok to use accents and special characters directly in the files (ie. "").

Also note that the guide building section near the end of modmii.bat has a lot of support\sfk echo commands that are redirected to the custom html guides. So there are a lot of \x## commands that need to be left alone (ie. do not change things like "\x3c", "\x3e", "\x22", etc.)



UPDATING AN EXISTING TRANSLATION
================================
Okay, I only have one more thing to say. If you've already translated ModMii once and you just want to update the version of your translation you can benefit from this webpage:

http://code.google.com/p/modmii/source/diff?spec=svn25&old=30&r=32&format=side&path=%2Ftrunk%2FModMii+English%2FModMii.bat

You may need to change the version #'s displayed depending on what version you are updating from\to.

It will identify all the changes in the english version of ModMii. It will highlight sections that have been added\removed\changed.

Just apply all the changes to old already translated version of ModMii.bat and translate any "echo" or "sfk echo" lines.

So basically u can think of the translation as having 2 steps, step one is to get all the code from the latest english version of ModMii added to the old translated version, and the second step is to translate it all the new\changed echo commands that still need to be translated.




When you finish your translation, send it to me to check and so I can put it online. (I'll be sure to add your name to the credits too)

Let me know if you have any questions and need help. And if for whatever reason you can't finish this, please let me know asap so I can try to find someone else to work on it.

Thanks a lot for offering to take on a ModMii translation! It's gonna be a lot of work, but the people that speak your language will love you for it.

XFlak