使用Restyle自定义版式

Restyle可以利用存储在Restyle Configuration Store中的用户提供的排版。

Restyle设计版式

Restyle是一个 JSON 格式的配置文档,其中包含主题使用的版式定义。版式定义被命名为 JSON 元素,由字体名称、字体大小和样式数组组成。
注意:版式自定义需要使用用户提供的主题。请参阅使用Restyle自定义主题

先决条件

  1. HCL Domino Designer 安装在您的计算机上。
  2. 基本了解 JSON(JavaScript 对象表示法)格式。
  3. 兼容 JSON 的编辑器。
  4. 本地复制品 restyle.nsf. See Restyle Configuration Store.

从Restyle.nsf 导出版式配置

创建自定义版式文件的最佳方法是从默认版式文件开始并根据需要对其进行修改。从导出默认排版文件和排版模式 restyle.nsf 按照以下步骤操作:

  1. 创建一个目录用作版式和架构文件的目标。
  2. 启动 Domino Designer。
  3. 打开本地副本 restyle.nsf.
  4. 导航到资源/文件并双击文件条目。
  5. 选择 reserved/schema/typography-<version>.json 并单击导出。这就是“排版模式”。
  6. 选择步骤 1 中创建的目录,然后单击“保存”以保存架构文件。
  7. 选择 reserved/typography/default-typography.json 用作起始主题并单击Export
注意:文件名包含序列 2f 而不是 '/'. Since you aren't importing these files after changing, you can rename to remove the 2f 如果需要的话。

创建自定义排版

  1. 使用支持 JSON 的编辑器,打开导出的版式文件并另存为新的版式文件,例如: my_custom_typography.json.
  2. 为了获得最佳结果,请配置编辑器将版式架构与新版式相关联。这提供了自动完成功能,并在Restyle使用文档之前对其进行验证。
  3. 根据需要修改版式文档。
  4. 将新的排版文档导入到 restyle.nsf:
    1. 启动 Domino Designer。
    2. 打开本地副本 restyle.nsf.
    3. 导航 Resources/Files 并双击文件条目。
    4. 在“文件”集合的顶部,单击新建文件资源
    5. 进入 typography/my_custom-typography.json (或者您为排版文件命名的任何内容)作为名称。
      注:"typography/" 需要前缀才能允许Restyle功能找到自定义主题。
    6. 输入用户友好的显示名称作为别名值。
    7. 注释当前未使用,但可能对文档目的有用。
    8. 在 JSON 编辑器中,选择整个文档并复制到剪贴板。
    9. 将剪贴板的内容粘贴到 Domino Designer 中新创建的文件资源中。
  5. 更新您的自定义主题以使用新的版式配置:
    1. 打开自定义主题。
    2. 在主题顶部,添加一个名为“typographyOverride”的属性,其中包含新版式配置的值。例如:
      {
      "version" : "1.0.0",
      "typographyOverride" : "my_custom_typography",
      .
      .
      .
    3. 保存主题。

使用自定义排版

每当用户应用引用自定义排版文件的主题时,新的排版设置将覆盖主题中的默认设置。
注意:有必要定义主题引用的所有版式定义。