Personnaliser la typographie avec Restyle

Restyle peut utiliser la typographie fournie par l'utilisateur stockée dans le Restyle Configuration Store .

Restyle la typographie

Restyle typography est un document de configuration au format JSON contenant les définitions de typographie utilisées par les thèmes. Les définitions de typographie sont des éléments JSON nommés qui se composent d'un nom de police, d'une taille de police et d'un tableau de styles.
Remarque : La personnalisation de la typographie nécessite l'utilisation d'un thème fourni par l'utilisateur. Voir Personnalisation des thèmes avec Restyle .

Conditions préalables

  1. HCL Domino Designer installé sur votre ordinateur.
  2. Comprendre le format JSON (JavaScript Object Notation) à un niveau de base.
  3. Un éditeur compatible JSON.
  4. Une réplique locale de restyle.nsf. See Restyle Configuration Store.

Exportation de la configuration typographique depuis Restyle.nsf

La meilleure façon de créer un fichier de typographie personnalisé est de commencer avec le fichier de typographie par défaut et de le modifier si nécessaire. Exportez le fichier de typographie par défaut et le schéma de typographie depuis restyle.nsf en suivant ces étapes :

  1. Créez un répertoire à utiliser comme destination pour les fichiers de typographie et de schéma.
  2. Lancez Domino Designer.
  3. Ouvrez la réplique locale de restyle.nsf.
  4. Accédez à Ressources/Fichiers et double-cliquez sur l’entrée Fichiers .
  5. Sélectionner reserved/schema/typography-<version>.json et cliquez sur Exporter . C'est le "schéma typographique".
  6. Sélectionnez le répertoire créé à l'étape 1 et cliquez sur Enregistrer pour enregistrer le fichier de schéma.
  7. Sélectionner reserved/typography/default-typography.json à utiliser comme thème de départ et cliquez sur Exporter .
Remarque : Les noms de fichiers contiennent la séquence 2f à la place du '/'. Since you aren't importing these files after changing, you can rename to remove the 2f si on le désire.

Créer une typographie personnalisée

  1. Avec votre éditeur compatible JSON, ouvrez le fichier de typographie exporté et enregistrez-le en tant que nouveau fichier de typographie, par exemple : my_custom_typography.json.
  2. Pour de meilleurs résultats, configurez votre éditeur pour associer le schéma de typographie à votre nouvelle typographie. Cela fournit une fonctionnalité de saisie semi-automatique et valide le document avant que Restyle ne l'utilise.
  3. Modifiez le document de typographie si nécessaire.
  4. Importez le nouveau document de typographie dans restyle.nsf:
    1. Lancez Domino Designer.
    2. Ouvrez la réplique locale de restyle.nsf.
    3. Aller vers Resources/Files et double-cliquez sur l'entrée Fichiers .
    4. En haut de la collection "Fichiers", cliquez sur Nouvelle ressource de fichier .
    5. Entrer typography/my_custom-typography.json (ou quel que soit le nom que vous avez donné à votre fichier de typographie) comme nom.
      Noter la "typography/" Le préfixe est requis pour permettre à la fonctionnalité Restyle de trouver le thème personnalisé.
    6. Entrez un nom d'affichage convivial comme valeur d'alias.
    7. Le commentaire n'est pas utilisé actuellement mais peut être utile à des fins de documentation.
    8. Dans votre éditeur JSON, sélectionnez l'intégralité du document et copiez-le dans le presse-papiers.
    9. Collez le contenu du presse-papiers dans la ressource fichier nouvellement créée dans Domino Designer.
  5. Mettez à jour vos thèmes personnalisés pour utiliser la nouvelle configuration de typographie :
    1. Ouvrez un thème personnalisé.
    2. En haut du thème, ajoutez une propriété nommée « typographyOverride » avec la valeur de votre nouvelle configuration typographique. Par exemple:
      {
"version" : "1.0.0",
"typographyOverride" : "my_custom_typography",
.
.
.
    3. Enregistrez le thème.

Utiliser la typographie personnalisée

Chaque fois qu'un utilisateur applique un thème faisant référence au fichier de typographie personnalisé, les nouveaux paramètres de typographie remplaceront les paramètres par défaut du thème.
Remarque : Il est nécessaire de définir toutes les définitions typographiques référencées par le thème.