ГОСТ Р ИСО/МЭК 26300—2010/Раздел 12

ГОСТ Р ИСО/МЭК 26300—2010 «Информационная технология. Формат Open Document для офисных приложений (OpenDocument) v1.0» — Раздел 12

12 Общее содержимое

12.1 Аннотация

Элемент <office:annotation> задает аннотацию в формате OpenDocument. Текст аннотации содержится в элементах <text:p> и <text:list>.

<define name="office-annotation">
    <element name="office:annotation">
        <ref name="office-annotation-attlist"/>
        <ref name="draw-caption-attlist"/>
        <ref name="common-draw-position-attlist"/>
        <ref name="common-draw-size-attlist"/>
        <ref name="common-draw-shape-with-text-and-styles-attlist"/>
        <optional>
            <ref name="dc-creator"/>
        </optional>
        <optional>
            <ref name="dc-date"/>
        </optional>
        <optional>
            <ref name="meta-date-string"/>
        </optional>
        <zeroOrMore>
            <choice>
                <ref name="text-p"/>
                <ref name="text-list"/>
            </choice>
        </zeroOrMore>
    </element>
</define>

С элементом <office:annotation> могут быть связаны следующие атрибуты:

• отображение;
• положение, размер, стиль, слой, z-индекс, идентификатор, преобразование (см. раздел 9.2.15);
• текстовая привязка, фон таблицы, конечное положение рисунка (см. раздел 9.2.16);
• точка подписи, скругление углов (см. раздел 9.2.10).

Отображение

Атрибут office:display определяет, отображается аннотация или нет.

<define name="office-annotation-attlist" combine="interleave">
    <optional>
        <attribute name="office:display">
            <ref name="boolean"/>
        </attribute>
    </optional>
</define>

Атрибуты заголовка

Следующие атрибуты могут быть назначены элементу <office:annotation> для того, чтобы повлиять на отображение: svg:x, svg:y, svg:width, svg:height, draw:caption-point-x, draw:caption-point-y, draw:corner-radius, table:end-cell-address, table:end-x, table:end-y, text:anchor-type, text:anchor-page-number, draw:layer, draw:style-name, draw:text-style-name, draw:transform, draw:name, draw:z-index и draw:id. Их смысл тот же, как если бы они применялись к элементу <draw:caption> (см. раздел 9.2.10). Использование данных атрибутов не обязательно.

12.1.1 Автор

Необязательный элемент <dc:creator>, описанный в разделе 3.1.7, определяет автора примечания.

12.1.2 Дата и время создания

Необязательный элемент <dc:date>, описанный в разделе 3.1.9, задает дату и время создания примечания.

12.1.3 Строка даты и времени создания

Если приложение имеет только строку с датой и не может разобрать эту строку, то оно может записать ее в элемент <meta:date-string>.

<define name="meta-date-string">
    <element name="meta:date-string">
        <ref name="string"/>
    </element>
</define>

12.2 Формат чисел

Формат чисел для OpenDocument состоит из трех частей:

• префикс — текст отображаемый до числа;
• спецификация отображаемого формата, например, A, B, C, или 1, 2, 3;
• суффикс — текст, отображаемый после числа.

12.2.1 Префикс и суффикс

Атрибуты style:num-prefix и style:num-suffix определяют, что отображать до и после номера.

Если префикс и суффикс не содержат алфавитно-цифровых символов, то атрибут format [XSLT] может быть создан из атрибутов OpenDocument через объединение значений атрибутов style:num-prefix, style:num-format и style:num-suffix.

<define name="common-num-format-prefix-suffix-attlist" combine="interleave">
    <optional>
        <attribute name="style:num-prefix">
            <ref name="string"/>
        </attribute>
    </optional>
    <optional>
        <attribute name="style:num-suffix">
            <ref name="string"/>
        </attribute>
    </optional>
</define>

12.2.2 Спецификация формата

Атрибут style:num-format определяет формат чисел так же, как атрибут format [XSLT]. Поддерживаются следующие форматы номера:

• числовой: 1, 2, 3, … ;
• алфавитный: a, b, c, … или A, B, C, … ;
• римский: i, ii, iii, iv, … или I, II, III, IV, … .

Значение данного атрибута может быть «1», «a», «A», «i», или «I». Для некоторых элементов значение атрибута может быть пустым. В этом случае номер не отображается.

