Справочник вывода HTML для проектирования шаблонов

Создание документов в формате HTML с помощью Rational Publishing Engine.

Назначение

Создание документа HTML из шаблона.

Поддерживаемые программы просмотра содержимого

Для просмотра списка продуктов, поддерживающих этот тип вывода, выполните следующие действия:
  1. Откройте Системные требования для Rational Publishing Engine .
  2. В разделе По типу выберите Программное обеспечение.
  3. Найдите раздел Программы просмотра содержимого. Перечислены названия и версии продуктов, в которых можно просмотреть вывод Rational Publishing Engine.

Элементы шаблона

Табл. 1. Элементы шаблона, которые можно использовать для вывода в формате HTML
Элемент Описание Может содержать другие элементы Может содержать данные
Значок абзаца Абзац Используется для группировки раздела элементов. Добавляет символы возврата каретки вокруг своих дочерних элементов в выводе. Да Нет
Значок контейнера Контейнер Используется для группировки раздела элементов. К нему не может быть применен стиль, и он не влияет на форматирование вывода.
При использовании внутри других элементов дочерние элементы, доступные для использования в контейнере, могут быть ограничены. Например:
  • Внутри строк контейнеры могут содержать только ячейки
  • Внутри списков контейнеры могут содержать только элементы подробных сведений списка
Да Нет
Значок текста Текст Содержимое выводится с одинаковым заданным форматированием. Нет Да
Значок текст со стилем Текст со стилем Блок текста, который может иметь уникальное форматирование отдельных слов. Используйте жирный шрифт, курсив, подчеркивание, зачеркивание или форматирование цветом для выделенных слов в элементе. Текст статичен. Нет Да
Значок гиперссылки Гиперссылка Создает гиперссылку в выводе. Гиперссылка может указывать на расположение внутри документа или внешнее расположение. Нет Да
Значок изображения Изображение Отображает изображение .gif, .png, .jpg, emf или wmf в выводе. Разработчик отчета может указать путь к изображению в шаблоне, или создатель отчета может указать путь во время выполнения. Нет Да
Значок таблицы Таблица Создает таблицу в выводе. Таблица может содержать строки или элементы контейнера. Да Нет
Значок строки Строка Создает строку в текущей таблице. Да Нет
Значок ячейки Ячейка Создает ячейку в текущей строке текущей таблицы. Да Нет
Значок списка Список Создает маркированный или нумерованный список в выводе. Да Нет
Значок подробных сведений списка Подробные сведения списка Создает элемент списка в текущем списке в выводе. Да Нет
Значок конфигурации источника данных Конфигурация источника данных См. Добавление элемента конфигурации источника данных. Нет Нет
Значок включаемого файла Включаемый файл Включает в вывод указанный файл как поле INCLUDETEXT.
  • Включаемый файл может иметь расширение .doc, .docx, .txt или .rtf.
  • В случае вывода Microsoft Word включаемый файл отображается после обновления всех полей с помощью макроса.
  • Для вывода Legacy PDF, HTML и XSL-FO включаемый файл является гиперссылкой на документ.
Нет Да
Значок закладки Закладка Определяет закладку в документе. Именем сгенерированной закладки является содержимое элемента закладки. При генерации документов Rational Publishing Engine генерирует уникальное имя для каждой закладки. Имя состоит из указанного во время проектирования имени и уникального идентификатора, сгенерированного во время выполнения. Нет Да
Значок разрыва страницы Разрыв страницы Добавляет разрыв страницы в вывод. Нет Нет
Значок разрыва раздела Разрыв раздела Добавляет разрыв раздела в вывод. Нет Нет
Значок оглавления Оглавление Добавляет оглавление в вывод. Нет Нет

Свойства элемента

Информация о настройке свойств элементов в шаблонах для создания документов HTML.
Табл. 2. Свойства ячейки
Свойства ячейки Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Выравнивание ячейки Это свойство задает положение текста в ячейке.
Ширина ячейки Можно указать ширину ячеек в пикселах, пунктах или процентах.
Табл. 3. Свойства подписи рисунка
Свойства подписи рисунка Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Код поля Это свойство нельзя использовать для данного формата вывода.
Табл. 4. Свойства изображения
Свойства изображения Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Содержимое Поддерживаемые форматы изображений:
  • Internet Explorer: .bmp, .emf, .gif, .jpg, .png, .svg (версия 9 или более поздняя), .wmf
  • Firefox: .bmp, .gif, .jpg, .png, .svg
