Personalizando la tipografía con Restyle

Restyle puede utilizar tipografía proporcionada por el usuario almacenada en Restyle Configuration Store .

Restyle de la tipografía

La tipografía Restyle es un documento de configuración con formato JSON que contiene definiciones de tipografía utilizadas por los temas. Las definiciones de tipografía son elementos JSON denominados que constan de un nombre de tipo de letra, un tamaño de fuente y una matriz de estilos.
Nota: La personalización de la tipografía requiere el uso de un tema proporcionado por el usuario. Consulte Personalización de temas con Restyle .

Requisitos previos

  1. HCL Domino Designer instalado en su máquina.
  2. Comprender el formato JSON (JavaScript Object Notation) a nivel básico.
  3. Un editor compatible con JSON.
  4. Una réplica local de restyle.nsf. See Restyle Configuration Store.

Exportación de configuración de tipografía desde Restyle.nsf

La mejor manera de crear un archivo de tipografía personalizado es comenzar con el archivo de tipografía predeterminado y modificarlo según sea necesario. Exporte el archivo de tipografía predeterminado y el esquema de tipografía desde restyle.nsf siguiendo estos pasos:

  1. Cree un directorio para utilizarlo como destino para los archivos de tipografía y esquema.
  2. Inicie Domino Designer.
  3. Abra la réplica local de restyle.nsf.
  4. Navegue hasta Recursos/Archivos y haga doble clic en la entrada Archivos .
  5. Seleccionar reserved/schema/typography-<version>.json y haga clic en Exportar . Este es el "esquema tipográfico".
  6. Seleccione el directorio creado en el paso 1 y haga clic en Guardar para guardar el archivo de esquema.
  7. Seleccionar reserved/typography/default-typography.json para usarlo como tema inicial y haga clic en Exportar .
Nota: Los nombres de los archivos contienen la secuencia. 2f en vez de '/'. Since you aren't importing these files after changing, you can rename to remove the 2f Si es deseado.

Creando una tipografía personalizada

  1. Con su editor compatible con JSON, abra el archivo de tipografía exportado y guárdelo como un nuevo archivo de tipografía, por ejemplo: my_custom_typography.json.
  2. Para obtener mejores resultados, configure su editor para asociar el esquema tipográfico con su nueva tipografía. Esto proporciona una funcionalidad de autocompletar y valida el documento antes de que Restyle lo use.
  3. Modifique el documento de tipografía según sea necesario.
  4. Importe el nuevo documento de tipografía a restyle.nsf:
    1. Inicie Domino Designer.
    2. Abra la réplica local de restyle.nsf.
    3. Navegar a Resources/Files y haga doble clic en la entrada Archivos .
    4. En la parte superior de la colección "Archivos", haga clic en Nuevo recurso de archivo .
    5. Ingresar typography/my_custom-typography.json (o como sea que hayas llamado tu archivo de tipografía) como nombre.
      Nota la "typography/" Se requiere un prefijo para permitir que la función Restyle encuentre el tema personalizado.
    6. Introduzca un nombre para mostrar fácil de usar como valor de alias.
    7. El comentario no se utiliza actualmente, pero puede resultar útil con fines de documentación.
    8. En su editor JSON, seleccione el documento completo y cópielo al portapapeles.
    9. Pegue el contenido del portapapeles en el recurso de archivo recién creado en Domino Designer.
  5. Actualice sus temas personalizados para usar la nueva configuración de tipografía:
    1. Abra un tema personalizado.
    2. En la parte superior del tema, agregue una propiedad llamada "typographyOverride" con el valor de su nueva configuración de tipografía. Por ejemplo:
      {
"version" : "1.0.0",
"typographyOverride" : "my_custom_typography",
.
.
.
    3. Guarda el tema.

Usando la tipografía personalizada

Siempre que un usuario aplica un tema que hace referencia al archivo de tipografía personalizado, la nueva configuración de tipografía anulará la configuración predeterminada del tema.
Nota: Es necesario definir todas las definiciones de tipografía a las que hace referencia el tema.