<define name="common-num-format-attlist" combine="interleave">
    <choice>
        <attribute name="style:num-format">
            <choice>
                <value>1</value>
                <value>i</value>
                <value>I</value>
                <ref name="string"/>
                <empty/>
            </choice>
        </attribute>
        <group>
            <attribute name="style:num-format">
                <choice>
                    <value>a</value>
                    <value>A</value>
                </choice>
            </attribute>
            <ref name="style-num-letter-sync-attlist"/>
        </group>
        <empty/>
    </choice>
</define>

12.2.3 Синхронизация букв в форматах номера

Если буквы используются в алфавитном порядке для нумерации, то существует два пути для обработки переполнения в рамках одного разряда символов, как описано ниже.

• Вставляется новый символ. Его начальное значение A, и добавление осуществляется каждый раз, когда невозможно определить следующее значение символа, не выходя при этом за рамки разряда. Последовательность нумерации в этом случае будет приблизительно такой a, b, c, …, z, aa, ab, ac, …, az, ba, … и т. д.
• Вставляемый символ всегда имеет то же значение, что и следующий символ. Последовательность нумерации в этом случае будет приблизительно такой a, b, c, …, z, aa, bb, cc, …, zz, aaa, … и т. д. Такой процесс называется синхронизацией букв.

Атрибут style:num-letter-sync определяет, будет ли производиться синхронизация букв.

<define name="style-num-letter-sync-attlist" combine="interleave">
    <optional>
        <attribute name="style:num-letter-sync">
            <ref name="boolean"/>
        </attribute>
    </optional>
</define>

12.3 Метаданные отслеживания изменений

Метаданные для отслеживания изменений содержатся внутри элемента <office:change-info>. Он содержит имя автора и дату создания отслеженного изменения, а в качестве дополнения — комментарий.

<define name="office-change-info">
    <element name="office:change-info">
        <ref name="dc-creator"/>
        <ref name="dc-date"/>
        <zeroOrMore>
            <ref name="text-p"/>
        </zeroOrMore>
    </element>
</define>

Автор

Элемент <dc:creator>, как описано в разделе 3.1.7, задает имя автора, который вносил поправки в документ.

Дата и время

Элемент <dc:date>, как описано в разделе 3.1.9, задает дату и время, когда имели место изменения.

Комментарий

Дополнительный комментарий может быть включен как элементы <text:p>.

12.4 Таблицы датчиков событий

Многие объекты, такие как элементы управления, изображения, текстовые блоки или целый документ, поддерживают события. Событие связывает наступление особого условия с действием, которое осуществляется в случае его возникновения. Например, если пользователь помещает курсор над изображением, в этом случае запускается некоторое действие, поддерживаемое офисным приложением. Это событие, называемое «on-mouse-over», может быть связано с макрокомандой, которая выполняется в момент достижения условия, то есть, когда пользователь помещает курсор над изображением.

XML-представление событий и таблиц событий имеет структуру, приведенную ниже.

• Все элементы событий, связанные с объектом, расположены в контейнерном элементе, называемом <office:event-listeners>.
• Каждая связь «событие-в-действие» регистрируется в одном <script:event-listener> элементе.
• В зависимости от вида действия, которое вызывает событие, используются следующие элементы:

— элемент <script:event-listener> представляет события, связанные с макрокомандой или скриптом;

— элемент <presentation:event-listener> представляет события, связанные с действием, характерным для презентации, например, перейти на следующую страницу (события презентации описаны в разделе 9.9).

Элемент <office:event-listeners> определяет таблицу событий,связанную с конкретным объектом.

<define name="office-event-listeners">
    <element name="office:event-listeners">
        <zeroOrMore>
            <choice>
                <ref name="script-event-listener"/>
                <ref name="presentation-event-listener"/>
            </choice>
        </zeroOrMore>
    </element>
</define>

12.4.1 Датчик событий

Элемент <script:event-listener> связывает событие с макрокомандой.

<define name="script-event-listener" combine="interleave">
    <element name="script:event-listener">
        <ref name="script-event-listener-attlist"/>
        <empty/>
    </element>
</define>

С элементом <script:event-listener> могут быть связаны следующие атрибуты;

• имя события;
• язык скрипта;
• имя и расположение макрокоманды.

Имя события

Атрибут script:event-name задает имя события. После того как события станут доступными, их имена и значения зависят от приложения и языка скрипта. Имени должен предшествовать префикс пространства имен, для того чтобы соответствующее пространство имен вместе с именем события могли быть использованы для идентификации семантики события. Для событий, определенных в событийной модели DOM, рекомендуется использовать имена событий, описанные в § 1.4.2 [DOMEvents]. Соответствующее пространство имен — "http://www.w3.org/2001/xml-events".

