From 0e2040ba7e03aa23dc76eecc5b1df1f3d14be0b3 Mon Sep 17 00:00:00 2001 From: eeeickythump Date: Fri, 17 Sep 2010 12:13:40 +1200 Subject: * Documentation added for multicloze cards and cram mode. * Multicloze card example added in 'spanish.org'. --- README.html | 217 ++++++++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 168 insertions(+), 49 deletions(-) (limited to 'README.html') diff --git a/README.html b/README.html index b8f23f2..75a7a43 100644 --- a/README.html +++ b/README.html @@ -7,7 +7,7 @@ lang="en" xml:lang="en"> Org-Drill - + @@ -79,28 +79,30 @@ lang="en" xml:lang="en">

Table of Contents

-

1 Synopsis

+

Synopsis

@@ -142,7 +144,7 @@ that use it, see:
-

2 Installation and Customisation

+

Installation and Customisation

@@ -232,7 +234,7 @@ your .emacs:
-

3 Demonstration

+

Demonstration

@@ -251,7 +253,7 @@ drill topics are written.
-

4 Writing the questions

+

Writing the questions

@@ -282,7 +284,7 @@ recall purposes.
-

4.1 Simple topics

+

Simple topics

@@ -314,17 +316,18 @@ be visible, but the contents of the subheading ("The Answer") will be hidden.
-

4.2 Cloze deletion

+

Cloze deletion

Cloze deletion can be used in any drill topic regardless of whether it is -otherwise 'simple', or one of the specialised topic types discussed below. To -use cloze deletion, part of the body of the topic is marked as cloze text by -surrounding it with single square brackets, [like so]. When the topic is -presented for review, the text within square brackets will be obscured. The -text is then revealed after the user presses a key. For example: +otherwise 'simple', or is one of the specialised topic types discussed +below. To use cloze deletion, one or more parts of the body of the topic is +marked as cloze text by surrounding it with single square brackets, [like +so]. When the topic is presented for review, the text within square brackets +will be obscured. The text is then revealed after the user presses a key. For +example:

@@ -384,7 +387,7 @@ and
-

4.3 Two-sided cards

+

Two-sided cards

@@ -441,7 +444,7 @@ not one of the first two 'sides' of the topic.
-

4.4 Multi-sided cards

+

Multi-sided cards

@@ -476,16 +479,115 @@ the table The user will be shown the main text and either 'la mujer', or 'the woman', or a picture of a table.

-
-

4.5 User-defined topic types

+

Multi-cloze cards

+

+Often, you will wish to create cards out of sentences that express several +facts, such as the following: +

+
+ +

The capital city of New Zealand is Wellington, which is located in the +South Island and has a population of about 400,000. +

+
+ + +

+There is more than one fact in this statement – you could create a single +'simple' card with all the facts marked as cloze text, like so: +

+
+ +

The capital city of [New Zealand] is [Wellington], which is located in +[the South Island] and has a population of about [400,000]. +

+
+ + +

+But this card will be difficult to remember. If you get just one of the 4 +hidden facts wrong, you will fail the card. A card like this is likely to +become a leech. +

+

+A better way to express all these facts using 'simple' cards is to create +several cards, with one fact per card. You might end up with something +like this: +

+ + + +
* Fact
+The capital city of [New Zealand] is Wellington, which has a population of
+about 400,000.
+
+* Fact
+The capital city of New Zealand is [Wellington], which has a population of
+about 400,000.
+
+* Fact
+The capital city of New Zealand is Wellington, which has a population of
+about [400,000].
+
+* Fact
+The capital city of [New Zealand] is Wellington, which is located in the
+the South Island.
+
+* Fact
+The capital city of New Zealand is [Wellington], which is located in 
+the South Island.
+
+* Fact
+The capital city of New Zealand is Wellington, which is located in 
+[the South Island].
+
+ + + +

+However, this is really cumbersome. The 'multicloze' card type exists for this +situation. Multicloze cards behave like 'simple' cards, except that when there +is more than one area marked as cloze text, only one of the marked areas will +be hidden during review – the others all remain visible. The hidden text area +is chosen randomly at each review. +

