From b17bf579bd1ab9b3efc9c19a26e3efc59845fce3 Mon Sep 17 00:00:00 2001 From: eeeickythump Date: Fri, 20 May 2011 23:22:18 +1200 Subject: - New card types: show2cloze, hide1_firstmore, show1_firstless, show1_lastmore. See docs for details. - 'conjugate' card type can now show a hint (VERB_INFINITIVE_HINT) - New command: org-drill-again: run another drill session using leftover items from the last session, i.e. don't rescan the item collection. - If org-drill-resume is called and there is nothing to resume, offer to call org-drill-again - Automatically prompt to save all modified buffers when a drill session finishes (turn off with 'org-drill-save-buffers-after-drill-sessions-p') - Politely skip cards with unknown card types - When suspending a drill session, print a message describing the key that runs org-drill-resume (it it's bound to a key) - org-drill-merge-buffers: can now optionally be prevented from copying unmatched items from SRC into DEST - org-drill-merge-buffers: fixed a bug where it prompted for certain property values if they were not set in the item being processed - org-drill-merge-buffers: ensure that *all* items in DEST are stripped of their scheduling data --- README.html | 214 +++++++++++++++++++++++++++++++++++++++++------------------- 1 file changed, 146 insertions(+), 68 deletions(-) (limited to 'README.html') diff --git a/README.html b/README.html index 5dba098..91836c6 100755 --- a/README.html +++ b/README.html @@ -7,7 +7,7 @@ lang="en" xml:lang="en"> Org-Drill - + @@ -103,28 +103,30 @@ lang="en" xml:lang="en">
  • Running the drill session
    • -
  • Cram mode
    • -
  • Leeches
    • -
  • Customisation +
  • Multiple sequential drill sessions
    • +
  • Cram mode
    • +
  • Leeches
    • +
  • Customisation
    • -
  • Coping with large collections
    • -
  • Sharing, merging and synchronising item collections
    • -
  • Incremental reading
    • +
  • Coping with large collections
    • +
  • Sharing, merging and synchronising item collections
    • +
  • Incremental reading
    • @@ -526,7 +528,7 @@ the [North|North/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. +become a leech.

    A better way to express all these facts using 'simple' cards is to create @@ -567,7 +569,7 @@ the [North|North/South] Island. However, this is really cumbersome. Multicloze card types exist for this situation. Multicloze cards behave like 'simple' cards, except that when there is more than one area marked as cloze text, some but not all of the areas -are hidden. There are two types of multicloze card: +can be hidden. There are several types of predefined multicloze card:

    1. hide1cloze – one of the marked areas is hidden during review; the others @@ -579,6 +581,35 @@ are hidden. There are two types of multicloze card: the others are hidden. The hidden text area is chosen randomly at each review.
      2. +
    2. hide2cloze – like hide1cloze, but 2 marked pieces of text will be hidden, + and the rest will be visible. +
      3. +
    3. show2cloze – like show1cloze, but 2 marked pieces of text will be visible, + the rest are hidden. +
      4. +
    + + +

    +There are also some types of multicloze card where some pieces have an +increased or decreased chance of being hidden. These are intended for use when +studying languages: generally it is easy to translate a foreign-language +sentence into your own language if you have met it before, but it is much +harder to translate in the other direction. Therefore, you will want to test +the harder direction more often. +

      +
    1. hide1_firstmore – only one of the marked pieces of text will be + hidden. 75% of the time (guaranteed), the first piece is hidden; the rest + of the time, one of the other pieces is randomly hidden. +
      2. +
    2. show1_firstless – only one of the marked pieces of text will be + visible. Only 25% of the time (guaranteed) will the first piece will be + visible; the rest of the time, one of the other pieces is randomly visible. +
      3. +
    3. show1_lastmore – only one of the marked pieces of text will be + visible. 75% of the time (guaranteed), the last piece will be visible; + the rest of the time, one of the other pieces is randomly visible. +
    @@ -683,7 +714,7 @@ drill session, put a brief comment ('# …') in the item body. Start a drill session with M-x org-drill. By default, this includes all non-hidden topics in the current buffer. org-drill takes an optional argument, SCOPE, which allows it to take drill items from other -sources. See below for details. +sources. See below for details.

    During a drill session, you will be presented with each item, then asked to @@ -738,11 +769,35 @@ session.

    -

    Cram mode

    +

    Multiple sequential drill sessions

    +

    +Org-Drill has to scan your entire item database each time you start a new drill +session. This can be slow if you have a large item collection. If you have a +large number of 'due' items and want to run a second drill session after +finishing one session, you can use the command org-drill-again to run a new +drill session that draws from the pool of remaining due items that were not +tested during the previous session, without re-scanning the item collection. +

    +

    +Also note that if you run org-drill-resume and you have actually finished the +drill session, you will be asked whether you want to start another drill +session without re-scanning (as if you had run org-drill-again). +

    + +
    + +
    + +
    +

    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. @@ -758,9 +813,9 @@ variable org-drill-cram-hours).

    -
    -

    Leeches

    -
    +
    +

    Leeches

    +

    @@ -810,9 +865,9 @@ See the SuperMemo website

    -
    -

    Customisation

    -
    +
    +

    Customisation

    +
    @@ -825,9 +880,9 @@ settings by adding elisp code to your configuration file (.emacs).
    -
    -

    Visual appearance of items during drill sessions

    -
    +
    +

    Visual appearance of items during drill sessions

    +
    @@ -861,9 +916,9 @@ invisible while each item is being tested, add:
    -
    -

    Duration of drill sessions

    -
    +
    +

    Duration of drill sessions

    +
    @@ -891,9 +946,32 @@ session will not end until all outstanding items have been reviewed.
    -
    -

    Sources of items for drill sessions (scope)

    -
    +
    +

    Saving buffers after drill sessions

    +
    + + + +

    +By default, you will be prompted to save all unsaved buffers at the end of a +drill session. If you don't like this behaviour, use the following setting: +

    + + + +
    (setq org-drill-save-buffers-after-drill-sessions-p nil)
