Skip to content

LibreLingo Documentation on Challenge

As they study using LibreLingo, users respond to a series of tasks or questions called Challenges.

Challenges are not configured directly but automatically generated from Skill configuration.


Confused? Ask people on GitHub Discussions.


Table of Contents:

Challenge order

The order of words and phrases within a skill is random, but certain challenge types always come before others. This is denoted by the Priority values listed under each challenge type. First-priority challenges come before second-priority challenges, which come before third-priority challenges.

Cards challenge

Text asks the user: which of these is "river"? Below this heading are three cards. Each card contains a Spanish word and a corresponding image. In the center, the correct choice (río) is selected.

  • Generated from: New words only
  • Task: translation, multiple-choice
  • Direction: source -> target only
  • Properties used: Word, Translation, Images -- both of the asked word and of two or three other words in the same skill
  • Mini-dictionary available: No
  • Priority: First

In this challenge type, the user is presented with a word in their source language and three (four on mobile) cards to choose from. Each card contains a target language word and a matching image, which is a big hint since the user may have never seen this target language word before.

Note that for each card, a random image is selected from the word's Images array.

Short input challenge

Text asks the user to type the word "river" in Spanish. Below this heading is a text box and a set of buttons to insert Spanish-specific characters. At right is an image of a river.

  • Generated from: New words only
  • Task: translation, free-form
  • Direction: source -> target only
  • Properties used: Word, Translation, Images
  • Mini-dictionary available: Yes
  • Priority: Second

In this challenge type, the user is presented with a word in their source language and a text box in which to input the translation into the target language. There is also a random image from the Images array on the right, but since this challenge asks for the target language, the image does not give the user any additional information. If the user does need a hint, the mini-dictionary is available for this challenge.

Options challenge

Text asks the user which one of the options is "Let's go to the beach!". Below this question are three Spanish sentences with radio buttons to their left.

  • Generated from: Phrases only
  • Task: translation, multiple-choice
  • Direction: source -> target only
  • Properties used: Phrase, Translation both of the asked phrase and two other phrases in the same skill
  • Mini-dictionary available: No
  • Priority: First

In this challenge type, the user is presented with a phrase in their source language and three options from which they must choose the correct translation into the target language. There are no hints available.

Chips challenge

Text instructs the user to translate the phrase "Let's go to the beach!". At the bottom of the image, there is a group of draggable Spanish words.

  • Generated from: Phrases only
  • Task: translation, set of words provided
  • Direction: Both directions: source -> target, target -> source
  • Properties used:
  • If source -> target: Phrase, Translation, Alternative translations; Translation and Alternative translations of other phrases anywhere in the course
  • If target -> source: Translation, Phrase, Alternative versions; Phrase and Alternative versions of other phrases anywhere in the course
  • Mini-dictionary available: Yes
  • Priority: Third

In this challenge type, the user is presented with a phrase in one language and a set of words in the other language. This set will always include all words of the Translation field. The user's task is to use these words as "building blocks" to create any acceptable translation for the phrase they've been presented with.

The mini-dictionary is available to give hints about individual words, but there are no hints about grammar or sentence structure.

The chips will never include exact duplicates of each other.

Listening challenge

Text instructs the user: "Type what you hear". Below this heading is a text box and a set of buttons to insert Spanish-specific characters.

  • Generated from: New words and Phrases
  • Task: transcription
  • Direction: N/A, target language only
  • Properties used: Word or Phrase
  • Mini-dictionary available: No
  • Priority: Second

In this challenge type, the user is played audio of a word or phrase in the target language and is presented with a text box to transcribe the audio (still in the target language). The user can re-listen to the audio if necessary.