Создайте библиотеку шаблонов части документа в формате PDF

В пакете шаблона по умолчанию, файл docpart_templates.html задает библиотеку и некоторые шаблоны части документа по умолчанию. В вашей библиотеке шаблонов части документа создайте части документа, которые вы хотите снова использовать в своем отчете. Можно создать шаблон части для любой части документа, который вы хотите повторить, не переопределяя ее программно.

Шаблон части документа обычно состоит из фиксированного содержимого и отверстий. Это может также включать элементы макета страницы, которые описывают размер страницы, поля, и ориентацию, а также верхние колонтитулы страницы и нижние колонтитулы. Вы создаете библиотеки шаблонов части документа в формате PDF с помощью элементов HTML API DOM, обеспеченных с этой целью и подмножество элементов HTML.

Используйте этот рабочий процесс, чтобы работать над вашей библиотекой шаблонов части документа.

Разархивируйте пакет шаблона, содержащий файл библиотеки шаблонов части.
Откройтесь часть документа обрабатывает по шаблону файл, названный docpart_templates.html по умолчанию, в редакторе HTML или текстовом редакторе.
Отредактируйте файл по мере необходимости с помощью элементов, описанных в Структуре Библиотеки шаблонов Части Документа в формате PDF.
Добавьте любые стили, которые поддерживают шаблоны части документа в .css файл в пакете шаблона. Смотрите Изменяют Стили в Шаблонах PDF.
Сохраните файлы библиотеки, которые вы отредактировали.
Повторно группируйте шаблон с помощью ziptemplate.

Структура библиотеки шаблонов части документа в формате PDF

Вы создаете свою библиотеку деталей документа с помощью <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, см.:

Элементы HTML API DOM

В дополнение к <dplibrary> и <dptemplate> элементы, которые вы используете, чтобы задать библиотеку и части документа, можно использовать эти элементы HTML API DOM в шаблонах PDF.

Цель	Элемент	Атрибуты	Значения
Макет страницы	`layout`	`style`	`page-margin: top left bottom right header footer gutter; page-size: height width orientation`
		`first-page-number`	Количество первой страницы в размещении
		`page-number-format`	`n` или `N` для числового, `aAii`
		`section-break`	Где запустить раздел для этого размещения: `Odd Page`, `Even Page`, или `Next Page`
Верхний колонтитул страницы	`pheader`	`type`	`default`, `first`, `even`
Верхний колонтитул страницы	`pheader`	`template-name`	Шаблон части документа, который задает заголовок
Нижний колонтитул	`pfooter`	`type`	`default`, `first`, `even`
Нижний колонтитул	`pfooter`	`template-name`	Шаблон части документа, который задает нижний колонтитул
Формат номера страницы (то же самое как `first-page-number` и `page-number-format` на размещении)	`pnumber`	`format`	`n` или `N` для числового, `aAii`
	`pnumber`	`initial-value`	Номер для первой страницы в размещении, которое использует этот элемент
Отверстие	`hole`	`id`	ID, который идентифицирует отверстие по наименованию
Отверстие	`hole`	`default-style-name`	Стиль таблицы стилей, чтобы использовать, когда стиль не установлен программно
Оглавление	`toc`	`number-of-levels`	Количество направляющихся уровней, чтобы включать в TOC
Оглавление	`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. Возможными значениями для модулей является `px\in`, `cm`, `mm`, `pc`, и `pt`.
		`height`	Высота, чтобы масштабировать изображение водяного знака, в форме valueUnits

Для получения дальнейшей информации на атрибутах, смотрите свойства для этих соответствующих классов API DOM.

Стандартные элементы HTML

Можно использовать эти стандартные элементы HTML в шаблонах PDF.

Элемент HTML	Атрибуты
`a`	`class`, `style`, `hrefИмя`
`address`	`class`, `style`
`b`	`class`, `style`
`big`	`class`, `style`
`blockquote`	`class`, `style`
`body`	`class`, `style`
`br`	нет данных
`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размер`
`h1, h2, h3, h4, h5, h6`	`class`, `styleвыравнивание`
`hr`	`class`, `styleвыравнивание`
`i`	`class`, `style`
`ins`	`class`, `style`
`img`	`class`, `stylesrc` `высотаwidth`
`kbd`	`class`, `style`
`li`	`class`, `style`
`mark`	`class`, `style`
`nobr`	`class`, `style`
`ol`	`class`, `style`
`p`	`class`, `styleвыравнивание`
`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выравнивание`, `bgcolor'Граница'` , `cellspacing`, `cellpaddingСистема координат`, `ruleswidth`
`tbody`	`class`, `styleвыравнивание`, `valign`
`tfoot`	`class`, `styleвыравнивание`, `valign`
`thead`	`class`, `styleвыравнивание`, `valign`
`td`	`class`, `style`, `bgcolorвысотаwidth`, `colspan`, `rowspanвыравнивание`, `valign`, `nowrap`
`th`	`class`, `style`, `bgcolorвысотаwidth`, `colspan`, `rowspanвыравнивание`, `valign`, `nowrap`
`tr`	`class`, `styleвыравнивание`, `bgcolor`, `valign`
`tt`	`class`, `style`
`u`	`class`, `style`
`ul`	`class`, `style`
`var`	`class`, `style`

Для получения информации об этих элементах см. https://developer.mozilla.org/en-US/docs/Web/HTML/Element.

Смотрите также

unzipTemplate | zipTemplate

Документация