从本地构建运行编辑器.

Learn DXPR BuilderManage the siteJe huisstijl toepassen

默认情况下,编辑人员的浏览器从 DXPR CDN 加载 DXPR Builder 编辑器,您无需设置任何内容。本页面向从源码构建编辑器的开发人员,用于调试或测试更改。完成后,编辑器从模块文件夹中的文件运行,压缩或可读版本均可。要让 CDN 通过防火墙,请改参阅 防火墙和数据驻留。

开始之前

  • 您需要 DXPR Builder 的 git 检出,并装好 Node 依赖。drupal.org 的发行版不含本地构建。
  • 您需要 Administer DXPR Builder configuration 权限。

设置

  1. 在模块文件夹中运行 npx grunt build。它将编辑器写入 dxpr_builder/,压缩和未压缩版本都有。
  2. 前往 DXPR Studio > DXPR Builder > General Settings (/admin/dxpr_studio/dxpr_builder/settings)。
  3. 展开 Editor Assets。该部分只在存在本地构建时出现。
  4. 在 Asset source 下选择 Local (minified) 或 Local (unminified)。
  5. 点击 Save settings。

您会看到的内容

在构建器中重新加载页面。浏览器现在从您自己网站上模块的 dxpr_builder/ 文件夹加载编辑器脚本,不带 CDN 请求所带 jwt 参数。Local (unminified) 加载可读的 .js 文件,Local (minified) 加载更小的 .min.js 文件。

设置

选项 加载内容 用于
Cloud(默认) 来自 cdn2.dxpr.com 的编辑器,cdn.dxpr.com 为备用。每个请求都带上您的产品密钥。 从发行版安装的每个网站
Local (minified) dxpr_builder/*.min.js,模块文件夹中的文件 按生产运行方式测试构建
Local (unminified) dxpr_builder/*.js,模块文件夹中的文件 调试

本地构建始终胜过 Cloud。选中 Cloud 时,网站加载未压缩文件,只有压缩文件时加载压缩文件。DXPR 只为发行版发布云端文件,因此开发检出本来也用不了它们。

如果您看不到本地构建

  • 没有 Editor Assets 部分。 模块的 dxpr_builder/ 文件夹中没有构建。请在 git 检出中运行 npx grunt build,再重新加载设置页面。
  • 只提供一个 Local 选项。 只有压缩或只有未压缩文件存在。请运行完整的 npx grunt build,它会写入两者。
  • 选中了 Cloud,但加载的还是本地文件。 存在构建时这是设计使然。请删除 dxpr_builder.js 和 dxpr_builder.min.js(dxpr_builder/ 中),并在 /admin/config/development/performance 清除缓存。
  • 编辑器不出现,对 cdn2.dxpr.com 的请求失败。 防火墙或内容安全策略屏蔽了 CDN。请放行两个 CDN 主机;请参阅 防火墙和数据驻留。

接下来做什么?

  • 性能:每个来源加载的内容,及其背后的配置键。
  • 编辑器不出现:编辑器启动失败的其他原因。