From 65e12900233c3665f952653df892cb003b11091a Mon Sep 17 00:00:00 2001 From: eeeickythump Date: Thu, 12 May 2011 10:36:28 +1200 Subject: New file-safe user variable: org-drill-scope. Allows customisation of the scope of drill sessions (ie where items are sourced from). The variable can take the value 'directory', meaning items will be sourced from all org files in the same directory as the current file. This is useful for splitting up a monolithic item collection into smaller files, while still including all those files in drill sessions. The values of the SCOPE argument to org-drill have changed slightly. Possible values are the same as those for 'org-drill-scope'. - 'file' now means current file/buffer, respecting restrictions (default, same as old 'nil') - 'file-no-restriction' means current file, ignoring (overriding) restrictions (same as old 'file') - new value 'directory' (see above) - other values have the same meaning as before. --- README.html | 189 ++++++++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 128 insertions(+), 61 deletions(-) (limited to 'README.html') diff --git a/README.html b/README.html index 32c9908..5dba098 100755 --- a/README.html +++ b/README.html @@ -7,7 +7,7 @@ lang="en" xml:lang="en"> Org-Drill - + @@ -109,20 +109,22 @@ lang="en" xml:lang="en"> -
  • Sharing, merging and synchronising item collections
    • -
  • Incremental reading
    • +
  • Coping with large collections
    • +
  • Sharing, merging and synchronising item collections
    • +
  • Incremental reading
    • @@ -621,7 +623,7 @@ functions at the end of org-drill.el – these include:
  • org-drill-present-verb-conjugation, which implements the 'conjugate' card type. This asks the user to conjugate a verb in a particular tense. It demonstrates how the appearance of an entry can be completely altered during - a drill session, both during testing and during the display fo the answer. + a drill session, both during testing and during the display of the answer.
  • org-drill-present-translate-number, which uses a third-party emacs lisp library (spell-number.el) to prompt the user to translate random numbers @@ -681,29 +683,8 @@ 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. Possible values for SCOPE are: +sources. See below for details.

    -
    -
    tree
    The subtree starting with the entry at the cursor. (Alternatively you - can use M-x org=drill-tree to run the drill session – this will - behave the same as org-drill if 'tree' was used as the value of - SCOPE.) -
    -
    file
    The current buffer, including both hidden and non-hidden items. -
    -
    file-with-archives
    The current buffer, and any archives associated with it. -
    -
    agenda
    All agenda files. -
    -
    agenda-with-archives
    All agenda files with any archive files associated - with them. -
    -
    (file1 file2 …)
    A list of filenames. All files in the list will be - scanned. -
    -
    - -

    During a drill session, you will be presented with each item, then asked to rate your recall of it by pressing a key between 0 and 5. The meaning of these @@ -911,10 +892,53 @@ session will not end until all outstanding items have been reviewed.

    -

    Definition of old and overdue items

    +

    Sources of items for drill sessions (scope)

    +

    +By default, Org-Drill gathers drill items from the current buffer only, +ignoring any non-visible items. There may be times when you want Org-Drill to +gather drill items from other sources. You can do this by changing the value of +the variable org-drill-scope. Possible values are: +

    +
    +
    file
    The current buffer, ignoring hidden items. This is the default. +
    +
    tree
    The subtree starting with the entry at the cursor. (Alternatively you + can use M-x org=drill-tree to run the drill session – this will + behave the same as org-drill if 'tree' was used as the value of + SCOPE.) +
    +
    file-no-restriction
    The current buffer, including both hidden and + non-hidden items. +
    +
    file-with-archives
    The current buffer, and any archives associated with it. +
    +
    agenda
    All agenda files. +
    +
    agenda-with-archives
    All agenda files with any archive files associated + with them. +
    +
    directory
    All files with the extension '.org' in the same directory as the + current file. (The current file will also be included if its + extension is .org) +
    +
    (file1 file2 …)
    A list of filenames. All files in the list will be + scanned. +
    +
    + + +
    + +
    + +
    +

    Definition of old and overdue items

    +
    + +

    Org-Drill prioritises overdue items in each drill session, presenting them @@ -971,18 +995,18 @@ of 10 days or less. To change this, use the following:

    -
    -

    Spaced repetition algorithm

    -
    +
    +

    Spaced repetition algorithm

    +
    -
    -

    Choice of algorithm

    -
    +
    +

    Choice of algorithm

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

    Random variation of repetition intervals

    -
    +
    +

    Random variation of repetition intervals

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

    Adjustment for early or late review of items

    -
    +
    +

    Adjustment for early or late review of items

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

    Adjusting item difficulty globally

    -
    +
    +

    Adjusting item difficulty globally

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

    Per-file customisation settings

    -
    - +
    +

    Per-file customisation settings

    +

    -Most of the above settings are safe as file-local variables. This means you can -include a commented section like this at the end of your .org file to apply -special settings when running a Drill session using that file: +Most of Org-Drill's customisation settings are safe as file-local +variables. This means you can include a commented section like this at the end +of your .org file to apply special settings when running a Drill session using +that file:

    @@ -1166,6 +1190,22 @@ special settings when running a Drill session using that file: +

    +You can achieve the same effect by including the settings in the 'mode line' +(this must be the first line in the file), like so: +

    + + + +
    # -*- org-drill-maximum-items-per-session: 50; org-drill-spaced-repetition-algorithm: simple8 -*-
+
    + + + +

    +In either case you will need to save, close and re-open the file for the +changes to take effect. +

    @@ -1173,11 +1213,38 @@ special settings when running a Drill session using that file:
    -

    Sharing, merging and synchronising item collections

    +

    Coping with large collections

    +

    +If you keep all your items in a single file, it may eventually very large. The +file will be slow to load, and Emacs may have trouble syntax-highlighting the +file contents correctly. +

    +

    +The easiest steps to solve this problem are: +

      +
    1. Move your file into its own dedicated directory. +
      2. +
    2. Divide the file into two or more smaller files. +
      3. +
    3. Within each file, set org-drill-scope to 'directory'. See + per-file settings above for instructions about how to do this. +
      4. +
    + +
    + +
    + +
    +

    Sharing, merging and synchronising item collections

    +
    + + +

    Every drill item is automatically given a persistent unique "ID" the first time it is seen by Org-Drill. This means that if two different people subsequently @@ -1236,9 +1303,9 @@ procedure.

    -
    -

    Incremental reading

    -
    +
    +

    Incremental reading

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

    Date: 2011-05-10 16:51:44

    +

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

    Author: Paul Sexton

    Org version 7.5 with Emacs version 23

    Validate XHTML 1.0 -- cgit v1.2.3