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 Scene7 Publishing System.
  • 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 Scene7 Publishing System 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. Scene7 Publishing System 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 Scene7 Publishing System labels defined.

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

On this page