Defining Shared Resources

The shared publication resources are XML files called story element types and storyline templates. Story element types define block level elements such as paragraphs, images, headlines and so on. Storyline templates define particular types of story in terms of the story element types they can or must contain.

Shared publication resources are not an absolute requirement for creating publications, whether or not you need them depends on what kind of story content types your publications are to contain. Story is the term generally used to denote a "text heavy" content type in CUE: content items such as news stories, opinion pieces, magazine articles and so on, as opposed to media content items such as images and videos. CUE supports two types of story content type: native CUE stories (which depend on shared resources) and Escenic legacy stories (which do not). Although CUE supports both types of story, Escenic legacy stories are primarily supported for reasons of backwards-compatibility. For more information about the differences between native CUE stories and Escenic legacy stories, see Shared Resources.

The recommended choice for new publications is to use native CUE stories, in which case you will need to define a set of shared resources and upload them. You might also want to create a publication that supports both kind of story, so that you can mix existing legacy stories with new native CUE stories.

The Content Store installation includes a starter pack with a set of ready-to-use shared resources. These may be a sufficient starting point for many uses, although if you use a language other than English in your CUE user interface, then you will at least want to translate the labels in the starter pack resource files.

You will find the starter pack in the engine-installation/contrib/starter-pack folder. If you want to use them without modification, simply upload them to the Content Store using the escenic-admin web application, as described in [to be supplied ??].

If you need to translate the labels in the files first, open each file in a text editor and search for the following two strings: <ui:label> and <ui:description>. Translate the content of these elements and leave everything else unmodified.

If you want to make other changes to the shared resources, or create shared resources of your own, then you will need to read Shared Resources first.