В пакете шаблона по умолчанию файл 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> элемент для каждого шаблона детали документа, который необходимо создать. Вы можете создать столько шаблонов деталей документа, сколько вам нужно.
Этот код показывает базовую структуру библиотеки деталей документа. The <dptemplate> элемент имеет атрибут name, для которого задано имя, используемое для вызова детали документа. Имя эквивалентно наименованию детали в Quick Parts Gallery in 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. Для примеров, которые показывают, как использовать элементы DOM API HTML, смотрите:
В дополнение к <dplibrary> и <dptemplate> элементы, используемые для определения библиотеки и деталей документа, можно использовать эти элементы DOM API HTML в шаблонах 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 | Ширина для масштабирования изображения водяного знака в форме valueUnits. Возможные значения для модулей измерения | ||
height | Высота для масштабирования изображения водяного знака в форме valueUnits |
Для получения дополнительной информации об атрибутах см. свойства для этих соответствующих классов 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.