zipTemplate

Шаблон Package DOM HTML и PDF в zip-файле

Синтаксис

zipTemplate(unzippedTemplateFolder)
zipTemplate(zippedTemplate,unzippedTemplateFolder)
zipTemplate(zippedTemplate,unzippedTemplateFolder,mainDocument)
zipTemplate(zippedTemplate,unzippedTemplateFolder,mainDocument,partTemplates)

Описание

пример

zipTemplate(unzippedTemplateFolder) zip (сжимает и вставляет zip-файл), разархивированный шаблон DOM в unzippedTemplateFolder. Получившееся заархивированное имя файла шаблона является именем, заданным в unzippedTemplateFolder плюс расширение файла htmtx или pdftx. Функция zipTemplate архивирует все файлы в разархивированной папке шаблона, включая файлы в подпапках. Заархивированная структура папок шаблона копирует структуру папок разархивированного шаблона. Имена файлов в разархивированном шаблоне должны содержать только символы ASCII.

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

  • Используемый mlreportgen.dom.Document.createTemplate

  • Скопированный шаблон с шаблона DOM по умолчанию

  • Созданный шаблон, не используя API DOM или шаблоны DOM и заархивированный файл выполняет условия, перечисленные в “Советах”.

пример

zipTemplate(zippedTemplate,unzippedTemplateFolder) архивирует разархивированный шаблон DOM в файл, заданный zippedTemplate.

zipTemplate(zippedTemplate,unzippedTemplateFolder,mainDocument) архивирует разархивированный шаблон DOM в файл, заданный zippedTemplate. Используйте аргумент mainDocument, чтобы задать имя основного документа в разархивированном шаблоне, если основным названием документа в разархивированном шаблоне не является report.html или root.html и ваш файл библиотеки шаблонов части документа, если это существует, находится в файле под названием docpart_templates.html.

пример

zipTemplate(zippedTemplate,unzippedTemplateFolder,mainDocument,partTemplates) архивирует разархивированный шаблон DOM в файл, заданный zippedTemplate. Используйте этот синтаксис, когда разархивированный шаблон включает файл библиотеки шаблонов части документа, именем файла которого не является docpart_templates.html. Необходимо задать mainDocument в качестве третьего аргумента, даже если основной файл документа называется report.html или root.html.

Примеры

свернуть все

Архивируйте шаблон myTemplate в zip-файл под названием myTemplate.htmtx.

zipTemplate('myTemplate');

Архивируйте шаблон myTemplate в zip-файл под названием myReportTemplate.htmtx.

zipTemplate('myReportTemplate.htmtx','myTemplate');

Архивируйте шаблон, основной частью которого является mainpart.html и чьим файлом библиотеки шаблонов части является documentpart_templates.html.

zipTemplate('myTemplate.htmtx','myTemplate',...
    'mainpart.html','documentpart_templates.html');

Входные параметры

свернуть все

Путь к папке, содержащей разархивированный шаблон, заданный как вектор символов. Имена файлов в разархивированном шаблоне должны содержать только символы ASCII.

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

Основное имя файла документа, включая расширение файла, заданное как вектор символов.

Имя файла библиотеки деталей документа, включая расширение файла, заданное как вектор символов.

Советы

  • Если вы создали разархивированный шаблон путем разархивации шаблона, созданного при помощи mlreportgen.dom.Document.createTemplate или копирования шаблона с шаблона DOM по умолчанию, можно использовать любой из этих синтаксисов без дальнейших действий:

    zipTemplate(zippedTemplate,unzippedTemplateFolder)

    Можно также использовать любой из тех двух синтаксисов, если разархивированный шаблон был создан, не используя интерфейс DOM, и шаблон выполняет следующие требования.

    • Основной файл документа называют или report.html или root.html.

    • Разархивированный шаблон или не включает файл библиотеки шаблонов части документа, или он включает файл с именем библиотеки шаблонов части документа docpart_templates.html.

    • Разархивированный шаблон хранит изображения в папке под названием images.

    Если разархивированный шаблон, основной файл документа не называют или report.html или root.html, используют входной параметр mainDocument.

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

    Если разархивированные изображения хранилищ шаблона в папке кроме одного именованного images в корневой папке шаблона, включайте текстовый файл под названием _imgprefix в папке, которая содержит изображения для разархивированного шаблона. В файле _imgprefix можно включать префикс для интерфейса DOM, чтобы использовать, чтобы сгенерировать изображения имен, добавленные к документам. Например, если файл _imgprefix содержит префиксный graphic, сгенерированными названиями картинки является graphic1.png, graphic2.png, и так далее. Если вы оставляете файл _imgprefix пустым, то сгенерированные изображения используют префиксный image.

Введенный в R2014b