ГОСТ Р ИСО/МЭК 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 Гражданского кодекса Российской Федерации не являются объектами авторских прав официальные документы государственных органов и органов местного самоуправления муниципальных образований, в том числе законы, другие нормативные акты, судебные решения, иные материалы законодательного, административного и судебного характера, официальные документы международных организаций, а также их официальные переводы; государственные символы и знаки (флаги, гербы, ордена, денежные знаки и тому подобное), а также символы и знаки муниципальных образований; произведения народного творчества (фольклор), не имеющие конкретных авторов; сообщения о событиях и фактах, имеющие исключительно информационный характер (сообщения о новостях дня, программы телепередач, расписания движения транспортных средств и тому подобное).
Россия