~ubuntu-branches/ubuntu/lucid/anki/lucid-updates

« back to all changes in this revision

Viewing changes to docs/manual.txt

  • Committer: Bazaar Package Importer
  • Author(s): Mackenzie Morgan
  • Date: 2010-05-31 15:55:50 UTC
  • mfrom: (7.1.2 sid)
  • Revision ID: james.westby@ubuntu.com-20100531155550-wj3tag8bvp6fwhpo
Tags: 0.9.9.8.6-2~lucid1
Backport from maverick to fix FTBFS (LP: #550145)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
Anki User Manual
 
2
__________________
 
3
Damien Elmes <anki@ichi2.net>
 
4
 
 
5
Introduction
 
6
============
 
7
 
 
8
Anki is a program which makes remembering things easy. Because it is a lot
 
9
more efficient than traditional study methods, you can either greatly decrease your
 
10
time spent studying, or greatly increase the amount you remember in a given
 
11
amount of time.
 
12
 
 
13
Anyone who needs to remember things in their daily life can benefit from Anki.
 
14
Since it is content-agnostic and supports images, audio, videos and scientific
 
15
markup (via LaTeX), the possibilities are endless. For example:
 
16
 
 
17
 - learning a language
 
18
 - studying for medical and law exams
 
19
 - memorizing people's names and faces
 
20
 - brushing up on geography
 
21
 - practicing guitar cord recognition
 
22
 
 
23
There are two simple concepts behind Anki: 'active recall testing' and 'spaced
 
24
repetition'. They are not known to most learners, despite having been written
 
25
about in the scientific literature for many years. Understanding how they work
 
26
will make you a more effective learner.
 
27
 
 
28
Active recall testing
 
29
---------------------
 
30
 
 
31
'Active recall testing' means being asked a question and trying to remember
 
32
the answer. This is in contrast to 'passive' study, where we read, watch or
 
33
listen to something without any output. Studies have shown that active recall
 
34
testing is far more effective at building strong memories than passive study.
 
35
There are two reasons for this:
 
36
 
 
37
 - The act of recalling something 'consolidates' the memory, increasing the
 
38
   chances we'll be able to remember it again
 
39
 - When we're unable to answer a question, it tells us we need to return to
 
40
   the material to review or relearn it
 
41
 
 
42
You have probably encountered active recall testing in your school years
 
43
without even realizing it. When good teachers give you a series of questions
 
44
to answer after reading an article, or make you take weekly progress-check
 
45
tests, they are not doing it simply to see if you understood the material or
 
46
not. By testing you, they are increasing the chances you will be able to
 
47
remember the material in the future.
 
48
 
 
49
You don't need to leave it up to teachers, however. Consider a language
 
50
learner who wants to memorize the following Indonesian words:
 
51
 
 
52
|============
 
53
|one   |satu
 
54
|two   |dua
 
55
|three |tiga
 
56
|============
 
57
 
 
58
Many students will look at each line in turn, concentrating on it for a few
 
59
seconds before moving on. This is passive learning, and so the results will
 
60
not be great. However, if you cover the right-hand side and check if you
 
61
recall each word, you'll find your initial memories are stronger.
 
62
 
 
63
Active recall testing can make for stronger initial memories, but it's only
 
64
part of the solution to learning efficiently.
 
65
 
 
66
The importance of review
 
67
------------------------
 
68
 
 
69
Even with active recall testing, if you wait too long before testing again,
 
70
you'll find you've forgotten most of the material you tried to learn. This can
 
71
be very demotivating, as it can feel like no progress is being made towards
 
72
your goals. In order to avoid this disappointment, it's essential to review
 
73
previously learnt material.
 
74
 
 
75
Despite the importance of review, it is often overlooked by learners. Part of
 
76
the reason for this is that reviewing was traditionally difficult. If you have
 
77
a page with 50 new words on it and you learn them in one day, some words will
 
78
fall from your memory the next day, others a few days after that, and others
 
79
may last a few weeks or more. It is difficult to return to the page and review
 
80
only the words you're about to forget.
 
81
 
 
82
Traditional paper flashcards make it easier to acquire material than a single
 
83
page with a list of words, since you can separate the cards into "known" and
 
84
"not-known" piles. They don't make it very easy to review the material in the
 
85
following weeks, however.
 
86
 
 
87
Spaced repetition
 
88
-----------------
 
89
 
 
90
The 'spacing effect' was reported by a German psychologist in 1885. He
 
91
observed that we tend to remember things more effectively if we spread reviews
 
92
out over time, instead of studying multiple times in one session. Since the
 
93
1930s there have been a number of proposals for utilizing the spacing effect
 
94
to improve learning, in what come to be called 'spaced repetition'.
 
95
 
 
96
One example is in 1972, when a German scientist called Sebastian Leitner
 
97
popularized a method of spaced repetition with paper flashcards. By separating
 
98
the paper cards up into a series of boxes, and moving the cards to a different
 
99
box on each successful or unsuccessful review, it was possible to see at a
 
100
glance a rough estimate of how well a card was known and when it should be
 
101
reviewed again. This was a great improvement over a single box of cards, and
 
102
it has been widely adopted by computerized flashcard software. It is a rather
 
103
rough approach however, as it can't give you an exact date on which you should
 
104
review something again, and it doesn't cope very well with material of varying
 
105
difficulty.
 
106
 
 
107
The biggest developments in the last 30 years have come from the authors of
 
108
SuperMemo, a commercial flashcard program that implements spaced repetition.
 
109
SuperMemo pioneered the concept of a system that keeps track of the ideal time
 
110
to review material and optimizes itself based on the performance of
 
111
the user.
 
112
 
 
113
In SuperMemo's spaced repetition system, every time you answer a question, you
 
114
tell the program how well you were able to remember it - whether you forgot
 
115
completely, made a small mistake, remembered with trouble, remembered
 
116
easily, etc. The program uses this feedback to decide when to show you the
 
117
question again. Assuming you don't forget a given question, the delay between
 
118
reviews gets bigger and bigger - so you may see a question for the first time,
 
119
then 3 days later, 15 days later, 45 days later, and so on. Because each
 
120
successive repetition results in a higher interval, the number of reviews
 
121
necessary on a given day is quite small, so this method can scale to hundreds
 
122
of thousands of cards entered in over a decade or more. And because the next
 
123
interval is adjusted depending on your previous performance for a given
 
124
question, it ensures you do the absolute minimum number of reviews necessary
 
125
to continue to remember the material.
 
126
 
 
127
Why Anki?
 
128
---------
 
129
 
 
130
While there is no denying the huge impact SuperMemo has had on the field, it
 
131
is not without its problems. The program is often criticized for being buggy
 
132
and difficult to navigate. It only runs on Windows computers. It's proprietary
 
133
software, meaning end-users can't extend it or access the raw data. And while
 
134
very old versions are made available for free, they suffer from a number of
 
135
bugs.
 
136
 
 
137
Anki addresses these issues. You are not forced to pay for it, so stuggling
 
138
students and teachers with budgetary constraints are not left out. It's open
 
139
source, with an already flourishing library of plugins contributed by
 
140
end-users. It's multi-platform, running on Windows, Mac OSX, Linux/FreeBSD, and
 
141
some mobile devices. And it's considerably easier to use than SuperMemo.
 
142
 
 
143
Internally, Anki's spaced repetition system is based on an older version of
 
144
the SuperMemo algorithm called SM2. Subsequent versions have managed to
 
145
squeeze out a little more learning efficiency, but they come at the cost of
 
146
greatly increased complexity, and they are more susceptible to scheduling
 
147
errors in real-world use. For a more in-depth discussion of this and the
 
148
differences in scheduling algorithms, see the bottom of
 
149
http://ichi2.net/anki/wiki/FrequentlyAskedQuestions[the Anki FAQ].
 
150
 
 
151
Installing & upgrading
 
152
======================
 
153
 
 
154
Windows
 
155
-------
 
156
 
 
157
 - Download the installer from http://ichi2.net/anki/download/index.html[the
 
158
download page].
 
