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:
- explain what different game types are available, for context on how your content will be used in situ
- 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 |
Each row can have as many incorrect answers as you like. The template file only has headings for 3; feel free to add more.
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, split up |
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...
- can each only be built correctly 1 way. ( e.g. the following wouldn't work, because there are two separate
dobits:What|do|you want to|do|today?but this would work:What do|you want to|do|today?) - 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.