<define name="script-event-listener-attlist" combine="interleave">
    <attribute name="script:event-name">
        <ref name="string"/>
    </attribute>
</define>

Язык скрипта

Атрибут script:language определяет язык скрипта, в котором написан макрос или скрипт, связанный с событием (см. раздел 2.5.1).

<define name="script-event-listener-attlist" combine="interleave">
    <attribute name="script:language">
        <ref name="string"/>
    </attribute>
</define>

Имя и расположение макроса

Код макроса, который должен вызываться для события, может быть определен либо с помощью IRI нотации [XLink], или простым названием, описанным в атрибуте script:macro-name. Если используется XLink, то IRI может иметь произвольный протокол, например один, который кодирует название библиотеки макросов вместе с названием макроса, определенным в этой библиотеке. Как и XLink IRI, так и простое название зависят от языка скрипта.

<define name="script-event-listener-attlist" combine="interleave">
    <choice>
        <attribute name="script:macro-name">
            <ref name="string"/>
        </attribute>
        <group>
            <attribute name="xlink:href">
                <ref name="anyURI"/>
            </attribute>
            <optional>
                <attribute name="xlink:type" a:defaultValue="simple">
                    <value>simple</value>
                </attribute>
            </optional>
            <optional>
                <attribute name="xlink:actuate" a:defaultValue="onRequest">
                    <value>onRequest</value>
                </attribute>
            </optional>
        </group>
    </choice>
</define>

12.5 Математическое содержимое

Математическое содержание представлено MathML 2.0 (см. [MathML]).

<define name="math-math">
    <element name="math:math">
        <ref name="mathMarkup"/>
    </element>
</define>

<!-- To avoid inclusion of the complete MathML schema, anything -->
<!-- is allowed within a math:math top-level element            -->
<define name="mathMarkup">
    <zeroOrMore>
        <choice>
            <attribute>
                <anyName/>
            </attribute>
            <text/>
            <element>
                <anyName/>
                <ref name="mathMarkup"/>
            </element>
        </choice>
    </zeroOrMore>
</define>

12.6 DDE-соединения

Динамическая связь обмена данных (DDE) состоит из параметров для DDE целевого приложения, имени файла и командной строки. DDE-соединение принимает параметр, который определяет, будет ли оно обновлено автоматически или по запросу пользователя. Каждое DDE-соединение должно быть именовано.

Все элементы, использующие DDE-соединения, должны включать в себя их содержание (или их представление) так, чтобы документы, использующие DDE, могли должным образом отображаться на компьютерах, которые не поддерживают механизм DDE, или там, где цель DDE не доступна. Приложения должны сохранять информацию о DDE-соединении, даже если они не могут использовать его так, чтобы другие приложения могли использовать возможности DDE.

12.6.1 Контейнер описания DDE-соединения

В пределах текстовых документов и электронных таблиц описание DDE-соединения содержится в одном элементе объявления. Для текстовых документов элемент <text:dde-connection-decls> описан в разделе 4.7. Для электронных таблиц элемент <table:dde-links> описан в разделе 8.10.

12.6.2 Описание DDE-соединения для текстовых полей

Каждое DDE-соединение, используемое текстовым полем, описывается при помощи элемента объявления. Многократные поля DDE могут обращаться к одному DDE-соединению с использованием одного имени. Элемент описания не имеет никакого содержания.

<define name="text-dde-connection-decl">
    <element name="text:dde-connection-decl">
        <ref name="text-dde-connection-decl-attlist"/>
        <ref name="common-dde-connection-decl-attlist"/>
    </element>
</define>

С элементом <text:dde-connection-decl> могут быть связаны следующие атрибуты:

• имя соединения;
• целевое DDE-приложение;
• целевая DDE-тема;
• целевой DDE-объект;
• флаг автоматического обновления.

Имя соединения

Атрибут office:name задает имя соединения, к которому оно будет обращаться.

<define name="text-dde-connection-decl-attlist" combine="interleave">
    <attribute name="office:name">
        <ref name="string"/>
    </attribute>
</define>

Целевое приложение

Атрибут office:dde-application задает имя целевого приложения, которое будет использовано для DDE-соединения.

<define name="common-dde-connection-decl-attlist" combine="interleave">
    <attribute name="office:dde-application">
        <ref name="string"/>
    </attribute>
</define>

Пример —

Именем для приложений OpenOffice.org будет soffice. Поэтому внутренние DDE-ссылки имеют атрибут text:dde-application="soffice".

Целевая тема