159
 
 
160
 - Double click on it to run it.
 
161
 
 
162
 - If you are upgrading, there is no need to uninstall the existing version of
 
163
Anki, but please close your current copy of Anki before trying to install the
 
164
new one.
 
165
 
 
166
 - If you want to run Anki from a USB stick, follow the instructions on
 
167
http://ichi2.net/anki/wiki/FrequentlyAskedQuestions[the Anki FAQ].
 
168
 
 
169
Mac OSX
 
170
-------
 
171
 
 
172
 - Download the DMG from http://ichi2.net/anki/download/index.html[the
 
173
download page].
 
174
 
 
175
 - Open it and drag the icon into your Applications folder.
 
176
 
 
177
 - If you want to run Anki from a USB stick, simply drag it to the USB stick
 
178
   instead.
 
179
 
 
180
 - Follow the same steps to upgrade to the latest version, but make sure
 
181
you've closed any running version of Anki first.
 
182
 
 
183
Linux/FreeBSD
 
184
-------------
 
185
 
 
186
The currently recommend method is to install Anki from source, or use the deb
 
187
on http://ichi2.net/anki/download/index.html[the download page] if you are a
 
188
Debian/Ubuntu user. You may find a version of Anki is included with your
 
189
distribution, but at the time of writing a number of distros include a very
 
190
old version of Anki that has a number of known bugs.
 
191
 
 
192
To install Anki from source, download the tarball from
 
193
http://ichi2.net/anki/download/index.html[the download page], extract it, and
 
