Skip to main content

Ap Iaith Content Templates

When writing for Ap Iaith, the authoring templates below must be followed. Don't worry about what the final, visual representation of the app will be; the content in these templates is what's important here. By writing the content to fit the templates, the games they'll eventually become will work automatically.

How the templates match up to the available game types is available here for registered Wiki users.

The content structure for authoring is illustrated here.

This page hopes to:

  1. explain what different game types are available, for context on how your content will be used in situ
  2. provide the necessary content templates for you to fill in

The Structure

Each location / topic has 3 activities, each one using a different template type.
Each of those activities has 3 difficulty levels, Ail Iaith, Pontio and Iaith Gyntaf.

This is the structure as it must be written and added to the app.
The end user will choose their difficulty level (AI / P / IG) before choosing location / learning area / topic, but this has no effect on authoring.

General Structure

An Example of 1 location / learning area / topic

The 3 Main Templates

PWYNT - "choose 1 correct answer"

The format (example)
prompt word or sentence #1
correct answer for #1
prompt word or sentence #2
correct answer for #2

We take all of the available correct answers and combine them to make a bank of incorrect answers. Please make sure no two correct answers are the same.

Template File: AP IAITH TEMPLATE - PWYNT - choose 1 correct answer.xlsx

There is one type of game a pwynt template can end up like.



LLINELL - "like multiple choice with two prompts"

The format (example)
main prompt #1
secondary prompt for #1
correct answer for #1
incorrect answer for #1 2nd incorrect answer for #1 3rd incorrect answer for #1
main prompt #2
secondary prompts are not required. can be like... help text maybe?
correct answer for #2
incorrect answer for #2 2nd incorrect answer for #2
main prompt #3
this question has more than 1 correct answer. please highlight the extra correct answers in green
correct answer for #3
2nd correct answer for #3 incorrect answer for #3

Each row can have as many correct or incorrect answers as you like, but be aware: the user must click / tap / collect all of the correct answers in order to get the point.

Template File: AP IAITH TEMPLATE - LLINELL - multiple choice.xlsx

There are five types of game a llinell template can end up like.



TRIONGL - "make a sentence"

The format (example)
prompt #1
Sentence in
order
of being
correct

prompt #2
Another sentence
also in the correct
order, but split
as will appear in
the game.

The sentences can be as long as you like (that is ... have as many break points / span as many columns), but you'll need to make sure they

  1. can each only be built correctly 1 way. ( e.g. the following wouln't work, because there are two separate do bits: What | do | you want to | do | today?  but this would work: What do | you want to | do | today? )
  2. aren't too long, since the games will run through all of its different available sentences before ending

Template File: AP IAITH TEMPLATE - TRIONGL - make a sentence.xlsx



Original App's Conternt

An example of the original App's content, as it is used in the app, is available on this page. It's a separate page because - as you'll see - there's a fair amount to it. The surrounding code has been removed so you can see the format each game's content has to get put into in order for it to work.

This should also serve as an example of the type of content (primarily translation-focussed) that we don't want to see in the content authored for the new difficulty levels.