Projects/Edu/Artikulate/LanguageCourses: Difference between revisions

From KDE TechBase
< Projects‎ | Edu‎ | Artikulate
(Add introduction, rename titles)
(Remove "under construction" marker)
 
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Construction}}
This article explains how to create and work on courses. The explained concepts follow the [[../CourseMaterial|course life cycle]] and we refer to technical terms from that description. For creating courses or working at existing ones Artikulate must be configured to [[../BuildAndInstall|work on a course repository]]. If that is done, you can open Artikulate and use the internal course editor as explained in the following.


This article explains how to create and work on courses. The explained concepts follow the [[../CourseMaterial|course life cycle]] and we refer to technical terms from that description. For creating courses or working at existing ones Artikulate must be configured to [[../BuildAndInstall|work on a course repository]]. If that is done, you can open Artikulate and use the internal course editor as explained in the following.
== Create a Course ==
There are two possible ways how to create courses:
* create a course independent of a skeleton
* create a course from a skeleton
When creating a course from a skeleton, usually one wants to maintain a course prototype (=skeleton) that than is used to provide courses for different languages.
 
=== Course from Skeleton ===
 
==== The Basic Course Skeleton ====
Currently, the Artikulate team uses a special course skeleton (called "basic course skeleton") to coordinate creation of basic language courses. The basic course skeleton contains units prototypes and phrases for the topics
* Numbers
* Alphabet
* Tourism
* Family
* Sport
* Entertainment
* Clothing
* At the supermarket
* At the doctor's
* Time and Dates
* Weather
* Countries and Cultures
* At the restaurant
* In a Zoo
* Pets
* At a Job Interview
* At a bank
* During an Emergency
The goal is to cover basic vocabulary from different areas that are important when learning a new language.
 
==== Create the Course ====
[[File:Lang courses.png]]
In order to create a new language course, open the course editor (the top-left tool button). Then you have to perform the following steps:
# The slide bar with two options will appear and you need to choose “Edit courses” option.
# The list of supported languages will appear (as shown on the screenshot above). Choose the language you want to create a new language course for.
# Then click on “New course”and you will see a new popup window appearing. Select the appropriate language and the course skeleton for which you would like to create a language course and click OK. (If the language that you would like to add a course for is not supported yet, you will need to create a language phonology first (see below).
# Now, you need to select “New Course” that should appear.
# The next step it to synchronize the language course with the skeleton. In order to do it you need to choose "Update from Course Prototype".
After this you should see the course with the phrases in English as they are in skeleton. Save your changes by pressing OK button at the top of the screen. You can see that now all the phrases are in English and they are tagged as "unknown". This means that they still need to be translated into appropriate language.
 
==== Translate Course Phrases ====
Once you have created a new language course and updated it with course skeleton you can start translating your phrases.
#  Go to the dialog "Course editor" (top-left button) and the choose “Edit courses” option.
#  Choose a language for which you would like to do translation and the appropriate course.
#  You should see a list of units on the left side of your screen.
#  Choose one of the units to see the phrases associated with it.
#  To edit a phrase open it and replace existing English phrase with a translation.
#  Once you are done change the status of the phrase to translated. Sometimes you will also need to change the type of the phrase e.g. from word to expression, etc.
#  Accept your changes to this phrase by clicking the accept button on the right side of the phrase.
 
You can now proceed with editing other phrases. Remember to save all changes to the course  by pressing the "OK" button at the top menu bar.
[[File:Course unit.png]]
 
=== Create Course Independent of Skeleton ===
In order to create a new language course independent of skeleton you need to follow the intructions below.
# Open the course editor (the top-left tool button) and choose “Edit courses” option.
# The list of supported languages will appear. Choose the language you want to create a new language course for.
# Then click on “New course” and you will see a new popup window appearing. Choose a name for the course, select the appropriate language, fill in the identifier and click OK.
# Now, you will see your new course in the list.
# You can edit the course content by adding new units ("New Unit" button in the course)  and phrases ("New phrase" button within the unit).


