Translating WISE

Introduction

WISE supports translations of the user-management system and the learning environment. Projects can also be authored and offered in different languages.

The following components are translatable:

• WISE-Portal: Includes user management, project library, classroom run management, admin tools
• Virtual Learning Environment (WISE-VLE): Includes student project environment and the authoring tool
• WISE step types: Includes tools like Open Response, Multiple Choice, Drawing, etc.
• WISE themes: Includes WISE main theme and WISE star map theme.
• Projects (authored content): Using the Authoring Tool (which is part of the VLE), curriculum authors can create projects in their own language.

Translate WISE5

You'll be translating directly on GitHub, where we host our code.

1. Go to http://github.com and sign up for a new account.

2. Find the file that you'll be translating from the "Translation Files" list section below. Each of these links will list all the languages. You'll want to edit the file i18n_LOCALE.json, where LOCALE is your language. (es=spanish, ja=japanese, zh_CN=simplified chinese, zh_TW=traditional chinese, etc). Click on the link to view the file.

In this example, we'll be translating the Open Response component in Japanese.

3. Click on the "Edit this file" icon (a pencil icon). This will open the edit page view.

4. Translate by editing the strings on the right side of the colon (":").

5. When you are done, or want to take a break, save your work by scrolling to the bottom of the page and click con "Commit Changes". You can keep the fields selected by default. This will save your changes.

6. Repeat for other tools and components.

Translation Files

Tools

• VLE: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/vle/i18n
• Classroom Monitor: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/classroomMonitor/i18n
• Authoring Tool: VLE: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/authoringTool/i18n

Components

• Audio Oscillator: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/audioOscillator/i18n
• Concept Map: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/conceptMap/i18n
• Discussion: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/discussion/i18n
• Draw: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/draw/i18n
• Embedded: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/embedded/i18n
• Graph: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/graph/i18n
• HTML: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/html/i18n
• Label: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/label/i18n
• Match: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/match/i18n
• Multiple Choice: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/multipleChoice/i18n
• Open Response: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/openResponse/i18n
• Outside URL: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/outsideURL/i18n
• Table: https://github.com/WISE-Community/WISE/tree/master/src/main/webapp/wise5/components/table/i18n

Translate Portal, VLE, Themes, Steps

The WISE Translation Form is a simple web form that you can use to translate WISE. Thanks for your help!

To get started, follow these steps:

1. Go to http://wise5.org/translate

2. Type in your name and email address. Use your real name&email address, and choose the language. If you do not see the language that you want to translate, write to the developer list (http://groups.google.com/group/wise-dev) or email us at telsportal at gmail dot com.

3. Once you enter the site, you will see links to the various parts of WISE that you can translate. We recommend that you translate in this order: VLE->Themes->Steps->Portal.

4. Start translating. If you encounter problems or questions, email us.

5. As you translate, remember to hit the "save" button often. This will save your translations on our server, and also email them to you for backup. A dialog will also appear with the contents of the translation file. You can copy and paste this into a local file for backup!

6. When you are done, press "Save", then the "I am done" button. This will notify us, and we will review and add your translations to the future releases of WISE.

7. If you have your own instance of WISE and want to update your WISE instance with your translations immediately, click on the download button (next to the project name in the main page or in the translation page), save them in the appropriate location, then restart WISE.

Where to save the translation files:

• VLE: tomcat_wise_dir/vle/view/i18n/
• Themes: tomcat_wise_dir/vle/themes/[starmap,wise]/i18n/
• Steps: tomcat_wise_dir/vle/node/[assessmentlist,brainstorm,...]/i18n/
• Portal: tomcat_wise_dir/WISE-INF/classes/i18n/

Translate WISE Projects (curriculum)

To translate the WISE curriculum, you want to do the following:

1. Log into WISE with a teacher account and go to "Browse WISE Projects". This will list the main WISE projects.

2. Pick a project that you want to translate and copy it by clicking on the "Copy" link in the project listing. This will make a copy of the project and add it to your own project library.

3. Find the copied project in your project library. There should be an "Edit" link next to it. Click it, and this will launch the WISE Authoring Tool.

4. Use the Authoring Tool to translate each step to your language. As you translate, you can click on the "Preview Project" button in the upper-right corner of the Authoring Tool to preview the project.