Personalizzazione della tipografia con Restyle

Restyle può utilizzare la tipografia fornita dall'utente memorizzata nel Restyle Configuration Store .

Restyle della tipografia

Restyle tipografia è un documento di configurazione in formato JSON contenente le definizioni tipografiche utilizzate dai temi. Le definizioni tipografiche sono denominate elementi JSON costituiti da un nome di carattere tipografico, dimensione del carattere e array di stili.
Nota: la personalizzazione della tipografia richiede l'uso di un tema fornito dall'utente. Vedi Personalizzazione dei temi con Restyle .

Prerequisiti

  1. HCL Domino Designer installato sul tuo computer.
  2. Comprendere il formato JSON (JavaScript Object Notation) a livello base.
  3. Un editor compatibile con JSON.
  4. Una replica locale di restyle.nsf. See Restyle Configuration Store.

Esportazione della configurazione tipografica da Restyle.nsf

Il modo migliore per creare un file tipografico personalizzato è iniziare con il file tipografico predefinito e modificarlo secondo necessità. Esporta il file tipografico predefinito e lo schema tipografico da restyle.nsf seguendo questi passaggi:

  1. Crea una directory da utilizzare come destinazione per i file tipografici e di schema.
  2. Avvia Domino Designer.
  3. Apri la replica locale di restyle.nsf.
  4. Passare a Risorse/File e fare doppio clic sulla voce File .
  5. Selezionare reserved/schema/typography-<version>.json e fare clic su Esporta . Questo è lo "schema tipografico".
  6. Selezionare la directory creata nel passaggio 1 e fare clic su Salva per salvare il file di schema.
  7. Selezionare reserved/typography/default-typography.json da utilizzare come tema iniziale e fare clic su Esporta .
Nota: i nomi dei file contengono la sequenza 2f invece del '/'. Since you aren't importing these files after changing, you can rename to remove the 2f se desiderato.

Creazione di una tipografia personalizzata

  1. Con il tuo editor compatibile con JSON, apri il file tipografico esportato e salva come nuovo file tipografico, ad esempio: my_custom_typography.json.
  2. Per ottenere i migliori risultati, configura il tuo editor per associare lo schema tipografico alla tua nuova tipografia. Ciò fornisce funzionalità di completamento automatico e convalida il documento prima che Restyle lo utilizzi.
  3. Modificare il documento tipografico secondo necessità.
  4. Importa il nuovo documento tipografico in restyle.nsf:
    1. Avvia Domino Designer.
    2. Apri la replica locale di restyle.nsf.
    3. Navigare verso Resources/Files e fare doppio clic sulla voce File .
    4. Nella parte superiore della raccolta "File", fai clic su Nuova risorsa file .
    5. accedere typography/my_custom-typography.json (o qualunque sia il nome che hai assegnato al tuo file tipografico) come nome.
      Notare la "typography/" è richiesto il prefisso per consentire alla funzione Restyle di trovare il tema personalizzato.
    6. Inserisci un nome visualizzato intuitivo come valore alias.
    7. Il commento non è attualmente utilizzato ma può essere utile a scopo di documentazione.
    8. Nel tuo editor JSON, seleziona l'intero documento e copialo negli appunti.
    9. Incollare il contenuto degli appunti nella risorsa file appena creata in Domino Designer.
  5. Aggiorna i tuoi temi personalizzati per utilizzare la nuova configurazione tipografica:
    1. Apri un tema personalizzato.
    2. Nella parte superiore del tema, aggiungi una proprietà denominata "typographyOverride" con il valore della nuova configurazione tipografica. Per esempio:
      {
      "version" : "1.0.0",
      "typographyOverride" : "my_custom_typography",
      .
      .
      .
    3. Salva il tema.

Utilizzando la tipografia personalizzata

Ogni volta che un utente applica un tema che fa riferimento al file tipografico personalizzato, le nuove impostazioni tipografiche sovrascriveranno le impostazioni predefinite nel tema.
Nota: è necessario definire tutte le definizioni tipografiche a cui fa riferimento il tema.