In AskiaSurf, caption libraries allow you to define lists of words or phrases that you consider synonymous. These synonyms you have defined will then be treated as equivalent during reconciliation. For example, you might define Don't know, DK and NR to be treated the same, and they will be treated as being equivalent.
If you have caption libraries defined, you will be asked when reconciling whether you want to apply them. If you do, the caption libraries dialog will open, allowing you to apply one or more libraries. See applying caption libraries to a wave for details.
You can manage caption libraries from the caption libraries dialog. In the edit menu, select caption libraries. The caption libraries dialog appears:
The left-hand list shows the available libraries.
The middle list shows the sets of caption groups. A caption group is a set of equivalent words or phrases. For example, you might define caption group for phrases equivalent to "don't know".
The right-hand list shows the captions in the currently-selected group.
To set up a library, you will need to create a new library, then create one or more caption groups, define the phrases within them, then copy these into a library.
To add a new library, click + below the list. When you initially create a library, it has no groups inside it. You can rename the library by clicking the name and typing a new one.
To remove an existing library, select it in the list, and click -.
Note that any libraries that are checked (selected) will be applied during reconciliation.
If a library contains groups, they are shown beneath it, along with the labels within each group. You can hide the labels by double-clicking the group name (double-click again to reveal them), and hide the groups within a library by double-clicking the library name (double-click again to reveal them).
To remove a group, select it and then click - below the library list.
To add a group, simply click + below the groups list, and type a name for the group (e.g. "don't know"). Once you have added a group, you then need to add labels to it, as described below. You can rename a group by clicking the name and typing a new one.
To remove a group, select it and click - below the groups list.
When you have defined a group, and want to add it to a library, select the library in the left-hand list, then select the group in the middle list, and click add group to selected library:
A group should consist of two or more labels. One is the base label (the main caption that the others are equivalent to) and the others are known as duplicates.
To add labels to a group, select the group in the middle list. Then for each label, click + beneath the label list and type the label text. You should set one label as the base. To do so, select it, and, at the right-hand edge of the dialog, click make the selected caption the base caption for the group:
To delete a label, select it and click -.
When you reconcile a wave, you will be asked if you want to apply a caption library during the reconciliation. If you answer yes, the caption libraries dialog opens. You can then select one or more libraries from the left-hand list. You can also make changes to the contents of libraries, as described in managing caption libraries.
Note that you can also manually apply caption libraries when in the reconciliation view, selecting a wave, then selecting apply caption libraries from the edit menu.
It is possible to share your caption libraries with co-workers. To share a library, you need to export it; this creates an XML file that you can then import on another computer that is running AskiaSurf.
To export a caption library, in the edit menu select caption libraries. Click export, and select an appropriate location and file name for the XML file.
To import a caption library, in the edit menu select caption libraries. Click import and select the XML file.