本页采用了机器翻译。点击此处可查看最新英文版本。

zipTemplate

将 DOM HTML 和 PDF 模板打包到 ZIP 文件中

全页折叠

语法

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

说明

zipTemplate(unzippedTemplateFolder) 将解压后的 DOM 模板压缩并保存为 ZIP 文件，保存在 unzippedTemplateFolder 目录中。生成的压缩模板文件名是 unzippedTemplateFolder 中指定的名称，加上文件扩展名 htmtx 或 pdftx。zipTemplate 函数压缩解压后的模板文件夹中的所有文件，包括子文件夹中的文件。压缩后的模板文件夹结构体与解压后的模板的文件夹结构体相同。解压后的模板中的文件名必须只包含 ASCII 字符。

如果您通过解压以以下任一方式创建的模板来创建解压后的模板，请使用此语法：

  • 使用 mlreportgen.dom.Document.createTemplate

  • 从默认 DOM 模板复制模板

  • 没有使用 DOM API 或 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 压缩成一个名为 myTemplate.htmtx 的 ZIP 文件。 

zipTemplate("myTemplate");

将模板文件 myTemplate 压缩成一个名为 myReportTemplate.htmtx 的 ZIP 文件。

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(unzippedTemplateFolder)
    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 中推出

另请参阅

|

主题