[WG: I18N & L10N] How to i18n sakai tools

[高珺]

Hi David,

     Well, in Fudan University, we have tried a lot to translate Sakai 
to Chinese. The most annoying i18n issues are roles' names and email.

     As you know, after the initial audo-ddl, some roles like 
Instructor, Teaching Assistent, Student, Maintain, Access would be 
created automatically. And these strings would be shown in the Site Info 
tool and the privilege page of many other tools. These role names are 
stored in database, and can not be shown in other languages.
     I think it's better to add some properties to a shared properties 
file to solve this issue.

For example:
role.instructor=Instructor
role.teaching_assistent=Teaching Assistent
role.student=Student

     When role name is displayed on a page, Sakai may first find it in 
the properties file for key role.ROLE_NAME("all to lower case and 
replace "space" by "_" for comptibility, like "role.teaching_assistent" 
for "Teaching Assistent"), if the key in missing, then show the role 
name in the database (for customized role).
     I once planned to do these things in our code this winter, but it 
would be much better if the i18n team could give a guide line or a 
principle of where to put the properties file and how the tools read them.


     And next is the email. Sakai is combined by many tools, and the 
tools were contributed by many people. The methods to send emails are 
different from each other,  and unfortunately many tools didn't put i18n 
in their consideration. When an email is sent in non-latin language, it 
would be unreadable. We have to disable the email function in our 
school. The Email Template Service is a good start, but it's not enough 
yet. Is there any plan or roadmap to make all the tools be sent email by 
Email Template Service?

>                 Hi all,
>
> Miguel Carro from Samoo and me are reviewing i18n at Sakai trunk and 
> have found some basic bad practices, like hardcoding strings 
> (https://source.sakaiproject.org/svn/site-manage/trunk/site-manage-tool/tool/src/webapp/vm/sitesetup/chef_site-siteInfo-list.vm). 
> I would like to encourage you to ask at i18n list if you have problems 
> with i18n. For us, it will be a pleasure to help you or guide you in 
> dealing with that kind of issues. Anyway, to help the community to 
> deal with this we created i18n School at Confluence, which can be 
> found at https://confluence.sakaiproject.org/display/I18N/i18n+School, 
> where you’ll find short and practical tutorials about how to fix this 
> kind of problems. Of course, contributions/suggestions/whatever will 
> be welcome. Just let us know.
>
>                 Thank you very much in advance.
>
>                 Best,
>
> Dr. David Roldán Martínez
>
> Universitat Politècnica de València, Spain
>
> Sakai CLE QA lead for Internationalization
>
> 	
>
>
>
> _______________________________________________
> i18n mailing list
> i18n at collab.sakaiproject.org
> http://collab.sakaiproject.org/mailman/listinfo/i18n
>
> TO UNSUBSCRIBE: send email to i18n-unsubscribe at collab.sakaiproject.org with a subject of "unsubscribe"


-- 
Gao Jun
Fudan University
China

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://collab.sakaiproject.org/pipermail/i18n/attachments/20120104/371b4bb8/attachment-0001.html 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/jpeg
Size: 2897 bytes
Desc: not available
Url : http://collab.sakaiproject.org/pipermail/i18n/attachments/20120104/371b4bb8/attachment-0002.jpe 
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/jpeg
Size: 6962 bytes
Desc: not available
Url : http://collab.sakaiproject.org/pipermail/i18n/attachments/20120104/371b4bb8/attachment-0003.jpe