== Create a New Course ==
When you are done with the course creation save your changes by pressing OK button at the top of the screen.  
=== New Language Course from a Course Skeleton===
In order to create a new language course from the course skeleton you need go to the dialog "Course editor" (top-left button). The slide bar with two options will appear and you need to choose “Edit courses” option. The list of supported languages will appear. Choose the language you want to create a new language course for. Then click on “New course”and you will see a new box appearing. Select appropriate language and the course skeleton for which you would like to create a language course and click OK. (If the language that you would like to add a course for is not supported yet, you will need to create a language phonology first. (add link). Now you need to select “New Course” that should appear. The next step it to synchronize the language course with the skeleton. In order to do it you need to choose “Update from Course Prototype”. After this you should see the course with the phrases in English as they are in skeleton. Save your changes by pressing OK button at the top of the screen. You can see that now all the phrases are in English and they are tagged as “unknown” This means that they still need to be translated into appropriate language.


=== Translating phrases to a language ===
== Add Recordings ==
Once you have created a new language course and updated it with course skeleton you can start translating your phrases. In order to do it you need to go to the dialog "Course editor" (top-left button) and the choose “Edit courses” option. Choose a language for which you would like to do translation and the appropriate course. If there is no language courses available yet, you will need to create one yourself as explained “In creating a new language course from course skeleton option”. Otherwise you should see a list of units on the left side of your screen. Choose one of the units to see the phrases associated with it. If the phrase is still in English, you can do a translation. Simply click on the icon on the left side on the phrase which will open an editing box. Delete the English phrase and type an equivalent in appropriate language. Once you done change the status of the phrase to translated. Sometimes you will also need to change the type of the phrase e.g. from word to expression, etc. When you finished with the phrase click a tick box next to it to indicate you are finished with this phrase. You can now translate more phrases but you must save your changes before closing the program.
To add the recordings you need to follow similar instructions as for translations.
# Open Artikulate and go to the dialog "Course editor" (top-left button) and the choose “Edit courses” option.
# Choose a language for which you would like to do recordings for and the appropriate course.  
# Open one of the units and you will be able to see a list of phrases associated with it.  
#  In order to record a phrase expand it and use the record button in “Create New Recording” section.
#  After you are finished you can listen to what you have recorded by pressing the play button.  
#  If you like the recording choose “Replace existing recording” option or otherwise record yourself again.  
# When you done with the phrase, change its status to “Completed” and close the phrase by clicking the accept button next to it.  


=== Adding recordings for phrases ===
You can now do more recordings but you will need to save your changes before exiting the program by choosing the OK button on the top of the screen.
To add the recordings you need to follow the same instructions as for translations. Therefore open Artikulate and go to the dialog "Course editor" (top-left button) and the choose “Edit courses” option.  Choose a language for which you would like to do recordings for and the appropriate course. You can record the phrases that are already translated (they should be in blue color). In order to record a phrase expand it by clicking on the icon on its right. You should be able to see  “Create New Recording” section. In order to record the phrase press the record button next to it, say the phrase, and then press the record button again to finish the recording. Now you can listen to what you have recorded by pressing the play button. If you like the recording choose “Replace existing recording” option or otherwise record yourself again. When you done with the phrase, change its status to “Completed” (meaning the phrase is now both translated and recorded) and close the phrase by clicking the tick button next to it. You can now do more recordings but you will need to save your changes before exiting the program. You can do it choosing the OK button on the top of the screen.
[[File:Phrase_edit.png]]


=== Tagging phonemes for phrases ===
=== Tagging phonemes for phrases ===
TODO / MISSING
To tag phonemes you need to follow similar instructions as for translations and recordings.
# Open Artikulate and go to the dialog "Course editor" (top-left button) and the choose “Edit courses” option. 
# Choose a language for which you would like to tag phonemes, appropriate course and unit.
# You will be able to see a list of phrases associated with a unit you have just opened.
# To tag a phrase open it and at the bottom of the page you will see numerous buttons with phonemes associated with a language you are editing.
# Choose phonemes that the phrase consists of. For example English word "cat" consists of three phonemes 'k','æ' and 't'.
# When you tagged all the phonemes for a phrase accept changes by clicking the accept button.
 
You can tag more phrases but you will need to save your changes before exiting the program (OK button on the top of the screen).


== Create a New Language Specification (Phonology) ==
== Create a Language Specification (Phonology) ==
Artikulate uses language specifications (called "phonology") that define lists of available phonemes for a language. In short, a phoneme is a natural sound of a language. (For a detailed explanation see e.g. [http://en.wikipedia.org/wiki/Phoneme].) We need such a phonology for every language to be able to tag phrases by the sounds that are specific to this language. Using phoneme tags for phrases enables users to select specific phonemes that they want to improve and hence allows a more focused training.
Artikulate uses language specifications (called "phonology") that define lists of available phonemes for a language. In short, a phoneme is a natural sound of a language. (For a detailed explanation see e.g. [http://en.wikipedia.org/wiki/Phoneme].) We need such a phonology for every language to be able to tag phrases by the sounds that are specific to this language. Using phoneme tags for phrases enables users to select specific phonemes that they want to improve and hence allows a more focused training.



Latest revision as of 16:24, 12 July 2013

This article explains how to create and work on courses. The explained concepts follow the course life cycle and we refer to technical terms from that description. For creating courses or working at existing ones Artikulate must be configured to work on a course repository. If that is done, you can open Artikulate and use the internal course editor as explained in the following.

Create a Course

There are two possible ways how to create courses:

  • create a course independent of a skeleton
  • create a course from a skeleton

When creating a course from a skeleton, usually one wants to maintain a course prototype (=skeleton) that than is used to provide courses for different languages.

Course from Skeleton

The Basic Course Skeleton

Currently, the Artikulate team uses a special course skeleton (called "basic course skeleton") to coordinate creation of basic language courses. The basic course skeleton contains units prototypes and phrases for the topics

  • Numbers
  • Alphabet
  • Tourism
  • Family
  • Sport
  • Entertainment
  • Clothing
  • At the supermarket
  • At the doctor's
  • Time and Dates
  • Weather
  • Countries and Cultures
  • At the restaurant
  • In a Zoo
  • Pets
  • At a Job Interview
  • At a bank
  • During an Emergency

The goal is to cover basic vocabulary from different areas that are important when learning a new language.

Create the Course

In order to create a new language course, open the course editor (the top-left tool button). Then you have to perform the following steps:

  1. The slide bar with two options will appear and you need to choose “Edit courses” option.
  2. The list of supported languages will appear (as shown on the screenshot above). Choose the language you want to create a new language course for.
  3. Then click on “New course”and you will see a new popup window appearing. Select the appropriate language and the course skeleton for which you would like to create a language course and click OK. (If the language that you would like to add a course for is not supported yet, you will need to create a language phonology first (see below).
  4. Now, you need to select “New Course” that should appear.
  5. The next step it to synchronize the language course with the skeleton. In order to do it you need to choose "Update from Course Prototype".

After this you should see the course with the phrases in English as they are in skeleton. Save your changes by pressing OK button at the top of the screen. You can see that now all the phrases are in English and they are tagged as "unknown". This means that they still need to be translated into appropriate language.

Translate Course Phrases

Once you have created a new language course and updated it with course skeleton you can start translating your phrases.

  1. Go to the dialog "Course editor" (top-left button) and the choose “Edit courses” option.
  2. Choose a language for which you would like to do translation and the appropriate course.
  3. You should see a list of units on the left side of your screen.
  4. Choose one of the units to see the phrases associated with it.
  5. To edit a phrase open it and replace existing English phrase with a translation.
  6. Once you are done change the status of the phrase to translated. Sometimes you will also need to change the type of the phrase e.g. from word to expression, etc.
  7. Accept your changes to this phrase by clicking the accept button on the right side of the phrase.

You can now proceed with editing other phrases. Remember to save all changes to the course by pressing the "OK" button at the top menu bar.

Create Course Independent of Skeleton

In order to create a new language course independent of skeleton you need to follow the intructions below.

  1. Open the course editor (the top-left tool button) and choose “Edit courses” option.
  2. The list of supported languages will appear. Choose the language you want to create a new language course for.
  3. Then click on “New course” and you will see a new popup window appearing. Choose a name for the course, select the appropriate language, fill in the identifier and click OK.
  4. Now, you will see your new course in the list.
  5. You can edit the course content by adding new units ("New Unit" button in the course) and phrases ("New phrase" button within the unit).

When you are done with the course creation save your changes by pressing OK button at the top of the screen.

Add Recordings

To add the recordings you need to follow similar instructions as for translations.

  1. Open Artikulate and go to the dialog "Course editor" (top-left button) and the choose “Edit courses” option.
  2. Choose a language for which you would like to do recordings for and the appropriate course.
  3. Open one of the units and you will be able to see a list of phrases associated with it.
  4. In order to record a phrase expand it and use the record button in “Create New Recording” section.
  5. After you are finished you can listen to what you have recorded by pressing the play button.
  6. If you like the recording choose “Replace existing recording” option or otherwise record yourself again.
  7. When you done with the phrase, change its status to “Completed” and close the phrase by clicking the accept button next to it.

You can now do more recordings but you will need to save your changes before exiting the program by choosing the OK button on the top of the screen.

Tagging phonemes for phrases

To tag phonemes you need to follow similar instructions as for translations and recordings.

  1. Open Artikulate and go to the dialog "Course editor" (top-left button) and the choose “Edit courses” option.
  2. Choose a language for which you would like to tag phonemes, appropriate course and unit.
  3. You will be able to see a list of phrases associated with a unit you have just opened.
  4. To tag a phrase open it and at the bottom of the page you will see numerous buttons with phonemes associated with a language you are editing.
  5. Choose phonemes that the phrase consists of. For example English word "cat" consists of three phonemes 'k','æ' and 't'.
  6. When you tagged all the phonemes for a phrase accept changes by clicking the accept button.

You can tag more phrases but you will need to save your changes before exiting the program (OK button on the top of the screen).

Create a Language Specification (Phonology)

Artikulate uses language specifications (called "phonology") that define lists of available phonemes for a language. In short, a phoneme is a natural sound of a language. (For a detailed explanation see e.g. [1].) We need such a phonology for every language to be able to tag phrases by the sounds that are specific to this language. Using phoneme tags for phrases enables users to select specific phonemes that they want to improve and hence allows a more focused training.

The already available languages can be found in the subdirectory data/languages.

For creating a phonology, the following steps are needed:

  1. create a new XML file in data/languages according to the language name
  2. create phonology
  3. add entry for the new phonology to data/languages/CMakeLists.txt
  4. build and install Artikulate, then run unit tests to check correctness of phonology