summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/fonts/libertine/README
blob: a4094cb15f5150679cab4a39d2c8984011907cd8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
This is the README for libertine, version 5.3.0 (2012-11-27).

This package provides support for use of the Linux Libertine and Linux
Biolinum families of fonts with LaTeX, pdfLaTeX, xeLaTeX and luaLaTeX.
It is intended to replace several existing packages (libertine-type1,
biolinum-type1, libertine) and should provide partial compatibilty with
libertineotf and the obsolete libertine-legacy package.

To install this package on a TDS-compliant TeX system unzip the
file /install/fonts/libertine.tds.zip at the root of an appropriate
texmf tree, likely a personal or local tree. If necessary, update
the file-name database (e.g., texhash). Update the font-map files by
enabling the Map file libertine.map.

For most purposes, simply add

\usepackage{libertine}

to the preamble of your document. This will activate Libertine as
the main (serifed) text font and Biolinum as the sans font. It is
recommended that the font encoding be set to T1 or LY1, but the default
OT1 encoding is also supported. Available shapes in all series include:

it              italic
sc              small caps
scit            italic small caps

Slanted variants are not supported; the designed italic variants will be
automatically substituted. The exception is the bold series of Biolinum,
for which a designed italic is not currently available. An artificially
slanted variant has been generated and treated as if it were italic.

To activate Libertine without Biolinum, use the libertine (or rm)
option. Similarly, to activate Biolinum without Libertine use the
biolinum (or sf) option. To use Biolinum as the main text font (as
well as the sans font), use the option sfdefault (which redefines
\familydefault, not \rmdefault).

LuaLaTeX and xeLaTeX users who might prefer to use type1 fonts or who
wish to avoid fontspec may use the type1 option; libertine-type1 and
biolinum-type1 wrapper packages are included to provide compatibility
with the older packages. For legacy documents that use only basic
facilities of libertineotf, a similar wrapper libertineotf is provided.
Note that a package that allows for all LaTeX engines can't support all
the features provided by the libertineotf package. The following are
*not* supported:

 Option mono and font-features such as Ligatures or Scale as option parameters

 Macro support for the Mono, Initial, Display, Outline, Shadow, or Keyboard fonts 

 Commands \Lnnum, \Lpnum, Lcnum, etc.

 Environments Ltable and libertineenumerate 

 Macros \LKey... and  \LMouse...

If your documents use any of the features of libertineotf listed above,
you may have to continue to use the libertineotf package (available from
CTAN) or access the otf fonts directly using fontspec.

The following options are available in all styles:

oldstyle (osf)    old-style figures
lining (nf,lf)    lining figures

proportional (p)  varying-width figures
tabular (t)       fixed-width figures

The defaults are oldstyle and proportional. These apply to both font
families; to change the default figure style of just the Biolinum (sans)
fonts, use options

sflining (sflf) or sfoldstyle (sfosf)

sftabular (sft) or sfproportional (sfp) 

The semibold (sb) option will set \bfdefault to sb to allow using the
semi-bold series of Libertine; this has no effect on the Biolinum fonts,
for which there is no semi-bold variant. The options scale=<number> (or
scaled=<number>) will scale the Biolinum fonts but have no effect on the
Libertine fonts.

Commands \oldstylenums{...} and \oldstylenumsf{...} are defined to
allow for local use of old-style figures in Libertine and Biolinum,
respectively, if lining figures is the default, and similarly
\liningnums{...} and \liningnumsf{...}.

Similarly, commands \tabularnums{...} and \tabularnumsf{...} are defined
to allow local use of monospaced figures in Libertine or Biolinum,
respectively, if proportional figures is the default, and similarly
\proportionalnums{...} and \proportionalnumsf{...}.

Superior numbers (for footnote markers) are available using \sufigures
or \textsu{...}.

Macros \libertine, \libertineSB, \libertineOsF, \libertineLF, select the
Libertine family, the Libertine family and the semi-bold series, the
Libertine family with Oldstyle figures, and the Libertine family with
Lining Figures, respectively.

Macros \biolinum, \biolinumOsF, and \biolinumLF select the Biolinum
family, the Biolinum family with Oldstyle figures, and the Biolinum
family with Lining Figures, respectively.

Macros \libertineGlyph{...} and \biolinumGlyph{...} produce the
glyph named in the argument; for example, \libertineGlyph{Tux} and
\libertineGlyph{uniE000} both produce the Linux penguin. These macros
work only with the otf fonts.

The fonts used for the features described above are in the type1 and
opentype directories. Their internal font-family name has been changed
to LinuxLibertineT and LinuxBiolinumT to avoid interfering with xeLaTeX
users who access system fonts. The opentype directory also has several
additional fonts which can be activated using fontspec (with xeLaTeX
or luaLaTeX): 

 LinLibertine530_DR     a display font  
 LinLibertine530_I      a font of large initials 
 LinBiolinum530_K       a keyboard font
 LinLibertine530_M      a monospaced font 

For compatible mathematics, it is recommended to use the newtxmath
package with the libertine option.

The original opentype fonts were created by Philipp H. Poll (gillian at
linuxlibertine.org) and are licensed under the terms of the GNU General
Public License (Version 2, with font exception) and under the terms of
the Open Font License. For details look into the doc directory of the
distribution or at

http://www.linuxlibertine.org/

Three of the Libertine fonts were modified by Michael Sharpe (msharpe at
ucsd.edu) using fontforge to correct minor problems, including adding
three missing ligatures (fl, ffl, ffi) to the bold-italic font.

Thanks to Herbert Voss, Patrick Gundlach, Silke Hofstra, Michael Sharpe
and Khaled Hosny for their assistance.

The type1 fonts were created using cfftot1 or fontforge. The support
files were created using autoinst. The support files are licensed under
the terms of the LaTeX Project Public License. The maintainer of this
package is Bob Tennent (rdt at cs.queensu.ca)