194
read the README file.
 
195
 
 
196
Getting started
 
197
===============
 
198
 
 
199
Anki is basically a intelligent flashcard program. First, you add a series of
 
200
questions and answer pairs (called 'cards'). These cards are stored in a file
 
201
called a 'deck' (as in "deck of cards"). You can add cards by typing them in
 
202
yourself, importing them from a text file, or you can use a deck someone else
 
203
has shared. Once you have a deck with some cards in it, you can start
 
204
reviewing and improving your memory.
 
205
 
 
206
[[creating-own-deck]]
 
207
Creating your own deck
 
208
----------------------
 
209
 
 
210
The most effective way to use Anki is to create your own deck, by typing in
 
211
questions and answers yourself. For example, you hear a new word on TV and
 
212
decide you want to memorize it? Jot it down and add it to Anki when you have a
 
213
chance. You learnt the chemical formula for Sodium Hydroxide in your text book
 
214
and don't want to forget it? Type it into Anki. When Anki later shows you the
 
215
idea again, you will probably remember the context you learnt it in, leading
 
216
to a stronger memory.
 
217
 
 
218
*To create your own deck*:
 
219
 
 
220
 1. Open Anki.
 
221
 2. Choose File->New.
 
222
 
 
223
*To add a new card to your deck*:
 
224
 
 
225
 1. Click image:images/list-add.png[] on the toolbar.
 
226
 2. Enter the question on the 'Front' area and the answer on the 'Back'.
 
227
 3. Click 'Add', or press Ctrl+Enter (Command+Enter on a Mac).
 
228
 
 
229
You'll see a screen like the following:
 
230
 
 
231
image:images/addcards.png[]
 
232
 
 
233
'Front', 'Back' and 'Add' are the important elements for now - the rest we'll
 
234
return to later. Front is a required field, so it is marked yellow until you
 
235
input something. The back can be left blank, so it is not drawn in yellow.
 
236
 
 
237
Making questions
 
238
----------------
 
239
 
 
240
Turning a given idea into a question and answer pair is simple once you know
 
241
how.
 
242
 
 
243
For general knowledge
 
244
~~~~~~~~~~~~~~~~~~~~~
 
245
 
 
246
Imagine you've just heard the following sentence:
 
247
 
 
248
  Canberra was founded in 1913.
 
249
 
 
250
The easiest way to test this is to make a 'cloze deletion'.
 
251
 
 
252
 1. Type the above sentence into the 'Front'.
 
253
 2. Highlight '1913'.
 
254
 3. Click the >> button to reveal more options.
 
255
 4. Click the [...] button.
 
256
 
 
257
As an alternative to steps 3 & 4, you can just press F9.
 
258
 
 
259
You'll end up with:
 
260
 
 
261
image:images/cloze2.png[]
 
262
 
 
263
For languages
 
264
~~~~~~~~~~~~~
 
265
 
 
266
Imagine you're learning learning German and you hear the word 'bitte', meaning
 
267
"please". There are a number of ways to add this to Anki.
 
268
 
 
269
*As a word recognition card*:
 
270
 
 
271
Put 'bitte' on the front of the card, and 'please' on the back. When this card
 
272
appears later, you'll need to read the German word and decide if you knew the
 
273
meaning or not.  Recognition cards are easy to answer and will ensure you can
 
274
recognize the word when it pops up in the future.
 
275
 
 
276
*As a word recall card*:
 
277
 
 
278
Put 'please' on the front of the card, and 'bitte' on the back. When this card
 
279
appears later, you'll need to think of how to say please in German. Recall
 
280
cards are more difficult to answer, but will ensure you can produce the given
 
281
word yourself, rather than just recognize it. They are best used in the early
 
282
stages of learning, to reinforce basic grammar and core vocabularly. As your
 
283
knowledge of the language grows, recall cards become less practical, as
 
284
synonyms complicate matters.
 
285
 
 
286
*As a sentence recognition card*:
 
287
 
 
288
You can also add the full sentence you encountered to the front of the card,
 
289
optionally underlining the new word. On the back you can place a translation
 
290
of the full sentence, or just the target word. Adding the full sentence takes
 
291
more time, but means you're exposed to the word in actual use.
 
292
 
 
293
*As a sentence recall card*:
 
294
 
 
295
Sentence recall cards should be limited to core grammar or essential
 
296
phrases, as they are very difficult to answer correctly.
 
297
 
 
298
*As a combination of the above*:
 
299
 
 
300
It's possible to add more than one card at once by clicking on the button at
 
301
the top right of the 'Add Items' screen. This can be useful if you're learning a
 
302
language where reading a word is non-trivial, and you want to practice both
 
303
reading and producing the word.
 
304
 
 
305
Advanced input
 
306
~~~~~~~~~~~~~~
 