+
    + + + + +
    + +
    + +
    +

    Sources of items for drill sessions (scope)

    +

    @@ -934,9 +1012,9 @@ the variable org-drill-scope. Possible values are:

    -
    -

    Definition of old and overdue items

    -
    +
    +

    Definition of old and overdue items

    +
    @@ -995,18 +1073,18 @@ of 10 days or less. To change this, use the following:
    -
    -

    Spaced repetition algorithm

    -
    +
    +

    Spaced repetition algorithm

    +
    -
    -

    Choice of algorithm

    -
    +
    +

    Choice of algorithm

    +
    @@ -1048,9 +1126,9 @@ SuperMemo algorithms. These are:
    -
    -

    Random variation of repetition intervals

    -
    +
    +

    Random variation of repetition intervals

    +
    @@ -1084,9 +1162,9 @@ your .emacs:
    -
    -

    Adjustment for early or late review of items

    -
    +
    +

    Adjustment for early or late review of items

    +
    @@ -1113,9 +1191,9 @@ effect on the SM2 algorithm.
    -
    -

    Adjusting item difficulty globally

    -
    +
    +

    Adjusting item difficulty globally

    +
    @@ -1168,9 +1246,9 @@ To alter the learn fraction, put the following in your .emacs:
    -
    -

    Per-file customisation settings

    -
    +
    +

    Per-file customisation settings

    +

    @@ -1212,9 +1290,9 @@ changes to take effect.

    -
    -

    Coping with large collections

    -
    +
    +

    Coping with large collections

    +
    @@ -1231,7 +1309,7 @@ The easiest steps to solve this problem are:
  • Divide the file into two or more smaller files.
  • Within each file, set org-drill-scope to 'directory'. See - per-file settings above for instructions about how to do this. + per-file settings above for instructions about how to do this.
    • @@ -1239,9 +1317,9 @@ The easiest steps to solve this problem are:
    -
    -

    Sharing, merging and synchronising item collections

    -
    +
    +

    Sharing, merging and synchronising item collections

    +
    @@ -1303,9 +1381,9 @@ procedure.
    -
    -

    Incremental reading

    -
    +
    +

    Incremental reading

    +
    @@ -1463,7 +1541,7 @@ or give it different tags or properties, for example.
    -

    Date: 2011-05-12 10:29:29

    +

    Date: 2011-05-20 23:13:33 NZST

    Author: Paul Sexton

    Org version 7.5 with Emacs version 23

    Validate XHTML 1.0 -- cgit v1.2.3