-
Notifications
You must be signed in to change notification settings - Fork 348
Localizing, translate RosarioSIS with Poedit
Once RosarioSIS is installed on your computer.
- Check existing translations:
locale/REFERENCE.md
-
Download and install Poedit.
-
Open Poedit and click Create new translation.
-
Open the
rosariosis.po
file of an existing translation under thelocale/
folder, or therosariosis.pot
file in thelocale/en_US.utf8/LC_MESSAGES/
folder. -
Select the language for your translation.
-
Save the new
rosariosis.po
translation file under thelocale/
folder. You should create 2 sub-folders following this template (example for Spanish translation):locale/es_ES.utf8/LC_MESSAGES/rosariosis.po
-
You can start translating.
Note: the bubble icon on the left side of a string indicates there is a Comment, generally containing the context or meaning of the original string.
Please consider these rules when translating: RosarioSIS contains education related vocabulary. Please try to always translate a term the same way. For example, in spanish, grade could be translated to nota or calificación. Please choose one of the two terms to keep consistency. Also, please leave HTML tags (<b></b> <i></i> <BR />
), PHP variables ($variable
) and type specifiers (decimal number %d
, string %s
) untouched!
Once your translation is ready, to have the flag of your translation show up on the login screen:
- Add the locale name to the
config.inc.php
file (es_ES.utf8 is the folder containing the Spanish translation):
$RosarioLocales = array('en_US.utf8', 'es_ES.utf8');
- Add your country flag image to the
locale/
folder:
locale/es_ES.utf8/flag.png
You will find more flags here: http://www.customicondesign.com/free-icons/flag-icon-set/all-in-one-country-flag-icon-set/
The English help texts, contained in the Help_en.php
file can be translated too. Open the help.pot
file or an existing help.po
file in your locale/
folder with Poedit.
The inline help should now display help texts in your language. Please keep HTML tags untouched (<p></p> <i></i>
).
Once your translation is ready, you can share it to the RosarioSIS community.
-
Check you have the latest RosarioSIS version installed: https://gitlab.com/francoisjacquet/rosariosis/releases
-
New strings may have been added. After upgrading RosarioSIS, Update your translation with Poedit and translate new strings.
-
Send your files (
rosariosis.po
,rosariosis.mo
, flag image) along with the locale code to https://www.rosariosis.org/ or open a Merge Request on GitLab.