+

+So, for the above example, we can actually use the original 'bad' simple card, +but change its card type to 'multicloze'. Each time the card is presented for +review, one of 'New Zealand', 'Wellington', 'the South Island' or '400,000' +will be hidden. +

+ + + +
* Fact
+  :PROPERTIES:
+  :DRILL_CARD_TYPE: multicloze
+  :END:
+
+The capital city of [New Zealand] is [Wellington], which is located in 
+[the South Island] and has a population of about [400,000].
+
+ + + +
+ +
+ +
+

User-defined topic types

+
+ +

Finally, you can write your own elisp functions to define new kinds of topics. Any new topic type will need to be added to @@ -504,7 +606,7 @@ See the file spanish.org for a full set of example ma

-

5 Running the drill session

+

Running the drill session

@@ -564,8 +666,9 @@ numbers is (taken from org-learn):

You can press '?' at the prompt if you have trouble remembering what the numbers 0–5 signify. At any time you can press 'q' to finish the drill early -(your progress will be saved), or 'e' to finish the drill and jump to the -current topic for editing (your progress up to that point will be saved). +(your progress will be saved), 's' to skip the current item without viewing the +answer, or 'e' to finish the drill and jump to the current topic for editing +(your progress up to that point will be saved).

@@ -573,11 +676,10 @@ current topic for editing (your progress up to that point will be saved).
-

6 Leeches

+

Leeches

-

From the Anki website, http://ichi2.net/anki/wiki/Leeches:

@@ -628,11 +730,32 @@ See the SuperMemo website
-

7 Incremental reading

+

Cram mode

+

+There are some situations, such as before an exam, where you will want to +revise all of your cards regardless of when they are next due for review. +

+

+To do this, run a cram session with the org-drill-cram command (M-x org-drill-cram RET). This works the same as a normal drill session, except +that all items are considered due for review unless you reviewed them within +the last 12 hours (you can change the number of hours by customising the +variable org-drill-cram-hours). +

+ +
+ +
+ +
+

Incremental reading

+
+ + +

An innovative feature of the program SuperMemo is so-called "incremental reading". This refers to the ability to quickly and easily make drill items @@ -651,8 +774,8 @@ Another important component of incremental reading is the ability to save your exact place in a document, so you can read it incrementally rather than all at once. There is a large variety of bookmarking packages for emacs which provide advanced bookmarking functionality: see the Emacs Wiki for details. -Bookmarking exact webpage locations in an external browser is a bit more -difficult. For Firefox, the addon works well. +Bookmarking exact webpage locations in an external browser seems to be a bit +more difficult. For Firefox, the Wired Marker addon works well.

An example of using Org-Drill for incremental reading is given below. First, @@ -739,7 +862,7 @@ vaccine.

-Then you press the button you created when setting up org=protocol, which is +Then you press the button you created when setting up org-protocol, which is configured to activate the capture template "w: Capture web snippet". The selected text will be sent to Emacs, turned into a new fact using the template, and filed away for your later attention. @@ -751,9 +874,9 @@ multiple items when you edit it later in Emacs.)

Once you have had enough of reading the article, save your place, then go to -your "fact" file in Emacs. You should see that all the pieces of text you -selected have been turned into drill items. Continuing the above example, you -would see something like: +your "fact" file in Emacs. You should see that each piece of text you selected +has been turned into a drill item. Continuing the above example, you would see +something like:

@@ -789,9 +912,9 @@ or give it different tags or properties, for example.
-
-

8 Still to do

-
+
+

Still to do

+
    @@ -800,10 +923,6 @@ or give it different tags or properties, for example. single tag? Can use org-make-tag-matcher.
  • -progress indicator during drill session: cumulative time, time spent thinking -about this card -
    • -
  • perhaps take account of item priorities, showing high priority items first
@@ -812,7 +931,7 @@ perhaps take account of item priorities, showing high priority items first

Author: Paul Sexton

-

Date: 2010-09-04 17:22:25 NZST

+

Date: 2010-09-17 10:05:27

HTML generated by org-mode 7.01trans in emacs 23

-- cgit v1.2.3