В пакете шаблона по умолчанию файл docpart_templates.html задает библиотеку и некоторые шаблоны части документа по умолчанию. В вашей библиотеке шаблонов части документа создайте части документа, которые вы хотите снова использовать в своем отчете. Можно создать шаблон части для любой части документа, который вы хотите повторить, не переопределяя ее программно.
Шаблон части документа обычно состоит из фиксированного содержимого и дыр. Это может также включать элементы макета страницы, которые описывают размер страницы, поля, и ориентацию, а также верхние колонтитулы страницы и нижние колонтитулы. Вы создаете библиотеки шаблонов части документа в формате PDF с помощью элементов HTML API DOM, обеспеченных с этой целью и подмножество элементов HTML.
Используйте этот рабочий процесс, чтобы работать над вашей библиотекой шаблонов части документа.
Разархивируйте пакет шаблона, содержащий файл библиотеки шаблонов части.
Откройтесь часть документа обрабатывает по шаблону файл, названный docpart_templates.html по умолчанию, в редакторе HTML или текстовом редакторе.
Отредактируйте файл по мере необходимости с помощью элементов, описанных в Структуре Библиотеки шаблонов Части Документа в формате PDF.
Добавьте любые стили, которые поддерживают шаблоны части документа в файле .css в пакете шаблона. Смотрите Изменяют Стили в Шаблонах PDF.
Сохраните файлы библиотеки, которые вы отредактировали.
Повторно группируйте шаблон с помощью ziptemplate.
Вы создаете свою библиотеку деталей документа с помощью элемента <dplibrary>. Добавьте элемент <dplibrary> в элементе <body> в вашем файле docpart_template.html. Ваш пакет шаблона может иметь только один элемент <dplibrary>.
Используйте элементы <dptemplate> в элементе <dplibrary> для каждого шаблона части документа, который вы хотите создать. Можно создать столько шаблонов части документа, сколько вам нужно.
Этот код показывает базовую структуру библиотеки деталей документа. Элемент <dptemplate> имеет атрибут name, который вы устанавливаете на имя, которое вы используете, чтобы вызвать часть документа. Имя эквивалентно имени части в галерее Quick Parts в Word. Если вы создаете шаблоны для нескольких выходных параметров, используйте то же имя в обоих местах.
<body>
<dplibrary>
<dptemplate name="myFirstDocPartTemp">
[Document part template content here--
holes, fixed content, page layout information, and HTML]
</dptemplate>
</dplibrary>
</body>
Можно использовать элементы HTML API DOM и подмножество стандартных элементов HTML, чтобы создать шаблоны части документа в формате PDF. Для примеров, которые показывают, как использовать элементы HTML API DOM, см.:
В дополнение к <dplibrary> и элементам <dptemplate>, которые вы используете, чтобы задать библиотеку и части документа, можно использовать эти элементы HTML API DOM в шаблонах 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 | ID, который идентифицирует дыру по наименованию |
default-style-name | Стиль таблицы стилей, чтобы использовать, когда стиль не установлен программно | ||
| Оглавление | toc | number-of-levels | Количество направляющихся уровней, чтобы включать в TOC |
leader-pattern | Шаблон лидера, чтобы использовать: dots, space, точка, или пробел | ||
| Автоматическая нумерация | autonumber | stream-name | Имя потока задано стилем counter-increment |
| Текущий номер страницы | page | Никакие атрибуты | |
| Общее количество страниц в документе | numpages | Никакие атрибуты | |
| Разрыв страницы | pagebreak | Никакие атрибуты | |
| Числовая ссылка на страницу, где цель расположена | pageref | target | ID цели; создайте цель в своем отчете с помощью mlreportgen.dom.LinkTarget |
| Вставьте содержимое заголовка или другого стиля в верхний колонтитул страницы или нижний колонтитул (для рабочих заголовков и нижних колонтитулов) | styleref | Никакие атрибуты | Вставляет содержимое самого близкого элемента h1 |
style-name | Имя стиля с содержимым, чтобы вставить в заголовок или нижний колонтитул | ||
outline-level | Обрисуйте в общих чертах уровень стиля с содержимым, чтобы вставить в заголовок или нижний колонтитул | ||
| Вставьте изображение водяного знака в макет страницы | watermark | src | Путь исходного файла, чтобы использовать в качестве изображения водяного знака. Сохраните изображение водяного знака в пакете шаблона. Смотрите Водяные знаки в Макетах страницы PDF. |
width | Ширина, чтобы масштабировать изображение водяного знака, в форме valueUnits. Возможными значениями для модулей является | ||
height | Высота, чтобы масштабировать изображение водяного знака, в форме valueUnits |
Для получения дальнейшей информации на атрибутах, смотрите свойства для этих соответствующих классов API DOM.
Можно использовать эти стандартные элементы HTML в шаблонах PDF.
| Элемент HTML | Атрибуты |
|---|---|
a | class, style, href, name |
b | class, style |
body | class, style |
br | нет данных |
code | class, style |
del | class, style |
div | 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, alt |
li | class, style |
ol | class, style |
p | class, style, align |
pre | class, style |
s | class, style |
span | class, style |
strike | 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, valign, nowrap |
tr | class, style, bgcolor, valign |
tt | class, style |
u | class, style |
ul | class, style |
Для получения информации об этих элементах смотрите, что W3Schools помечает документацию по www.w3schools.com/tags.