Using registries

Registries in SuperMemo are sorted sets of objects such as texts, pictures, fonts, templates, categories, tasklists, etc. Each registry is composed of registry members, which are named objects used by the collection. For example, image registry presented below is a set of image files sorted by image names:

registry.jpg (123222 bytes)

By using registries, SuperMemo minimizes the space used by multimedia files by making sure that each object is stored only once are reused by particular elements through the  access to particular registries (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.

The following are the types of registries used in SuperMemo:

  • 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 : Find word or with Search on the navigation toolbar). 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 : Data access
  • text registry stores all text strings used in the collection (including sound texts, RTF texts, HTML texts and Spell-Pad texts). Text registry is available with Search : Text registry
  • 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> registry (<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 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
  • image registry stores all images used by the collection (e.g. BMP, GIF, JPG, 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
  • video registry stores AVI video files. Video registry is available with Search : Other registries : Video
  • OLE registry stores OLE objects imported from other applications (such a an MS Word file or Excel Chart). OLE registry is available with Search : Other registries : OLE object
  • program registry stores external binary files executed by your collection (DLL, EXE as well as non-executable files that can be executed by an associated application available via Windows associations, e.g. HLP, MPEG, MOV, DOC, etc.). Program registry is available with Search : Other registries : Program
  • script registry stores all scripts used in the collection. Script registry is available with Search : Other registries : Script
  • font registry stores all non-default fonts used in the collection. Font registry is available with Search : Other registries : Font
  • template registry stores all templates defined in the collection. Unlike with other registries, you cannot link a template to an element or to a component. Instead, you apply a template to an element and replace the contents of a topic, item or task (read: Using templates). Template registry is available with Search : Templates. You can view the contents of templates on the right side of the template registry window
  • category registry stores all categories used by your collection. You can use this registry to delete, rename or edit categories. Most of all you will need this registry to change templates associated with a category. Category registry is available with Search : Categories
  • tasklist registry stores all tasklists associated with your collections (including the special case of tasklists: the reading lists). You can use this registry to add, delete, rename or edit tasklists. For example, you can use 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

It is worth noting that 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 : Find word (Ctrl+H).

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 folder 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 component pop-up 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