list
Represents an Escenic list. An
Escenic list is an ordered list of content items that are related in
some way (a list of articles related to an ongoing news issue, for
example). The content items in a list are represented by the
list
element's child content-ref
elements.
Syntax
<list name="text" id-ref="text"? (source="text" sourceid="text")? dbid="text"? exported-dbid="text"? unique-name="text"? action="(remove|insert)"? > <content-ref/>* </list>
Examples
This example imports a list called "important". The
source
andsource-id
attributes identify the section to which the list is to be added. This section must already exist in the database or appear before this element in the syndication file, as must the content items that are included in the list.<list source="ex" sourceid="s12" name="important"> <content-ref source="ex" sourceid="13"/> </list>
Attributes
name="
text"
-
The name of this list.
id-ref="
text"
(optional)-
The
id
of the section to which this list is to be added. If this attribute is specified, asection
element with anid
attribute that matches this attribute must appear somewhere before thislist
element in the syndication file.If
dbid
orsource
andsourceid
are specified, then this attribute is ignored. source="
text"
(optional)-
The
source
of the section to which this list is to be added. If this attribute is specified, thensourceid
must also be specified. One of the following two conditions must be satisfied:-
The target publication must already contain a section with
source
andsourceid
attributes that matchsource
andsourceid
, or -
A
section
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thislist
element in the syndication file.
If
dbid
is specified, thensource
andsourceid
are ignored. -
sourceid="
text"
(optional)-
The
sourceid
of the section to which this list is to be added. If this attribute is specified, thensource
must also be specified. One of the following two conditions must be satisfied:-
The target publication must already contain a section with
source
andsourceid
attributes that matchsource
andsourceid
, or -
A
section
element withsource
andsourceid
attributes that matchsource
andsourceid
must appear somewhere before thislist
element in the syndication file.
If
dbid
is specified, thensource
andsourceid
are ignored. -
dbid="
text"
(optional)-
The
dbid
of the section to which this list is to be added. If this attribute is specified then one of the following two conditions must be satisfied:-
The target publication must already contain a section with a
dbid
attribute that matches this attribute, or -
A
section
element with adbid
attribute that matches this attribute must appear somewhere before thislist
element in the syndication file.
-
exported-dbid="
text"
(optional)unique-name="
text"
(optional)-
The
unique-name
orname
of the section to which this list is to be added. If this attribute is specified, then one of the following conditions must be satisified:-
The target publication must already contain a section with a
uniquename
orname
attribute that matches this attribute, or -
A
section
element with aunique-name
orname
attribute that matches this attribute must appear somewhere before thislist
element in the syndication file.
If this is not the case, or if there is a matching
name
attribute but it is not unique, then import will fail.If
dbid
orsource
andsourceid
orid
are specified, then this attribute is ignored. -
action="
(remove|insert)"
(optional)-
Determines what action is taken during import if the section page already exists.
Allowed values are:
remove
-
The list is cleared before import.
insert
(default)-
The list is not cleared before import: new entries are simply appended to the list.