Selecting fonts from the WIRIS editor user interface Configuring fonts in the plugins and low level configuration... 2

Transcription

1 Font configuration Document Release: January, Maths for More Contents Selecting fonts from the WIRIS editor user interface... 2 Configuring fonts in the plugins and low level configuration... 2 Note about variables with italic style... 2 Plugins configuration files... 2 Low level configuration... 3 Font configuration table and examples... 3 identmathvariant, numbermathvariant and mathvariant... 4 fontident, fontnumber, font and typeface... 5 Available fonts in the server... 5

2 2011, Maths for More Font configuration. V1 2 Selecting fonts from the WIRIS editor user interface Users can change the italic and bold style of the variables in a formula: For example, it is possible to edit where w, u and v have bold and italic styles, and where x and y are italic and sin, cos are non-italic. Other styling, like the font size and the font typeface, can be configured only by the administrator of the site. The reason is that all formulas should look alike and consistently among all pages of the site. The remaining sections explain what and how administrators can configure the WIRIS Formula Editor in order to change the font style. Variables are displayed with italic style while standard functions like sin, cos and exp are rendered in nonitalic. This is a common convention when writing mathematics. For example it allows distinguish the structure of sin(x+1) from y(x+1) In the first case, the sin is a function that is applied to (x+1) and the second case y multiplies to (x+1). Configuring fonts in the plugins and low level configuration Note about variables with italic style Starting from version 2.0 of the editor, variables in formulas as displayed with italic style. This is a common convention in order to distinguish mathematical variables from other mathematical content (like functions) and non-mathematical text. Forcing the version to 1.0 it is possible to set up non-italic fonts for variables. Plugins configuration files Plugins can select the font of the formulas with the only condition that the selected fonts are installed in the server where WIRIS editor runs. The image services hosted at services.wiris.com is preconfigured with default values. Any use of a font typeface different from the default ones, are not granted to be available in the future when using the services from services.wiris.com

3 2011, Maths for More Font configuration. V1 3 Each kind of plugin has a configuration file that can be determined following the instructions at Low level configuration When calling the image service, it is possible to send the font configuration parameters directly. For example, 2Fwww.w3.org%2F1998%2FMath%2FMathML%22%3E%3Cmn%3E1%3C%2Fmn%3E%3Cmo%3E%2B%3C%2 Fmo%3E%3Cmi%3Ex%3C%2Fmi%3E%3C%2Fmath%3E&fontNumber=sansserif,120 yields Note the parameter fontnumber=sansserif,120. Font configuration table and examples The entries related to font selection are Parameter name Description Default value Font size and color fontsize 16 identcolor # (black) numbercolor # (black) symbolcolor # (black) Font style (mathvariant) identmathvariant Specifies the mathvariant style for the sans-serif-italic identifiers (variables) numbermathvariant Specifies the mathvariant style for the sans-serif-normal numbers (variables) Typeface fontident Specifies the identifiers (variables) typeface. The styles (normal, italic and bold) are adapted accordingly to this value. fontident-sans-serif-family Specifies the identifiers (variables) typeface when rendered as sans serif. The styles (normal, italic and bold) are adapted accordingly to this value. Windows: Trebuchet MS. Linux: Lucida Sans for sun-java. fontident-serif-family Specifies the identifiers (variables) typeface when rendered as serif. The styles (normal, italic and bold) are adapted accordingly to this value. Windows: Times New Roman. Linux: Lucida Bright for sun-java (except for italic URW Gothic L). Utopia for OpenJDK. fontnumber Specifies numbers typeface similar as Undefined

4 2011, Maths for More Font configuration. V1 4 fontnumber-sans-serif-family fontnumber-serif-family font? font?-sans-serif-family font?-serif-family fontident Specifies numbers typeface similar as fontident-sans-serif-family Specifies numbers typeface similar as fontident-serif-family Where? stands for 0, 1, 2, Specifies the typeface for a given range of characters. Where? stands for 0, 1, 2,.. Specifies numbers typeface similar as fontidentsans-serif-family but for a given range of characters. Where? stands for 0, 1, 2,.. Specifies numbers typeface similar as fontidentserif-family but for a given range of characters. Windows: Arial Linux: Lucida Sans for sun-java. Windows: Arial Linux: Lucida Bright for sun-java. Nimbus Mono L for OpenJDK identmathvariant, numbermathvariant and mathvariant mathvariant are the possible values of identmathvariant and numbermathvariant and are used to specify the styles bold, italic and the serif. The mathvariant values are as follows Value Meaning inside a formula Meaning as identmathvariant, numbermathvariant, etc. Bold Italic Serif Bold Italic Serif normal N N I N N Y italic N Y I N Y Y bold Y N I Y N Y bold-italic Y Y I Y Y Y sans-serif N N N N N N sans-serif-italic N Y N N Y N bold-sans-serif Y Y N Y Y N sans-serif-bold-italic Y N N Y N N N. No Y. Yes I. Inherited (from parent or default) To get further information about the mathvariant concept see For example, to display all variables with sans-serif and non-italic identmathvariant=sans-serif To force variables, to be serif and italic identmathvariant=italic

5 2011, Maths for More Font configuration. V1 5 fontident, fontnumber, font and typeface fontident and fontnumber can be used to specify the identifier and numbers typeface respectively. For example, to render variables and numbers with Verdana font: fontident=verdana fontnumber=verdana Let s remember that this will only work if Verdana is installed in the server that hosts WIRIS editor. If a given typeface is small or big in comparison with the default typeface, it is also possible to give a scaling percentage: fontident=palatino Linotype,110 which means that identifiers are rendered with Palatino Linotype typeface scaled at 110%. It is possible to select the typeface for a range of characters, for example font0=x3b1-x3ff;lucida Console,105 tells the formula editor to use Lucida Console for Greek letters scaled at 105%. The range x3b1-x3ff corresponds to the hexadecimal Unicode Greek alphabet range. It is possible to give more than one typeface parameter as follows: font0= x3b1-x3ff;lucida Console,105 font1= x41-x5a;helvetica Available fonts in the server The available fonts in a server depend on a diversity of factors. The most important is the Operating system. For example, Windows comes with many fonts. On the other hand, a Linux server will have very few fonts. It also depends whether java-sun or OpenJDK is used. To test the available fonts the attached scripts can be used. You can download the corresponding script and execute from the command line. java DrawFonts It will create a series of files font0.png, font1.png, with the available fonts to Java. It is important to execute the script with the same Java version of the Web application server. Each output file contains how Java draws the available fonts. For example, One important information is the factor value. When specifing Bell MT as a typeface for the editor, the value 112 should be speceified as factor in order that the characters in Bell MT does not appear smaller than the surronding ones. For example, fontident=bell MT,112 Will edit formulas like

6 2011, Maths for More Font configuration. V1 6 Note how a and x are Bell MT while digits are still Arial.