Using registries

From SuperMemo Help
Jump to navigation Jump to search

Introducing SuperMemo registries

Registries in SuperMemo are sorted sets of objects such as texts, pictures, fonts, templates, categories, tasklists, stylesheets, etc. Each registry is composed of a set of registry members, which are named objects used by the collection.

Important! Registries in SuperMemo have nothing to do with the Windows registry (SuperMemo have been using registries before the release of Windows 95)!

The picture below presents an exemplary registry window with a registry toolbar at the top and a registry menu button at the leftmost:

SuperMemo: Image registry which you can use to review images used in your collection

An image registry is a set of image files sorted by image names. The picture presents a typical image registry. There are 9095 images in the registry (as displayed in the caption). Two images inguinal canal (fascia removed) and inguinal canal (posterior internal) are selected for further processing. Image names are displayed on the left. The currently displayed picture is one of inguinal canal (posterior internal). Individual elements in SuperMemo can focus on small portions of this large picture (e.g. external iliac vessels, inferior epigastric vessels, etc.). The list of elements using a given picture can be displayed at the bottom by clicking List. The status bar displays selected information about the current image. It is the 3794th image in the alphabetical order. It is used by 23 elements (items or topics). It is located on physical position 7691 in the registry. It occupies the file slot 235539 in the ELEMENTS subfolder. Its path and filename in the element folder is displayed next. The file is 90,455 bytes large. It was imported or created on Feb 02, 2008 at 7:12 am.

By using registries, SuperMemo minimizes the space used by multimedia files by making sure that each object is stored only once and used by as many elements as necessary (through the access to the registry via so-called registry links). For example, if you import an image file into an image component of a given element (using Import file), you can later link the same image file with another image component by means of Links : Registry member. By default, the name is the same as the original image filename, but you can change it at import or later on (e.g. with Alt+R if the image component is the current component).

Registries used by SuperMemo

These are registries used by SuperMemo (in order of importance):

  • text registry - stores all texts used in the collection (including sound texts, RTF texts, HTML texts and Spell-Pad texts). Text registry is available with Search : Texts (Ctrl+Alt+X)
  • lexicon registry - stores words used in the collection and keeps the record of text registry members that use a given word. Lexicon registry is available with Search : Lexicon. If your collection is very large or includes long texts, you may want to speed SuperMemo up by unchecking Compile lexicon on-the-fly in Tools : Options : Access. If you do not compile the lexicon in real time, you can build it with File : Repair collection by checking Rebuild lexicon
  • image registry - stores all images used by the collection (e.g. BMP, GIF, JPEG, PNG, etc.). Image registry is available with Search : Images
  • sound registry - stores all sounds used by the collection (e.g. WAV, MID, MP3, RMI, etc.). Sound registry is available with Search : Sounds
  • template registry - stores all templates defined in the collection. You cannot link a template to a component. Instead, you apply a template to an element to change its appearance. Template registry is available with Search : Templates. You can view the templates on the right in the template registry window. Read more: Using templates
  • category registry - stores all categories used by your collection. You can use this registry to delete, rename or change the properties of categories. Most of all you will need this registry to change templates associated with a category. Category registry is available with Search : Categories. Read more: Using categories
  • tasklist registry - stores all tasklists associated with your collections. You can use this registry to add, delete, rename or edit tasklists. For example, you can change the category in which tasks will be stored and the archive where the tasks will be moved after choosing Dismiss. Tasklist registry is available with Search : Tasklists. Read more: Tasklist manager
  • reference registry - stores all references used in the collection. Reference registry is available with Search : References
  • font registry - stores fonts that can be used in text components. Font registry is available with Search : Other registries : Font
  • translation registry - stores translation texts that correspond with the text registry in the currently selected translation language (Tools : Options : Language : Collection translation). Translation registry, if created, is available with Search : Other registries : <Language> translation (<Language> here is the name of the translation language, e.g. French, Swahili, Spanish, etc.). Current translation registry language can be changed with Tools : Options : Language : Collection translation
  • phonetic transcription registry - is the only twin registry that is built of two conjunct registries: one containing individual words and the other containing their respective phonetic transcriptions. Transcription registry, if installed, is available from Search : Other registries : Pronunciation by word (individual words) or Search : Other registries : Pronunciation by sound (transcriptions). You can select a transcription registry suitable to a given language with Tools : Options : Language : Phonetic transcription
  • comment registry - stores comments used in the collection. Note that comments used in references are not stored in the comment registry. They are stored in the text registry along all other reference texts. Reference comments are comments on processed articles, while element comments are your private notes on articles, elements, learning process, etc. If you develop collections for others, treat reference comments as public comments, and element comments as your private comments. You can easily delete all element comments from a collection by deleting comments registry. Comments registry is available with Search : Other registries : Comment
  • video registry - stores video files. Video registry is available with Search : Other registries : Video
  • binary registry - stores all kinds of files used by your collection (DLL, EXE, HLP, MPEG, MOV, DOC, PDF, etc.). Binary registry is available with Search : Other registries : Binary
  • style registry - holds stylesheets used to format HTML texts. Style registry is available with Search : Other registries : Style
  • script registry - stores all scripts used in the collection. Script registry is available with Search : Other registries : Script
  • OLE registry - stores OLE objects imported from other applications (such as a Word file or Excel chart). OLE registry is available with Search : Other registries : OLE object

More about SuperMemo registries

The lexicon registry stores all words used in a collection. The difference between the lexicon registry and the remaining registries is that individual words are not stored as links to a registry; therefore, deleting a word from the lexicon registry does not delete it from the collection. Instead, this word becomes unavailable from Search : Lexicon. Newer versions of SuperMemo do not automatically build the lexicon for performance reasons. To build a lexicon check Rebuild lexicon while running File : Repair collection. Note that this process takes very long even for smaller collections.

Text translations are also stored as registries. These are equivalent to text registries and can be easily replaced by means of copying and renaming registry files. For example, if you have translated your collection to German by creating a translation registry called German, you can copy German.* to text.* in the REGISTRY subfolder and your original texts in the collection will be replaced with their translations to German (note that you will need to rebuild the lexicon in order to generate a lexicon of German words).

Components which use particular registry objects store only registry references, not objects themselves. For example, a sound component may store a reference to a sound registry for its sound file, and to text registry for its text. This approach makes sure that large objects (e.g. video files) can be reused without wasting disk space. Each time you import an new object with Import file on the Component menu, you add it to the appropriate registry. Similarly, each time you type a new text to text, spell-pad or sound components, you add it to the text registry.

Each time you link a registry member with Links : Registry member, the reference count of this particular member is incremented. In other words, SuperMemo knows how many components in the collection use that particular member. If you delete the last reference to a particular member, i.e. its reference count drops to zero, the corresponding registry object will be deleted with or without confirmation. For example, if the last component using a given image is deleted, you will be asked if you want that image to be removed from the image registry. However, if the last reference to a given text is deleted from the collection, its corresponding registry member will be deleted without confirmation