导出与发布:画面包内容、整包导出与当前页

导出与发布是将 PPT 页面转换为可在宿主机运行的“画面包”的最后一步。功能区 HQ VISU 标签页里的 Export 分组有三个按钮:Export HTML(将整个 PPT 导出成一个画面包)、Current Page(只导出当前页,用于页级小更新)、Export History(管理当前电脑上最近使用过的导出目录)。导出物是一个自包含文件夹,包含页面 HTML、每页的 SVG 图形、JS(页面数据与脚本)、图片与运行清单。官方规则是“1 个 PPT = 1 个画面包”:一个业务画面就是一个 PPT,可以包含一个主页面和若干同包子页面。导出后将该文件夹上传到 HQControl,由宿主机按画面编码(screenCode)管理和运行。宿主机和开发机通常不是同一台机器;发布对象是画面包,不是开发机上的本地 PPT 路径。

功能

功能: 导出与发布:画面包内容、整包导出与当前页

把完成配置的 PPT 导出成一个 HQ VISU 画面包(HTML + SVG + JS + IMG),再上传到 HQControl 宿主机运行。一个 PPT 对应一个画面包,正式交付时应按包整体替换。

功能说明

导出与发布是将 PPT 页面转换为可在宿主机运行的“画面包”的最后一步。功能区 HQ VISU 标签页里的 Export 分组有三个按钮:Export HTML(将整个 PPT 导出成一个画面包)、Current Page(只导出当前页,用于页级小更新)、Export History(管理当前电脑上最近使用过的导出目录)。导出物是一个自包含文件夹,包含页面 HTML、每页的 SVG 图形、JS(页面数据与脚本)、图片与运行清单。官方规则是“1 个 PPT = 1 个画面包”:一个业务画面就是一个 PPT,可以包含一个主页面和若干同包子页面。导出后将该文件夹上传到 HQControl,由宿主机按画面编码(screenCode)管理和运行。宿主机和开发机通常不是同一台机器;发布对象是画面包,不是开发机上的本地 PPT 路径。

使用方法:三个按钮和导出包内容

在 Export 分组里按需选择导出方式,导出目录可从历史里挑或新建。导出后得到的画面包典型结构如下(HTML 留在包根目录,生成的样式和脚本集中到 css/ 和 js/):

  • Export HTML:整包导出。共享资源变化,或者新增、删除、重命名了页面、改了导航结构,都必须用它整包导出。
  • Current Page:只导当前页资源。只适合「当前页图形 / 当前页脚本 / 当前页组件行为」这类页级变化。
  • Export History:查看最近导出目录、删除选中目录、清空所有历史。它只清理本机记录,不会删除磁盘上真实的导出文件。
  • 包内容:<page>.html(页面,首页文件名跟随该页在 PPT 里配置的导出文件名)、<page>.svg(每页图形)、js/hq-pagemap.js(页面映射)、js/<page>.js(页面数据与脚本)、img/(图片)以及运行和导出清单。
<screen-package>/
  <page>.html
  <page>.svg
  js/
    hq-pagemap.js
    <page>.js
  img/
    ...
  screen.manifest.json
  hqVisuDesigner-export-report.json

Export HTML 完整操作步骤

先保存 PPT,点击 Export HTML。在 Choose an export folder 窗口中输入一个现有或新的文件夹路径,或点击 Browse... 选择目录;也可以从 Recent export folders 选择并双击。点击 Export 后进入预览和导出进度,等待状态显示完成,再打开目标目录检查文件。

  • 输出目录可以尚未存在,导出开始时会创建。
  • 选择最近目录只会把路径带入输入框,点击 Export 才正式开始。
  • 导出过程中查看 Export log,确认验证、页面、脚本和资源步骤没有失败。
  • 需要中止时点击 Cancel,程序会在下一个安全检查点停止。
  • 完成后点击 Close,再检查 screen.manifest.json 和导出报告。

Current Page 操作前必须确认范围

切换到要更新的幻灯片并确认它是当前页,再点击 Current Page。选择与现有画面包对应的输出目录,完成后只替换该页相关文件。若本次改动涉及页面新增、删除、重命名、公共资源或页面映射,退出当前页导出,改用 Export HTML。

  • 当前页名称和 Page Code 没有变化。
  • 只修改了该页图形、该页行为或该页脚本。
  • 目标目录属于同一个画面包。
  • 导出后打开该页进行功能确认,不只检查文件时间。

Export History 的删除、撤销和保存

点击 Export History 打开最近目录列表。选择一行后用 Delete selected 标记删除,Clear all 标记清空,Undo changes 撤销本窗口中的待保存修改,最后点击 Save changes 才写回历史。Cancel 放弃本次历史修改。所有这些操作都不会删除磁盘目录或导出文件。

  • Delete selected:只移除选中的历史条目。
  • Clear all:清空全部本地历史条目。
  • Undo changes:恢复本窗口尚未保存的修改。
  • Save changes:确认写回历史。
  • 需要删除真实导出包时,必须在文件系统中另行处理并先确认目标。

适用场景

按改动范围选导出方式,再上传到 HQControl:

  • 只改了一个画面里某一页的图形/脚本/数据:打开那个 PPT,用 Current Page 导出,做页级替换。
  • 共享资源变化,或加页、删页、改页名、改导航:用 Export HTML 整包导出(只导当前页这些变化带不上)。
  • 正式发布:整包导出 → 上传到宿主机 → 让宿主机按包整体替换,必要时保留一份 backup;宿主机按 screenCode 管理,不要长期把不同日期的零散文件混在一个目录里。

边界与常见误区

常见误区:

  • 导出前 PPT 有未保存改动会弹提示,建议先选「Save and Export」(保存并导出);选「Export Without Saving」(不保存直接导出)生成的文件可能跟最新编辑对不上。
  • 页面新增、删除、重命名属于整包级变化,不能用 Current Page,必须整包导出,否则宿主机里会残留旧页、链接打开已删除的页。
  • Export History 里删除/清空只是清本机历史记录,不会删除真实导出文件夹。
  • 正式交付的同包跳转用 hqVisuDesigner.openPage / 跨包用 hqVisuDesigner.openScreen,不要用 ../../other-screen/index.html 这种相对磁盘路径,宿主机包路径会变,相对路径会失效。
HQ VISU Designer 导出 HTML 目录选择
图示 1: 导出 HTML

选择导出目录或从最近位置里挑,把整个 PPT 导出成一个画面包。