Stages Documentation

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision		Previous revision
install:fonts79 [2023/03/22 14:38] – created arflinstall:fonts79 [2024/02/15 00:00] (current) – external edit 127.0.0.1
Line 1: Line 1:
 ====== How to install the correct fonts ====== ====== How to install the correct fonts ======
  
-From Stages version 7.9.7.0 onward, there is a new simpler way to define which font should be used for the creation of PDF files and process visualizations. You only need to choose one of the provided fonts or your own TrueType font and set its name and filename via a configuration property.+From Stages version 7.9.7.0 onward, there is a new simpler way to define which font should be used for the creation of PDF files and process visualizations. You only need to choose one of the provided fonts or your own TrueType font and set its filename via a configuration property.
  
 ===== Setting the “global.font” configuration property ===== ===== Setting the “global.font” configuration property =====
Line 11: Line 11:
 The format for the property is as follows: The format for the property is as follows:
  
-//<property name="global.font" value="Source Sans Pro**:**SourceSansPro-Regular.ttf"/>//+//<property name="global.font" value="SourceSansPro-Regular.ttf"/>//
  
-The value contains the name of the font and the font file name, separated by a colon. The name of the font is included as meta data in the font file. The font file name can either be an absolute path to the file or just the filename itself. If it is a relative path, Stages will search for the font in the //conf/fonts// and the //tomcat/webapps/stages/fonts// folders. +The value contains the font file name. If you want to use a custom font, place the TrueType font file in this folder:
- +
-If you want to use a custom font, place the TrueType font file in this folder:+
  
 Windows: //<Stages Installation Directory>\stages\conf\fonts// \\ Windows: //<Stages Installation Directory>\stages\conf\fonts// \\
 Linux: ///opt/stages/conf/fonts// Linux: ///opt/stages/conf/fonts//
 +
 +Alternatively, you can place the font file anywhere and specify the filename with the absolute path.
 +
 ===== Updating the metamodel to include the new font ===== ===== Updating the metamodel to include the new font =====
  
-If you use the "global.font property", changing the metamodel is no longer required.+If you use the "global.font" property, changing the metamodel is no longer required.
  
 ===== Provided default font files ===== ===== Provided default font files =====
Line 33: Line 34:
  
 ^Character set^value for global.font property| ^Character set^value for global.font property|
-|Western|//"Source Sans Pro:SourceSansPro-Regular.ttf"// | +|Western|//SourceSansPro-Regular.ttf// | 
-|Japanese|//"M PLUS 1p:MPLUS1p-Regular.ttf"// | +|Japanese|//MPLUS1p-Regular.ttf// | 
-|Korean|//"Gothic A1:GothicA1-Regular.ttf"// | +|Korean|//GothicA1-Regular.ttf// | 
-|Chinese|//"Source Han Sans:SourceHanSans-Regular.ttf"// |+|Chinese|//SourceHanSans-Regular.ttf// | 
 ===== Activate your changes ===== ===== Activate your changes =====
  
-Remember to execute bin/update.bat (Windows) or bin/update.sh (Linux) and restart States.+Remember to execute bin/update.bat (Windows) or bin/update.sh (Linux) and restart Stages.
  
 ===== Known limitations ===== ===== Known limitations =====