Next: The label
Element, Up: Structure Member Format [Contents]
heading
Elementheading[root_heading] :creator-version? :creator? :creation-date-time? :lockReader=bool? :schemaLocation? => label pageSetup? (container | heading)* heading :creator-version? :commandName? :visibility[heading_visibility]=(collapsed)? :locale? :olang? => label (container | heading)*
A heading
represents a tree of content that appears in an
output viewer window. It contains a label
text string that is
shown in the outline view ordinarily followed by content containers or
further nested (sub)-sections of output. Unlike heading elements in
HTML and other common document formats, which precede the content that
they head, heading
contains the elements that appear below the
heading.
The root of a structure member is a special heading
. The
direct children of the root heading
elements in all structure
members in an SPV file are siblings. That is, the root heading
in all of the structure members conceptually represent the same node.
The root heading’s label
is ignored (see see The label
Element). The root heading in the first structure member in
the Zip file may contain a pageSetup
element.
The schema implies that any heading
may contain a sequence of
any number of heading
and container
elements. This does
not work for the root heading
in practice, which must actually
contain exactly one container
or heading
child element.
Furthermore, if the root heading’s child is a heading
, then the
structure member’s name must end in _heading.xml; if it is a
container
child, then it must not.
The following attributes have been observed on both document root and
nested heading
elements.
The version of the software that created this SPV file. A string of
the form xxyyzzww
represents software version xx.yy.zz.ww,
e.g. 21000001
is version 21.0.0.1. Trailing pairs of zeros
are sometimes omitted, so that 21
, 210000
, and
21000000
are all version 21.0.0.0 (and the corpus contains all
three of those forms).
The following attributes have been observed on document root
heading
elements only:
creator
¶The directory in the file system of the software that created this SPV file.
creation-date-time
¶The date and time at which the SPV file was written, in a
locale-specific format, e.g. Friday, May 16, 2014 6:47:37 PM
PDT
or lunedì 17 marzo 2014 3.15.48 CET
or even Friday,
December 5, 2014 5:00:19 o'clock PM EST
.
lockReader
¶Whether a reader should be allowed to edit the output. The possible
values are true
and false
. The value false
is by
far the most common.
schemaLocation
¶This is actually an XML Namespace attribute. A reader may ignore it.
The following attributes have been observed only on nested
heading
elements:
commandName
¶A locale-invariant identifier for the command that produced the
output, e.g. Frequencies
, T-Test
, Non Par Corr
.
visibility
¶If this attribute is absent, the heading’s content is expanded in the
outline view. If it is set to collapsed
, it is collapsed.
(This attribute is never present in a root heading
because the
root node is always expanded when a file is loaded, even though the UI
can be used to collapse it interactively.)
locale
¶The locale used for output, in Windows format, which is similar to the
format used in Unix with the underscore replaced by a hyphen, e.g.
en-US
, en-GB
, el-GR
, sr-Cryl-RS
.
olang
¶The output language, e.g. en
, it
, es
,
de
, pt-BR
.
Next: The label
Element, Up: Structure Member Format [Contents]