Create gapped texts and cloze tests on the Mac


current version: 1.4 [release notes]

Support

Starting from a template

A screenshot showing the template chooser

How can I open a template?

In the menu bar click on “File -> New from template” or press Command + Shift + n. The template chooser opens. Double click one of the templates to get started.

Editing the source text

A screenshot showing a Gapped document with pasted text and some words marked as gaps.

How can I edit the source text?

Click on the “Source” button in the sidebar if you are in Preview mode. Enter the text in the editor or paste your text from another application.

How do I add a gap to the source text?

Move the cursor to the word which you would like to mark as a gap. Now you can either:

  • Choose “Edit -> Mark as gap” from the menu bar
  • Right-click on the word and select “Mark as gap” from the contextual menu
  • Press Command + g on your keyboard.

The current selection will be enclosed in underscores and marked with a red background showing that this will be turned into a gap. If you would like to have more than one word or parts of a word in a gap, select these words first then proceed as described above.

How do I create a nth-word gapped text?

Enter your text in the source editor. In the “Nth-Word Inspector” in the sidebar adjust the slider to your liking. The source view will already highlight the gaps. If you like the result you can press confirm in the sidebar or otherwise cancel.

How do I turn all nouns/verbs/adverbs etc. into gaps?

Select the word type you would like to turn into gaps in the “Language Tagger Inspector” and press “Mark”. Boom all the words will magically turn into gaps.

What is a ctest?

A ctest is standardised form of a cloze test. There are no gaps in the first sentence. Starting with the second sentence the second half of every fifth word is marked as a gap. In total there will be 25 gaps. So a ctest could look like this (based on Agatha Christie’s “THE MYSTERIOUS AFFAIR AT STYLES”):

Source Text:

The intense interest aroused in the public by what was known at the time as "The Styles Case" has now somewhat subsided. Nevertheless, in view of the world-wide notoriety which attended it, I have been asked, both by my friend Poirot and the family themselves, to write an account of the whole story. This, we trust, will effectually silence the sensational rumours which still persist. I will therefore briefly set down the circumstances which led to my being connected with the affair. I had been invalided home from the Front; and, after spending some months in a rather depressing Convalescent Home, was given a month's sick leave. Having no near relations or friends, I was trying to make up my mind what to do, when I ran across John Cavendish. I had seen very little of him for some years. Indeed, I had never known him particularly well. He was a good fifteen years my senior, for one thing, though he hardly looked his forty-five years. As a boy, though, I had often stayed at Styles, his mother's place in Essex.

C-Test:

The intense interest aroused in the public by what was known at the time as "The Styles Case" has now somewhat subsided. Nevertheless, in view of t____ world-wide notoriety which attended i__ I have been asked, bo____ by my friend Poirot a____ the family themselves, to wr______ an account of the wh______ story. This, we trust, wi____ effectually silence the sensational rum________ which still persist. I will therefore briefly s____ down the circumstances which l____ to my being connected wi____ the affair. I had been invalided ho____ from the Front; and, af______ spending some months in a __ rather depressing Convalescent Home, w____ given a month's sick le______ Having no near relations o__ friends, I was trying t__ make up my mind wh____ to do, when I r____ across John Cavendish. I h____ seen very little of h____ for some years. Indeed, I __ had never known him partic____________ well. He was a go____ fifteen years my senior, for one thing, though he hardly looked his forty-five years. As a boy, though, I had often stayed at Styles, his mother's place in Essex.

How do I create a ctest?

How can I add a custom number of credits to a gap?

As a standard setting Gapped will count one credit per gap. However sometimes you may want to give more credits for certain gaps. Simply add the number of credits inside the gap, enclosed in parenthesis, e.g. _my gap (2 cr)_ The example gap will be counted with 2 credits.

How can I add multiple choice fields in the gapped text?

You can add a multiple choice field by:

  1. adding a gap in the form of _[correct answer/answer 1/answer 2]_
  2. Show Preview
  3. Activate the option hints “behind gaps (grammar tests, mc tests)”

Previewing the output and fine-tuning

