Difference between revisions of "Fonts"

From Wiki
Jump to navigation Jump to search
m (Text replacement - "pragma-ade.com" to "pragma-ade.nl")
 
(163 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= How to use one of the provided fonts: 4 steps, 10 sec. =
+
__NOTOC__
  
; #1. First, be aware of the [[ConTeXt distribution's Fonts|21 fonts provided]].
+
Using fonts with TeX was once a Jedi fight, before XeTeX and LuaTeX development. Nowadays, using fonts is simple.
:* If required, you can [[Mtxrun#fonts| regenerate the font database]] <code>mtxrun --script font --reload --force</code>
 
  
; #2. Give a name to the set of fonts you want to use and select a first font
+
= Using fonts =  
:* Use the command {{cmd|definefontfamily}}.
 
:* Let's take an example, for a Serif font, for which TeX practice is to refer to them as '''roman''' (=rm)
 
:* <texcode>\definefontfamily[MyFontIdentifier][rm][refcode to the serif font]</texcode>
 
  
; #3. Declare it as your default font family for your document
+
You will find here the preliminary steps before actually playing with the fonts in your input file.
:* Use the command with {{cmd|setupbodyfont}}
+
At the end, with one or two commands, you will make your document enable to use any fonts available on your computer.
:* <texcode>\setupbodyfont[MyFontIdentifier]</texcode>
 
  
; #4. Specify the font size
 
:* <texcode>\setupbodyfont[xxpt]</texcode>
 
  
To learn how to use different alternative styles of a given font, like regular / bold / italic, see the [[Font_Switching]] in the [[Basics]].
+
{{TwoColumnsHighlight
 
 
== Example ==
 
{{TwoColumnsUnderLevel1
 
|
 
Let see what give the defaults:
 
<context source=yes>
 
\setupbodyfont[12pt]
 
{The quick brown fox jumps over the lazy dog}\\
 
{\bf The quick brown fox jumps over the lazy dog}\\
 
{\it The quick brown fox jumps over the lazy dog}\\
 
</context>
 
 
|
 
|
And let's add the two lines, using Tex Gyre Pagella Serif font (ref:texgyrepagella):
+
=== [[Use fonts distributed with ConTeXt| Use fonts distributed with ConTeXt]] ===
<context source=yes>
+
* How to use the [[ConTeXt distribution's Fonts|21 provided fonts]].
\definefontfamily [MyFontIdentifier] [rm] [texgyrepagella]
+
* These are the basics you may want to start with, in 2 or 3 steps, less than 3 minutes.
\setupbodyfont[MyFontIdentifier]
+
|
\setupbodyfont[12pt]
+
=== [[Use_the_fonts_you_want| Use any other font ]] ===
{The quick brown fox jumps over the lazy dog}\\
+
* Case 1: Quick "one shot" (< 5min.)
{\bf The quick brown fox jumps over the lazy dog}\\
+
* Case 2: Comprehensive approach (~10min.)
{\it The quick brown fox jumps over the lazy dog}\\
 
</context>
 
 
}}
 
}}
  
= How to use more than one of the provided fonts: 1 step, 5 sec. =
 
 
; #1. Very similarly to above, just select a second font
 
:* for a Sans Serif font, for which TeX practice is to refer to them as '''Sans Serif''' (=ss)
 
:* <texcode>\definefontfamily[MyFontIdentifier][ss][refcode to the sans serif font]</texcode>
 
:* for a monospaced font, for which TeX practice is to refer to them as '''TypewriTer''' (=tt)
 
:* <texcode>\definefontfamily[MyFontIdentifier][tt][refcode to the monospaced font]</texcode>
 
 
 
== Example ==
 
{{TwoColumnsUnderLevel1
 
|
 
This basic input is typeset with the default font, Latin Modern:
 
<context source=yes>
 
\setupbodyfont[12pt]
 
{\rm    The quick brown fox jumps over the lazy dog}\\
 
{\rm\bf The quick brown fox jumps over the lazy dog}\\
 
{\rm\it The quick brown fox jumps over the lazy dog}\\
 
\\
 
{\ss    The quick brown fox jumps over the lazy dog}\\
 
{\ss\bf The quick brown fox jumps over the lazy dog}\\
 
{\ss\it The quick brown fox jumps over the lazy dog}\\
 
\\
 
{\tt    The quick brown fox jumps over the lazy dog}\\
 
{\tt\bf The quick brown fox jumps over the lazy dog}\\
 
{\tt\it The quick brown fox jumps over the lazy dog}\\
 
</context>
 
|
 
And by adding the two lines discussed above, and using the reference to Tex Gyre Pagella Serif font (texgyrepagella) we obtain:
 
<context source=yes>
 
\definefontfamily [MyFontIdentifier] [rm] [texgyrepagella]
 
\definefontfamily [MyFontIdentifier] [ss] [texgyreadventor]
 
\definefontfamily [MyFontIdentifier] [tt] [texgyrecursor]
 
\setupbodyfont[MyFontIdentifier]
 
\setupbodyfont[12pt]
 
{\rm    The quick brown fox jumps over the lazy dog}\\
 
{\rm\bf The quick brown fox jumps over the lazy dog}\\
 
{\rm\it The quick brown fox jumps over the lazy dog}\\
 
\\
 
{\ss    The quick brown fox jumps over the lazy dog}\\
 
{\ss\bf The quick brown fox jumps over the lazy dog}\\
 
{\ss\it The quick brown fox jumps over the lazy dog}\\
 
\\
 
{\tt    The quick brown fox jumps over the lazy dog}\\
 
{\tt\bf The quick brown fox jumps over the lazy dog}\\
 
{\tt\it The quick brown fox jumps over the lazy dog}\\
 
</context>
 
}}
 
 
 
= How to use my new font: 6 steps, 5 minutes =
 
 
Let's take a example, we want to use [https://fonts.google.com/specimen/Noto+Serif Noto Serif].
 
 
; #1. Download
 
:*The google website enable us to download a zip file with the 4 alternative styles:
 
:** Regular 400
 
:** Regular 400 italic
 
:** Bold 700
 
:** Bold 700 italic
 
 
; #2. Store them is a dedicated folder
 
:* create a "Noto-serif" in the ConTeXt distribution <code>tex/texmf-fonts</code>.
 
:* unzip and store the .ttf file in <code>tex/texmf-fonts/Noto-serif/</code>.
 
  
; #3. Regenerate ConTeXt databases
+
The actual use of fonts within your document is detailed in '''[[Font Switching]]''':
:* the file database:  <code>mtxrun --generate</code>
+
* how to define font size,
:* the fonts database: <code>mtxrun --script font --reload</code>
+
* how to use alternative styles like regular / bold / italic / small caps
 +
* how to switch between serif, sans serif, monospaced, or to another fonts with {{cmd|switchtobodyfont}}
 +
* how to underline, strike...
  
; #4. Check if the 4 files are identified by ConTeXt now:
+
= Advanced stuff =
:* <code>mtxrun --script font --list --file -pattern=*noto*</code>
 
  
; #5. Define them as a new typescript (ConTeXt vocabulary) in your input file.
+
== The Manuals ==
:* Use the commands {{cmd|starttypescript}} and {{cmd|definefontsynonym}} to declare
 
  
<texcode>
+
* [http://www.pragma-ade.nl/general/manuals/fonts-mkiv.pdf 2016 Fonts manual, all the details] for advanced users
\starttypescript [serif] [notoserif]
+
* [http://context.aanhet.net/svn/contextman/context-reference/en/co-fonts.pdf the 2013 font chapter] as a separate document
  \definefontsynonym[NotoSerif-Regular]        [file:NotoSerif-Regular]
+
* [http://pmrb.free.fr/contextref.pdf#&#91;145,{%22name%22:%22Fit%22}&#93; 2013 reference manual] never officially released, with the 2013 font chapter
  \definefontsynonym[NotoSerif-Italic]          [file:NotoSerif-Italic]
 
  \definefontsynonym[NotoSerif-Bold]            [file:NotoSerif-Bold]
 
  \definefontsynonym[NotoSerif-BoldItalic]      [file:NotoSerif-BoldItalic]
 
\stoptypescript
 
</texcode>
 
  
; #6. Define them as part of your font family, here as a roman
+
== Deep dive into typescripts ==
<texcode>
 
\definefontfamily [MyFontIdentifier] [rm] [notoserif]
 
</texcode>
 
  
 +
* [[Typescripts examples]] look at the existing examples to build your own Typescripts.
 +
* [[Featuresets]], and here some of common option for {{cmd|definefontfeature}}
 +
** <code>onum=yes</code> for old style numbers, vs <code>lnum=yes</code> for lining numbers
 +
** <code>kern=yes</code> for kerning
 +
** See [[Ligatures]] (2017). <code>liga=yes</code> for common ligature and <code>dlig=yes</code> for discretionary ligature (like st), <code>calt=yes</code> for contextual alternates.
 +
** for small caps, the font must propose Caps variation like "EBGaramondSC12-Regular.otf" et "AlegreyaSC-Regular.otf"
 +
** [https://helpx.adobe.com/fonts/using/open-type-syntax.html Syntax for OpenType features] from Adobe
 +
* [[Fontsize|What defines the size in a font?]] (2019)
 +
* [[Optical Size|How to set up a font family with optical size options]]
 +
* [[Protrusion]] (also known as hanging or font handling) is a more subtle typographic effect  (2012 need update).
  
Finally, we shoud have:
+
* [https://source.contextgarden.net/?search=s-fonts- the source browser] for s-fonts- files, that a user can run (to get an example) or use as module for own fonts
 +
* Lua Font Goodies with examples.
  
<texcode>
 
\starttypescript [serif] [notoserif]
 
  \definefontsynonym[NotoSerif-Regular]        [file:NotoSerif-Regular]
 
  \definefontsynonym[NotoSerif-Italic]          [file:NotoSerif-Italic]
 
  \definefontsynonym[NotoSerif-Bold]            [file:NotoSerif-Bold]
 
  \definefontsynonym[NotoSerif-BoldItalic]      [file:NotoSerif-BoldItalic]
 
\stoptypescript
 
  
\definefontfamily [MyFontIdentifier] [rm] [notoserif]
+
Finally, for older content, refering to mkii, we keep a [[Fonts - Old Content|specific zone in the wiki]]. Work is also need to merge content of [[Fonts_in_LuaTeX]] here.
  
\setupbodyfont[MyFontIdentifier]
 
\setupbodyfont[12pt]
 
{\rm    The quick brown fox jumps over the lazy dog}\\
 
{\rm\bf The quick brown fox jumps over the lazy dog}\\
 
{\rm\it The quick brown fox jumps over the lazy dog}\\
 
</texcode>
 
  
 +
* {{cmd|definefontfamily}}
 +
* {{cmd|definedfont}}
  
{{todo|naming conventions for definefontssymonym ?}}
 
  
{{todo:How to use font from your system.}}
+
[[Category:Fonts]]

Latest revision as of 08:26, 2 July 2022


Using fonts with TeX was once a Jedi fight, before XeTeX and LuaTeX development. Nowadays, using fonts is simple.

Using fonts

You will find here the preliminary steps before actually playing with the fonts in your input file. At the end, with one or two commands, you will make your document enable to use any fonts available on your computer.



The actual use of fonts within your document is detailed in Font Switching:

  • how to define font size,
  • how to use alternative styles like regular / bold / italic / small caps
  • how to switch between serif, sans serif, monospaced, or to another fonts with \switchtobodyfont
  • how to underline, strike...

Advanced stuff

The Manuals

Deep dive into typescripts

  • the source browser for s-fonts- files, that a user can run (to get an example) or use as module for own fonts
  • Lua Font Goodies with examples.


Finally, for older content, refering to mkii, we keep a specific zone in the wiki. Work is also need to merge content of Fonts_in_LuaTeX here.