В пакете шаблона по умолчанию файл docpart_templates.html определяет библиотеку и некоторые шаблоны деталей документа по умолчанию. В библиотеке шаблонов деталей документа создайте детали документа, которые необходимо повторно использовать в отчете. Шаблон детали можно создать для любой части документа, которую необходимо повторить, не переопределяя его программно.
Шаблон детали документа обычно состоит из фиксированного содержимого и отверстий. Он также может включать элементы макета страницы, которые описывают размер страницы, поля и ориентацию, а также верхние и нижние колонтитулы страницы. Библиотеки шаблонов деталей документов PDF создаются с использованием элементов HTML DOM API, предоставляемых для этой цели, и подмножества элементов HTML.
Этот рабочий процесс используется для работы с библиотекой шаблонов деталей документа.
Распакуйте пакет шаблонов, содержащий файл библиотеки шаблонов деталей.
Откройте файл шаблонов деталей документа с именем docpart_templates.html по умолчанию в HTML или текстовом редакторе.
При необходимости отредактируйте файл с помощью элементов, описанных в разделе Структура библиотеки шаблонов деталей документа PDF.
Добавление любых стилей, поддерживающих шаблоны деталей документа в .css в пакете шаблонов. См. раздел Изменение стилей в шаблонах PDF.
Сохраните отредактированные файлы библиотеки.
Переупаковка шаблона с помощью ziptemplate.
Библиотека деталей документа создается с помощью <dplibrary> элемент. Добавить <dplibrary> элемент внутри <body> элемент в вашем docpart_template.html файл. Ваш пакет шаблона может иметь только один <dplibrary> элемент.
Использовать <dptemplate> элементы внутри <dplibrary> элемент для каждого шаблона детали документа, который требуется создать. Можно создать столько шаблонов деталей документов, сколько потребуется.
Этот код показывает основную структуру библиотеки деталей документа. <dptemplate> элемент имеет атрибут name, для которого задано имя, используемое для вызова детали документа. Имя эквивалентно имени детали в коллекции быстрых деталей в Word. При создании шаблонов для нескольких выходов используйте одно и то же имя в обоих местах.
<body>
<dplibrary>
<dptemplate name="myFirstDocPartTemp">
[Document part template content here--
holes, fixed content, page layout information, and HTML]
</dptemplate>
</dplibrary>
</body>
Для создания шаблонов деталей документов PDF можно использовать HTML-элементы DOM API и подмножество стандартных HTML-элементов. Примеры использования HTML-элементов DOM API см. в следующих разделах:
В дополнение к <dplibrary> и <dptemplate> элементы, используемые для определения библиотеки и деталей документа, можно использовать эти HTML-элементы DOM API в шаблонах PDF.
| Цель | Элемент | Признаки | Ценности |
|---|---|---|---|
| Макет страницы | layout | style
|
|
first-page-number | Количество первых страниц в макете | ||
page-number-format | n или N для числовых, a, A, i, I
| ||
section-break | Где начать раздел для этого макета: Odd Page, Even Page, или Next Page | ||
| Заголовок страницы | pheader | type | default, first, even |
template-name | Шаблон детали документа, определяющий заголовок | ||
| Нижний колонтитул страницы | pfooter | type | default, first, even |
template-name | Шаблон детали документа, определяющий нижний колонтитул | ||
Формат номера страницы (такой же, как first-page-number и page-number-format на макете) | pnumber | format | n или N для числовых, a, A, i, I
|
initial-value | Номер первой страницы в макете, использующем этот элемент | ||
| Отверстие | hole | id | Идентификатор, определяющий отверстие по имени |
default-style-name | Стиль таблицы стилей, используемый, когда стиль не задан программным способом | ||
| Содержание | toc | number-of-levels | Количество уровней заголовков, включаемых в ТОС |
leader-pattern | Образец выноски для использования: dots, space, точка или пробел | ||
| Автоматическая нумерация | autonumber | stream-name | Имя потока, указанное counter-increment стиль |
| Номер текущей страницы | page | Нет атрибутов | |
| Общее количество страниц в документе | numpages | Нет атрибутов | |
| Разрыв страницы | pagebreak | Нет атрибутов | |
| Числовая ссылка на страницу, на которой находится цель | pageref | target | идентификатор цели; создать цель в отчете с помощью mlreportgen.dom.LinkTarget |
| Вставка содержимого заголовка или другого стиля в верхний или нижний колонтитул страницы (для запущенных верхних и нижних колонтитулов) | styleref | Нет атрибутов | Вставляет содержимое ближайшего h1 элемент |
style-name | Имя стиля с содержимым для вставки в верхний или нижний колонтитул | ||
outline-level | Уровень структуры стиля с содержимым для вставки в верхний или нижний колонтитул | ||
| Вставка изображения водяного знака в макет страницы | watermark | src | Путь к исходному файлу, используемому в качестве изображения водяного знака. Сохраните изображение водяного знака в пакете шаблонов. См. раздел Водяные знаки в макетах страниц PDF. |
width | Ширина для масштабирования изображения водяного знака, в форме Возможные значения для единиц измерения: | ||
height | Высота для масштабирования изображения водяного знака, в форме |
Дополнительные сведения об атрибутах см. в разделе Свойства для этих соответствующих классов DOM API.
Эти стандартные элементы HTML можно использовать в шаблонах PDF.
| Элемент HTML | Признаки |
|---|---|
a | class, style, href, name |
address | class, style |
b | class, style |
big | class, style |
blockquote | class, style |
body | class, style |
br | n/a |
center | class, style |
cite | class, style |
code | class, style |
dd | class, style |
del | class, style |
dfn | class, style |
div | class, style |
dl | class, style |
dt | class, style |
em | class, style |
font | class, style, color, face, size |
h1, h2, h3, h4, h5, h6 | class, style, align |
hr | class, style, align |
i | class, style |
ins | class, style |
img | class, style, src, height, width |
kbd | class, style |
li | class, style |
mark | class, style |
nobr | class, style |
ol | class, style |
p | class, style, align |
pre | class, style |
s | class, style |
samp | class, style |
small | class, style |
span | class, style |
strike | class, style |
strong | class, style |
sub | class, style |
sup | class, style |
table | class, style, align, bgcolor, border, cellspacing, cellpadding, frame, rules, width |
tbody | class, style, align, valign |
tfoot | class, style, align, valign |
thead | class, style, align, valign |
td | class, style, bgcolor, height, width, colspan, rowspan,align, valign, nowrap |
th | class, style, bgcolor, height, width, colspan, rowspan,align, valign, nowrap |
tr | class, style, align,bgcolor, valign |
tt | class, style |
u | class, style |
ul | class, style |
var | class, style |
Сведения об этих элементах см. в разделе https://developer.mozilla.org/en-US/docs/Web/HTML/Element.