From 9ae28b12ddbb53a22e48f385e9c26a9a65ce830d Mon Sep 17 00:00:00 2001 From: Joris van der Hoeven Date: Mon, 9 Jun 2014 19:45:52 +0000 Subject: [PATCH] Update technical documentation of environment variables which control the font --- devel/format/environment/env-font.en.tm | 111 ++++++++++-------------- 1 file changed, 47 insertions(+), 64 deletions(-) diff --git a/devel/format/environment/env-font.en.tm b/devel/format/environment/env-font.en.tm index 3c66e6e..d0def20 100644 --- a/devel/format/environment/env-font.en.tm +++ b/devel/format/environment/env-font.en.tm @@ -1,4 +1,4 @@ - + @@ -6,26 +6,23 @@ In this section, we describe the environment variables which control the - rendering of fonts. Several parameters may be defined independently for - each mode (the font name, variant, series and shape), whereas other - parameters are uniform for all modes. Font properties may be controlled - globally for the whole document in and locally for - document fragments in . + rendering of fonts. Font properties may be controlled globally for the + whole document in and locally for document fragments + in . From an abstract point of view, a is defined to be a graphically consistent way of rendering strings. Fonts are usually made up from glyphs - like ``x'', ``ffi'', ``>'', - ``>>'', When rendering a - string, the string is decomposed into glyphs so as to take into account - ligatures (like fi, fl, ff, ffi, ffl). Next, the individual glyphs are - positioned while taking into account kerning information (in ``xo'' the - ``o'' character is slightly shifted to the left so as to take profit out of - the hole in the ``x''). In the case of mathematical fonts, also - provides a coherent rendering for resizable characters, like the large - brackets in + like ``x'', ``ffi'', ``>'', ``>>'', + When rendering a string, the string is decomposed into glyphs + so as to take into account ligatures (like fi, fl, ff, ffi, ffl). Next, the + individual glyphs are positioned while taking into account kerning + information (in ``xo'' the ``o'' character is slightly shifted to the left + so as to take profit out of the hole in the ``x''). In the case of + mathematical fonts, also provides a coherent rendering for + resizable characters, like the large brackets in <\equation*> - . + >>|)>>>>|)>. Similarly, a is a family of fonts with different @@ -37,20 +34,19 @@ font do not. <\remark> - For the future, it is planned to replace the font variant and font shape - variables by a larger range of properties to individually control the - slant, serifs, small-caps, and so on. It is also planned to - systematically use Unicode fonts with possible additional glyphs for - mathematics. This should automatically enable the use of Cyrillic - characters inside Russian text and similarly for other languages. + In versions of prior to 1.99.1, the fonts for the mathematical + and programming modes could be controlled independently using the + environment variables , , + , , + , , + , . In more recent + versions of , the environment variables , + , and + directly control the font for all modes. <\explain> - - - - - + <|explain> These variables control the main name of the font, also called the . For instance: @@ -63,22 +59,28 @@ Similarly, supports various mathematical fonts: <\tm-fragment> - Roman: +b=c> + Roman: +b=c> - Adobe: +b=c>> + Adobe: +b=c>> - New roman: +b=c>> + New roman: +b=c>> - Concrete: +b=c>> + Concrete: +b=c>> + + Most fonts only implement a subset of all Unicode glyphs. Sometimes, the + user might wish to combine several fonts to cover a larger subset. For + instance, when specifying or + as the name, ordinary text + and mathematics will be typeset using the default font, + whereas Chinese text will use the font. Similarly, + when specifying as the name, + ordinary text will be typeset using the default font, + but mathematical formulas using the font. <\explain> - - - - - + <|explain> This variable selects a variant of the major font, like a sans serif font, a typewriter font, and so on. As explained above, variants of a @@ -93,29 +95,14 @@ <\tm-fragment> roman, and - - In maths mode, a distinction is made between the mathematical variants - (roman), (typewriter) and (sans - serif) and textual variants (roman), (bold), - etc. In the first case, variables and operators are usually rendered in a - different slant, contrary to the second case: - - <\tm-fragment> - : > - - : > + Sans serif formula: =sin x*cos y+cos x*sin y>> <\explain> - - - - - + <|explain> The font series determines the weight of the font. Most fonts only provide and font weights. Some fonts @@ -127,11 +114,7 @@ <\explain> - - - - - + <|explain> The font shape determines other characters of a font, like its slant, whether we use small capitals, whether it is condensed, and so on. For @@ -152,12 +135,12 @@ <|explain> - The base font size is specified in + The base font size is specified in units|../basics/lengths.en.tm> and is usually invariant throughout the document. Usually, the base font size is , , or . Other font sizes are usually obtained - by changing the |env-general.en.tm#magnification> - or the relative . + by changing the |env-general.en.tm#magnification> + or the relative . <\tm-fragment> , , @@ -178,8 +161,8 @@ huge>>|>>>>|Standard font sizes.> From a mathematical point of view, the multipliers are in a geometric - progression with factor >. Notice - that the font size is also affected by the >. Notice that the font + size is also affected by the .