Picture of sander van zijl
localisation test
by sander van zijl - Thursday, 22 December 2016, 3:56 PM
 

The framework now supports localisation. Because this feature is really needed, I was trying to look into the possibilities.

Thomas berger says it is possible to construct the course in the authoring tool and then add localisation to it.
http://blog.learnchamp.com/en/course-localisation-made-easy-with-adapt-learning

So now I want to know how to do this.

first problem: where is the course located? in which folder do i need to run the grunt commands? The
"course/en"  folder I found did not have the config.json.

Or: does someone know the steps to create the translation files from a course created in the authoring tool, and to import them again into the course?

 

 

 

Picture of Thomas Berger
Re: localisation test
by Thomas Berger - Wednesday, 28 December 2016, 9:05 AM
 

Hello Sander,

thanks for testing the ML features in Adapt.

What I mentioned in the Blog was that you can create the base structure in the authoring tool (A,B,C) BUT you will need the Framework to bundle multiple languages into a multilanguage course.

The workflow for the Framework is described here: https://github.com/adaptlearning/adapt_framework/wiki/Course-Localisation

If you need to create multi language courses, we recommend to do this in the Framework directly.

However, if you prefer to use the Authoringtool for this, a possible workflow that combines the Authoringtool and the Framework (Version 2.0.14) would look like this:

In the Authoring Tool (make sure the used Framework is at least Version 2.0.14)

  • Create your master course
  • Add the Language Picker extension
  • In "Configuration Settings" you can customize the behavior and add the languages you would like to support. For instance, to support German add "de" as Language Code and "Deutsch" as Language Name. Text direction would be ltr.
  • Create a new course for each additional language you would like to support. Now you would localize the content inside the Tool.
  • Once you are done, export your master course using the "Export Source code" option
  • Download all the other courses

Framework:

Now that you created your master course, included the language picker plugin and created the localized versions you will need to combine all this into one package.

  • Unzip the exported source code of your master course and the localized versions
  • For each localized course you need to copy the course data into the master course
    • Navigate to "pathToGerman/course"
    • in here you will find a folder called "en"
    • rename this folder to the language code you defined in the Authoringtool ("de")
    • copy the folder into "pathToMaster/src/course"
  • Once you are done, navigate with the cmd to the "pathToMaster" directory and execute grunt build
  • You should now have a course containing all the languages you added previously and you should be able to use the language picker to switch languages inside a course.

 

This process is just a work around until the Authoringtool is able to bundle multiple courses into one build. Once this feature is shipped, you will be able to do all this entirely in the Authoringtool. This feature is on the roadmap and will be available in upcoming versions.

 

Hope this was useful,

Thomas