307
 
 
308
If you want to input audio, pictures, movies or scientific markup, please see
 
309
the dedicated section below about adding content.
 
310
 
 
311
Using a shared deck
 
312
--------------------
 
313
 
 
314
Using a shared deck saves you from having to type in information yourself.
 
315
This is more convenient, but is not always the optimal way to learn. Consider
 
316
the user in <<creating-own-deck>> who enters new words they hear on TV. To
 
317
them, simply looking at the word should be enough to remember the context it
 
318
was used in and the meaning, naunce, etc. But to a different person using this
 
319
shared deck, it is just a single word with no context or personal
 
320
significance.
 
321
 
 
322
That is not to say shared decks are useless. Shared decks that are used in
 
323
conjunction with third party material such as a textbook can be quite useful.
 
324
If you and the original sharer are studying the same textbook, then you both
 
325
has the same exposure to the original idea in context. 
 
326
 
 
327
Shared decks that include some context on the cards (such as full sentences)
 
328
can also be quite useful.
 
329
 
 
330
To browse shared decks:
 
331
 
 
332
 1. Click File->Download->Shared Deck.
 
333
 2. Type in a string to search for, or scroll through the list.
 
334
 3. Select a deck you're interested in, and click OK. The deck will be
 
335
 downloaded and will open up.
 
336
 
 
337
Reviewing
 
338
---------
 
339
 
 
340
When you have found a deck you like or entered some cards in, it's time to
 
341
start reviewing. If the 'Add Items' screen is still open, close it by clicking
 
342
on close or pressing Esc. You should see a screen entitled 'Study Options':
 
343
 
 
344
image:images/studyoptions-basic.png[]
 
345
 
 
346
In the above example, it says there are 6 new cards today, and 6 new cards
 
347
total. If you've downloaded a shared deck, there will probably be more than 20
 
348
new cards, but Anki will only show you 20 per day by default. You can adjust
 
349
this number by changing 'new cards per day', but be wary of setting it too
 
350
high or you'll have many reviews to do over the next few days.
 
351
 
 
352
When you're ready, click 'Start Reviewing'. You'll then see a screen like
 
353
this:
 
354
 
 
355
image:images/review1.png[]
 
356
 
 
357
Here you need to look at the question and think about the answer. It can help
 
358
to say the answer out loud, but that is not necessary. It's ok if it takes you
 
359
a little while to recall the answer, but as a general rule if you can't answer
 
360
within 10 seconds, you should give up.
 
361
 
 
362
When you're ready, click 'Show Answer' or press the spacebar. You'll see
 
363
something like the following:
 
364
 
 
365
image:images/review2.png[]
 
366
 
 
367
Now you need to decide how well you remembered. Anki gives you four options.
 
368
 
 
369
Adding material via anki
 
370
========================
 
371
 - best practices
 
372
 - all buttons / shortcuts
 
373
 - changing fonts
 
374
 - adding text to every card
 
375
 
 
376
Fonts and colours?
 
377
==================
 
378
x
 
379
 
 
380
 
 
381
Reviewing / main window
 
382
=======================
 
383
 - what you see on the main screen
 
384
 - what buttons to press (see next section)
 
385
 
 
386
 
 
387
Study options
 
388
=============
 
389
x
 
390
 
 
391
 
 
392
Browsing your deck
 
393
==================
 
394
x
 
395
 
 
396
Importing & Exporting data
 
397
==========================
 
398
 
 
399
Importing
 
400
---------
 
401
 
 
402
text files, mnemosyne, etc
 
403
 
 
404
Exporting
 
405
---------
 
406
 
 
407
...
 
408
 
 
409
Printing
 
410
--------
 
411
 
 
412
...
 
413
 
 
414
Card props
 
415
==========
 
416
x
 
417
 
 
418
Deck props
 
419
=========
 
420
x
 
421
 
 
422
Preferences
 
423
===========
 
424
x
 
425
 
 
426
Cramming
 
427
========
 
428
x
 
429
 
 
430
Graphs
 
431
======
 
432
x
 
433
 
 
434
Statistics
 
435
==========
 
436
x
 
437
 
 
438
 
 
439
Plugins
 
440
=======
 
441
 - japanese/chinese/german etc
 
442
 
 
443
 
 
444
Sharing decks/plugins
 
445
=====================
 
446
x
 
447
 
 
448
Priorities
 
449
==========
 
450
x
 
451
 
 
452
Inactive tags
 
453
=============
 
454
x
 
455
 
 
456
Synchronization
 
457
===============
 
458
x
 
459
 
 
460
Leeches
 
461
=======
 
462
x
 
463
 
 
464
Media support
 
465
=============
 
466
x
 
467
 
 
468
Progress bars
 
469
=============
 
470
x
 
471
 
 
472
Running from a usb driver
 
473
=========================
 
474
x