A screenshot showing a Gapped document in preview mode with all inspectors open on the left-hand side.

How can I open the preview?

Click on the “Preview” button in the sidebar or press Command + R to open the preview.

How can I fine-tune my gapped text?

This is one of the core functions of Gapped. No more tedious typing, manually counting credits, etc. After you entered your text and opened the preview function you can easily adjust the parameters of your exercise using the inspector pane on the left.

How can I fine-tune my gaps?

There are two sizing modes for gaps:

  • proportional (default) sizes the gaps’ length proportional to the length of the word (to be adjusted by the slider below). This sizing mode makes it possible for students to match the words by their length.
  • equal sizing. All gaps have the same size (to be adjusted by the slider below). Thus students cannot match words by their length. The task becomes more difficult for the student.

Further available options:

  • Gap fill character: The character which will be used for the gaps. Defaults to underscore character “_”
  • Number gaps: Gaps in the text will be numbered.
  • Hint multiple words: If true will output multiple gaps for multiple words in one gap. For expample _word1 word2_ will be transformed to __________ __________ if checked or ______________________ if unchecked.
  • Credits: Show credits behind each gap.

How can I fine-tune the hints?

Available options for the position of hints:

  • Before text: Hints will be displayed at the top before the actual text.
  • Behind gaps (grammar tests, mc tests): Hints are displayed behind each gap. This is useful if you would like to create a grammar test or a multiple choice test in which students have to choose one option of multiple hints.
  • Behind text (with folding mark): Hints are displayed at the bottom after the text together with a folding mark. This is a quick way of differentitation: first students can try to fill in the gaps without using the hints, if they feel that they do not make any progress the can unfold the hints and complete the rest of the gaps.
  • Behind text (no folding mark): Hints are display at the bottom after the text.
  • No hints: No hints will be displayed.

Adding distractors to your text will make the text more difficult for students. Additional words will be added to the hints which do not fit into any of the gaps. There are two ways to add distractors:

  1. List of distractors: Enter words you would like to add as distractors into the text field, separated with a comma. If done confirm with enter and the preview will refresh with the additional hints.
  2. Random distractors from the text: Add random distractors from the text by moving the slider to the right.

Obfuscating hints will make the hints more difficult to identify and decipher. The following options are available:

  • don’t obfuscate: No obfuscation.
  • anagrams: Mix up the letters of words in a gap, e.g. _word_ could become dowr or wdro
  • remove vowels: Vowels will be removed from the hints, e.g. _available_ will become _v__l_bl__
  • remove consonants: Consonants will be removed from the hints, e.g. _word_ will become _o__

Furthermore, the following options are available for hints:

  • Remove punctuation: Removes punctuation from the hints, e.g. _word._ will become word
  • Convert hints to lowercase: Transforms hints to lower case, to make it impossible for students to match words because of their case. E.g. _Word_ will become word

How can I fine-tune the task?

  • Include task: select to add the task text to the output
  • Task text: edit the text which will be inserted
  • Show total credits in task: select to automatically count and show the credits behind the task
  • Include key: select to add the key after the gapped text
  • Scramble paragraphs: Will mix the paragraphs so that your students will have to sort them
  • Scramble task text: The text which will be added to the task if “Scramble paragraphs” is activated

Exporting

The following export options are available:

  • Copy and paste the finished output from the preview to your word processor, e.g. Apple Pages™ or Microsoft Word™
  • Print directly from Gapped via File → Print
  • Export to .rtf format via File → Export → RTF…
  • Export to .docx format via File → Export → Word…

Keyboard Shortcuts

Shortcut Action
⌘ Command + G Toggle the currently selected word as a gap
⌘ Command + ⌥ Alt + G Remove all gaps from the whole text
⌘ Command + R Toggle source view / preview
⌘ Command + 1 Open the source view and toggle the nth-word test inspector pane
⌘ Command + 2 Open the preview and toggle the gaps inspector pane
⌘ Command + 3 Open the preview and toggle the hints inspector pane
⌘ Command + 4 Open the preview and toggle the task inspector pane