summaryrefslogtreecommitdiff
path: root/support/luafindfont/man/luafindfont.1
blob: 26f976c4036126702068fba0b757b8a732747d2d (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
.\" Manpage for luafindfont.
.\" Contact hvoss@tug.org to correct errors or typos.
.TH luafindfont 1 "02 sep 2022" "0.10" "luafindfont man page"
.SH NAME
luafindfont
\- retrieve font informations of all installed system and TeX fonts.
.SH SYNOPSIS
luafindfont [options] <fontname>
.SH DESCRIPTION
This command lists informations about installed otf|ttf|ttc fonts,
installed by the system and by the TeX distribution
.SH OPTIONS
.IP -h,--help
obvious ... :-)
.IP -o,--otfinfo (default 0)
Use the program otfinfo for the font with the given number. The number
can be followed by an optional argument for otfinfo, e.g. -o 2f, list
all features for font no 2. Without an additional character, otfinfo is
called with -i
.IP -i,--info (default 0)
List the given fontstyles (regular, bold, italic, bolditalic)
for the font with the given number
.IP -v,--verbose  Verbosity level
Give more informations, by now only -v works
.IP -x,--xetex  
test, if font is found by xetex via kpsewhich 0->no; 1->yes
.IP -m,--max_string (default 90)
The maximum of the stringlength of the full path of fonts
.IP -n,--no-symbolic-names  (altenatively --nosymbolicnames)
The fontlist contains only fontfile and fontpath
.IP <fontname> 
Can be a substring, e.g. times,  or a combination of two substrings 
which act like a boolean and, e.g. "times & bold" (must be in quotes). 
All strings are not case sensitive. Upper and lowercase can be mixed.
.SH EXAMPLES

$ luafindfont libertinussans

.Pp 
Lists all fonts which have names or part of like libertinussans 

.nf
.ft CW
bash-3.2$ ./luafindfont.lua libertinussans
  No.                   Fontname  Symbolic Name                                                                        Path
   1.    LibertinusSans-Bold.otf libertinussans  /usr/local/texlive/2022/texmf-dist/fonts/opentype/public/libertinus-fonts/
   2.  LibertinusSans-Italic.otf libertinussans  /usr/local/texlive/2022/texmf-dist/fonts/opentype/public/libertinus-fonts/
   3. LibertinusSans-Regular.otf libertinussans  /usr/local/texlive/2022/texmf-dist/fonts/opentype/public/libertinus-fonts/

.ft R
.fi

.Pp
The --otfinfo:

$ luafindfont -o 3 libertinussans

.Pp
This produces the following output:

.nf
.ft CW
 1.    LibertinusSans-Bold.otf libertinussans                          /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Bold.otf
 2.    LibertinusSans-Bold.otf libertinussans  /usr/local/texlive/texmf-d...onts/opentype/public/libertinus-fonts/LibertinusSans-Bold.otf
 3.  LibertinusSans-Italic.otf libertinussans                        /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Italic.otf
 4.  LibertinusSans-Italic.otf libertinussans  /usr/local/texlive/texmf-d...ts/opentype/public/libertinus-fonts/LibertinusSans-Italic.otf
 5. LibertinusSans-Regular.otf libertinussans                       /Users/voss/Library/Fonts/libertinus-fonts/LibertinusSans-Regular.otf
 6. LibertinusSans-Regular.otf libertinussans  /usr/local/texlive/texmf-d...s/opentype/public/libertinus-fonts/LibertinusSans-Regular.otf

Running otfinfo on font no.3
Family:              Libertinus Sans
Subfamily:           Italic
Full name:           Libertinus Sans Italic
PostScript name:     LibertinusSans-Italic
Version:             Version 7.020;RELEASE
Unique ID:           1.000;QUE ;LibertinusSans-Italic
Designer:            Philipp H. Poll, Khaled Hosny
Manufacturer:        Caleb Maclennan
Vendor URL:          https://github.com/alerque/libertinus
Copyright:           Copyright © 2012-2020 The Libertinus Project Authors.
License URL:         https://scripts.sil.org/OFL
License Description: This Font Software is licensed under the SIL Open Font License, Version 1.1
Vendor ID:           QUE

.ft R
.fi

.Pp
The --no-symbolc-names:

$ luafindfont -n 

.Pp
This produces the following output:

.nf
.ft CW
bash-3.2$ luafindfont -n minion
 Nr.                 Fontname                                   Path
   1.      MinionMath-Bold.otf  /Users/voss/Library/Fonts/MinionMath/
   2.   MinionMath-Regular.otf  /Users/voss/Library/Fonts/MinionMath/
   3.       MinionPro-Bold.otf   /Users/voss/Library/Fonts/MinionPro/
   4.     MinionPro-BoldCn.otf   /Users/voss/Library/Fonts/MinionPro/
   5.   MinionPro-BoldCnIt.otf   /Users/voss/Library/Fonts/MinionPro/
   6.     MinionPro-BoldIt.otf   /Users/voss/Library/Fonts/MinionPro/
   7.       MinionPro-Capt.otf   /Users/voss/Library/Fonts/MinionPro/
   8.       MinionPro-Disp.otf   /Users/voss/Library/Fonts/MinionPro/
   9.         MinionPro-It.otf   /Users/voss/Library/Fonts/MinionPro/
  10.     MinionPro-Medium.otf   /Users/voss/Library/Fonts/MinionPro/
  11.   MinionPro-MediumIt.otf   /Users/voss/Library/Fonts/MinionPro/
  12.    MinionPro-Regular.otf   /Users/voss/Library/Fonts/MinionPro/
  13.   MinionPro-Semibold.otf   /Users/voss/Library/Fonts/MinionPro/
  14. MinionPro-SemiboldIt.otf   /Users/voss/Library/Fonts/MinionPro/
  15.       MinionPro-Subh.otf   /Users/voss/Library/Fonts/MinionPro/
.ft R
.fi

.SH See also
See luafindfont-doc.pdf for more details
.SH BUGS
No known bugs.
.SH AUTHOR
Herbert Voß (hvoss@tug.org)
.SH LICENSE
Permission is granted to copy, distribute and/or modify this software
under the terms of the LaTeX Project Public License, version 1.3.