Translating collection

From SuperMemo Help
Jump to navigation Jump to search

You can translate SuperMemo collections to any language:

Creating translation registry

To translate your collection to a foreign language start with creating a translation registry:

  1. Choose File : Level : Professional
  2. Choose Toolkit : Options : Language
  3. At Collection translation type the name of the language
  4. Close the Options dialog by choosing OK (this will create an empty translation registry)
  5. Translate the collection using either interactive translation (simpler and more reliable but requiring the use of SuperMemo) or using text files (easier in teams and not requiring the translators to know or use SuperMemo)

Interactive translation (single translator)

To proceed with interactive translation of your collection do the following (recommended for an individual translator):

  1. Make sure that no repetitions have been done in your collection (pending queue will be used to proceed in the optimum translation sequence)
  2. Make sure the translation registry for your language has been created (i.e. that you passed all steps from the previous paragraph). You can see translation registry files at <SuperMemo folder>\SYSTEMS\<your collection name>\TRANSLAT\<translation language>.*
  3. Go to the first element in the collection
  4. Use Alt+PgUp and Alt+PgDn to move between pages (or Ctrl+G to jump to a specific page; note that element numbers may be unrelated to the order of elements in the knowledge tree)
  5. On each page, locate all text components and use Ctrl+click to open the translation dialog box for each. Only plain text, RTF, and spell-pad components will react to Ctrl+click with opening the translation dialog box
  6. Type in the translation in the lower pane (the original stays unchanged in the upper pane). Note that the texts you have translated in earlier pages will already be translated
  7. See useful tips below for more information

Translation in text files (team translation)

To proceed with translation in text files do the following (recommended for team translation):

  1. Make sure the translation registry for your language has been created (i.e that you passed all steps from the paragraph devoted to creating the translation registry). You can see translation registry files at <SuperMemo folder>\SYSTEMS\<your collection name>\TRANSLAT\<translation language>.*
  2. Decide which branches of the knowledge tree in the Contents window should be translated by individual translators
  3. Create subset files for each branch. For this purpose do the following:
  4. Export individual branches as text files with File : Export : Translation:
    • choose Sorting : By occurrence
    • choose Output texts : Not translated
    • choose Output elements : Subset
    • use Browse to select the subset files created in the previous step
    • leave Do not output duplicated entries unchecked
    • leave Output context checked
  5. Let the translators replace ??? strings in exported text files with appropriate translations (do not change anything else in the file!)
  6. As soon as individual translated files are becoming available, import them with File : Import : Translation
  7. Note that the same strings translated differently by different authors will be merged. This is not an error-proof procedure and you will have to manually resolve the import conflicts. File : Import : Translation will generate a report with all merged entries listed. The fastest way to resolve merged strings is:
    • copy the original string from the import report file to the clipboard
    • using Search : Texts, paste the string in the search input box
    • correct the translation directly in the text registry as it appears on the screen
SuperMemo: Translation registry stores translation texts that correspond with the text registry in the currently selected translation language

Useful tips

  1. In most elements, you can use PgDn and PgUp instead of Alt+PgUp and Alt+PgDn
  2. Do not change the original texts in text files, even if you find mistakes! Otherwise, your translation will not be importable to your mother collection
  3. You can easily review, search for and change translations by using Search : Other registries : <Language> translation. The same can be accomplished with Search : Texts with this difference that search and sorting will concern only the original texts
  4. The percent of the work done can be viewed in the caption of the translation registry (Search : Other registries : <Language> translation)
  5. When working in a team, try to minimize the differences in translating individual entries by frequently exporting and importing back partly translated files. This will also reduce the duplicated effort of translators working on different branches
  6. To see untranslated entries in the text registry (Search : Texts), you can choose Subset : Select untranslated on the registry menu. Untranslated members will be displayed as a registry subset