Атрибут office:dde-topic задает имя темы, которое будет использовано для DDE-соединения.

<define name="common-dde-connection-decl-attlist" combine="interleave">
    <attribute name="office:dde-topic">
        <ref name="string"/>
    </attribute>
</define>

Пример —

Программное обеспечение OpenOffice.org интерпретирует тему DDE в качестве имени файла.

Целевой объект

Атрибут office:dde-item определяет информацию, которую должно предоставить целевое приложение.

<define name="common-dde-connection-decl-attlist" combine="interleave">
    <attribute name="office:dde-item">
        <ref name="string"/>
    </attribute>
</define>

Пример —

Если целевым DDE-приложением соединения является OpenOffice.org Writer, то элемент задает имя закладки. OpenOffice.org предоставляет запрашиваемое текущее содержание текста для приложения.

Автоматическое обновление

Офисные приложения по умолчанию автоматически обновляют DDE-ссылки. Если ручное обновление связи предпочтительнее, то атрибут text:automatic-update может использоваться для обновления ссылок DDE-соединения только по запросу пользователя.

Если значением атрибута является true, тогда от приложения ожидается автоматическое обновление DDE-ссылок. Если значение атрибута false, то DDE-ссылки обновляются только по запросу пользователя.

<define name="common-dde-connection-decl-attlist" combine="interleave">
    <optional>
        <attribute name="office:automatic-update" a:defaultValue="true">
            <ref name="boolean"/>
        </attribute>
    </optional>
</define>

12.6.3 Объявление DDE-соединений для таблиц

Данные DDE-соединений таблиц содержатся в элементе <office:dde-source>. Использование этого элемента различно для электронных таблиц и таблиц текстовых документов. Для таблиц текстовых документов элемент непосредственно содержится в элементе таблицы <table:table>. Для документов электронных таблиц он содержится в элементе <table:dde-link>, который описывает одиночное DDE-соединение.

Элемент <table:dde-link> состоит из элемента источника данных DDE <office:dde-source> и простого элемента таблицы, который может использоваться для кэширования данных источника DDE. Таблица не нуждается в названии и не содержит информацию о стиле. Используются только данные, содержащиеся в ячейке атрибутов. Сами ячейки остаются пустыми.

<define name="table-dde-link">
    <element name="table:dde-link">
        <ref name="office-dde-source"/>
        <ref name="table-table"/>
    </element>
</define>

Элемент <office:dde-source> поддерживает атрибуты office:dde-application, office:dde-topic, office:dde-item и office:automatic-update, как описано в разделе 12.6.2. В дополнение к этому, он поддерживает следующие атрибуты:

• имя соединения;
• режим преобразования.

<define name="office-dde-source">
    <element name="office:dde-source">
        <ref name="office-dde-source-attlist"/>
        <ref name="common-dde-connection-decl-attlist"/>
    </element>
</define>

Имя соединения

Атрибут office:name задает имя соединения, по которому к нему можно будет обращаться.

<define name="office-dde-source-attlist" combine="interleave">
    <optional>
        <attribute name="office:name">
            <ref name="string"/>
        </attribute>
    </optional>
</define>

Режим преобразования

Атрибут office:conversion-mode задает метод, по которому сервер DDE преобразует данные в числа. Существует три возможных значения:

• into-default-style-data-style — числа преобразуются в стиль данных, который выбран как стиль по умолчанию;
• into-english-number — числа преобразуются по умолчанию в английском формате;
• keep-text — числа не преобразуются и воспринимаются как текст.

<define name="office-dde-source-attlist" combine="interleave">
    <optional>
        <attribute name="office:conversion-mode"
                    a:defaultValue="into-default-style-data-style">
            <choice>
                <value>into-default-style-data-style</value>
                <value>into-english-number</value>
                <value>keep-text</value>
            </choice>
        </attribute>
    </optional>
</define>

Это произведение не охраняется авторским правом. В соответствии со статьёй 1259 Гражданского кодекса Российской Федерации не являются объектами авторских прав официальные документы государственных органов и органов местного самоуправления муниципальных образований, в том числе законы, другие нормативные акты, судебные решения, иные материалы законодательного, административного и судебного характера, официальные документы международных организаций, а также их официальные переводы; государственные символы и знаки (флаги, гербы, ордена, денежные знаки и тому подобное), а также символы и знаки муниципальных образований; произведения народного творчества (фольклор), не имеющие конкретных авторов; сообщения о событиях и фактах, имеющие исключительно информационный характер (сообщения о новостях дня, программы телепередач, расписания движения транспортных средств и тому подобное).