Табл. 5. Свойства элемента списка
Свойства элемента списка Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Табл. 6. Свойства номера страницы
Свойства номера страницы Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Табл. 7. Свойства абзаца
Свойства абзаца Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Выравнивание абзаца Расположение текста на странице с определенным выравниванием.

по левому краю, по правому краю и по центру создает неровные края абзаца. Абзац заполняется максимальным количеством слов. Выравнивание по обоим краям создает ровные края абзаца путем вставки дополнительных пробелов между словами на всех строках кроме последней. Значение распределенное похоже на по обоим краям. Разница лишь в том, что пробелы также вставляются между словами последней строки абзаца.

Управление повисшими строками и словами Это свойство нельзя использовать для данного формата вывода.
Табл. 8. Свойства строки
Свойства строки Примечания
Разбивать строку на страницы Это свойство нельзя использовать для данного формата вывода.
Табл. 9. Свойства таблицы
Свойства таблицы Примечания
Автоподбор размера по содержимому Размер таблицы определяется содержимым ячеек. При использовании этого свойства также следует присвоить свойству Изменять размер по содержимому значение да.
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Расстояние между ячейками Это свойство нельзя использовать для данного формата вывода.
Фиксированная ширина ячеек в столбце Задает фиксированную ширину ячеек столбца (в пикселах).
Изменять размер по содержимому Когда этому свойству присвоено значение да, строки не разрываются, если нет пробела. Когда нет пробела, строки не разрываются, и ширина столбца увеличивается до ширины текста. Если свойство автоподбор размера по содержимому задано, свойству изменять размер по содержимому должно быть присвоено значение да.

Когда это свойство равно нет, ширина столбца фиксированная и строки разрываются вне зависимости от длины текста и наличия пробелов. Кроме того, свойство автоподбор ширины таблицы не учитывается.

Автоподбор ширины таблицы Когда этому свойству присвоено значение Да, ширина таблицы определяется шириной страницы. Когда и свойство изменять размер по содержимому равно Да, ширина ячеек не учитывается и размер таблицы определяется содержимым ячеек.

Значение свойства фиксированная ширина столбца указывать нельзя. Следует использовать свойство фиксированная ширина ячейки.

Табл. 10. Свойства названия таблицы
Свойства названия таблицы Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Код поля Это свойство нельзя использовать для данного формата вывода.
Табл. 11. Свойства текста
Свойства текста Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.
Табл. 12. Свойства общего числа страниц
Свойства общего числа страниц Примечания
Ширина рамки Для создания рамки в данных вывода должна быть указана ширина рамки.

Элемент Включаемый файл

Можно или связать файл или физически встроить файл в выходной документ. Однако, способ обработки элементов Включаемый файл зависит от формата вывода и расположения, из которого извлекается файл. Для устаревших выходных данных PDF, HTML и XSL-FO в качестве файла всегда добавляется гиперссылка.

Стили заголовков

Для применения предопределенных стилей заголовков HTML (H1, H2, ... , 9) используйте имя стиля 1, 2 - 9.

Стили Rational Publishing Engine или внешние стили?

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

Данные Unicode в выводе

Выводятся все данные Unicode, если для используемого шрифта поддерживается Unicode. Если шрифт, отличный от Unicode, применяется для вывода HTML, то после генерации документа измените семейство шрифтов в таблице стилей.

Объекты OLE

Из атрибутов источника данных можно извлечь встроенные объекты, например объекты OLE. Объекты OLE всегда обрабатываются как изображения в выводе HTML, поскольку этот формат не поддерживает объекты OLE.

Списки в абзацах

В случае разработки шаблонов, предназначенных для создания вывода HTML, следует избегать вложенных элементов списка в элементах абзацев.

Списки наследуют набор свойств форматирования, который может конфликтовать с отдельными свойствами абзаца. Например, свойства абзаца, такие как цвет фона и границы, изменяются, если абзац содержит список. Разместите элементы списков в шаблоне после элементов абзацев, чтобы избежать таких неполадок.


Комментарии