Managing page labels managing-page-labels

There are two places in the viewer user interface where page labels are shown: thumbnails mode and the table of contents drop-down.

There are three types of labels that can be defined:

  • Labels defined by the author using SYMBOL localization mechanism.
  • Labels defined by the author on the backend, inside Dynamic Media Classic.
  • Labels automatically generated by the viewer.

SYMBOL-based labels are defined using MediaSet.LABEL_XX[_YY] and MediaSet.LABEL_DELIM SYMBOLs as described in Localization of user interface elements. You can define such labels either for the entire ecatalog spread, in which case you should use short SYMBOL syntax ( MediaSet.LABEL_XX). Or, specify it for each page individually using full SYMBOL syntax ( MediaSet.LABEL_XX_YY).

When you define labels for both pages in the ecatalog spread, the viewer concatenates these labels into one string using MediaSet.LABEL_DELIM SYMBOL. SYMBOL-based labels take precedence over labels that are defined on the backend or automatically generated labels by the viewer.

Labels defined in Dynamic Media Classic are stored in the UserData record of individual page images. Same as with SYMBOL-based labels. That is, if both pages in the ecatalog spread have labels defined, they are concatenated using MediaSet.LABEL_DELIM SYMBOL in landscape mode. Dynamic Media Classic labels take precedence over automatically generated labels, but are overridden by SYMBOL-based labels.

Automatically generated labels are sequential numbers assigned to all pages in the ecatalog. Automatically generated labels are ignored for the given spread if it has SYMBOL-based labels defined or Dynamic Media Classic labels defined.

In the table of contents, it is possible to disable the display of automatically generated labels using showdefault parameter.