Debian Codegraph @

texmf-dist/source/metapost/metatype1/README

raw
1 === === === === === === === === === === === === === === === === === === ===
2 ENGLISH:
3 === === === === === === === === === === === === === === === === === === ===
4 This is METATYPE1 package -- a tool for creating Type 1 fonts using
5 METAPOST. The package belongs to public domain (no copyrights, copylefts,
6 copyups, copydowns, etc.).
7
8 Version: 0.56 (27.04.2015; a tentative version, released along with
9 the sources of the Latin Modern fonts ver. 2.003)
10 Author: JNS team <[email protected]>
11
12 Warning: package is still under development, upwards incompatible
13 changes are likely to occur.
14
15 The METATYPE1 package consist of:
16 mt1set.bat -- a batch file that sets the system variable METATYPE1
17 (it should point to the directory where reside
18 the working files of the METATYPE1 package);
19 it is exploited by other batches of the package
20 mkfont.bat -- a batch file for the generation of a font; it should be
21 called with the font file name without an extension
22 (there are two batches more related to mkfont.bat,
23 namely: mkt1.bat generates a Type 1 font without
24 generating a tfm metric file and mktfm.bat that
25 generates only a tfm file)
26 fontbase.mp -- a set of METAPOST macros for creating Type 1 fonts
27 plain_ex.mp -- an extension of plain.mp, useful not only for
28 creating fonts; it is input by fontbase.mp;
29 plain_e_.mp -- the set of illustrations to plain_ex.mp documentation
30 mp2pf.awk -- an AWK script that creates Type1 font (in a text form)
31 out of METAPOST generated EPSes
32 pfcommon.dat -- data for mp2pf.awk script (fixed elements of font)
33 e-*.mp -- the set of encoding files (used for preparing
34 the Latin Modern and TeX Gyre font packages):
35 e-ase.mp -- Adobe Standard Encoding
36 e-cs.mp -- TeX encoding for the Czech language
37 e-cscsc.mp -- TeX encoding for the Czech language altered
38 for the compatibility with Computer Modern cmcsc10
39 e-cssc.mp -- TeX encoding for the Czech language containing small caps
40 (*.sc glyps; TeX Gyre fonts)
41 e-cstt.mp -- TeX encoding for the Czech language altered for
42 the compatibility with Computer Modern cmtt10
43 e-csttsc.mp -- TeX encoding for the Czech language altered
44 for the compatibility with Computer Modern cmtcsc10
45 e-ec.mp -- TeX EC (Cork; T1 in LaTeX lingo) encoding
46 e-ecsc.mp -- TeX EC (Cork; T1 in LaTeX lingo) encoding
47 containing small caps (*.sc glyps; TeX Gyre fonts)
48 e-l7x.mp -- TeX encoding for the Lithuanian language
49 e-l7xsc.mp -- TeX encoding for the Lithuanian language
50 containing small caps (*.sc glyps; TeX Gyre fonts)
51 e-qx.mp -- TeX encoding for the Polish language
52 e-qxcsc.mp -- TeX encoding for the Polish language altered for
53 the compatibility with Computer Modern cmcsc10
54 e-qxsc.mp -- TeX encoding for the Polish language containing small caps
55 (*.sc glyps; TeX Gyre fonts)
56 e-qxtt.mp -- TeX encoding for the Polish language altered for
57 the compatibility with Computer Modern cmtt10
58 e-qxttsc.mp -- TeX encoding for the Polish language altered
59 for the compatibility with Computer Modern cmtcsc10
60 e-qxwin.mp -- Windows encoding for the Polish language
61 e-rm.mp -- TeX RM encoding (``roman math'')
62 e-rmcsc.mp -- TeX RM encoding (``roman math'') altered for the
63 compatibility with Computer Modern cmcsc10
64 e-rmsc.mp -- TeX RM encoding (``roman math'') containing small caps
65 (*.sc glyps; TeX Gyre fonts)
66 e-rmtt.mp -- TeX RM encoding (``roman math'') altered
67 for the compatibility with Computer Modern cmtt10
68 e-rmttsc.mp -- TeX RM encoding (``roman math'') altered
69 for the compatibility with Computer Modern cmtcsc10
70 e-t2a.mp, e-t2b.mp, e-t2c.mp -- Cyrillic encodings
71 e-t5.mp -- TeX Vietnamese encoding (T5 in LaTeX lingo)
72 e-t5sc.mp -- TeX Vietnamese encoding containing small caps
73 (*.sc glyps; TeX Gyre fonts)
74 e-ts1.mp -- TeX text companion encoding (TS1 in LaTeX lingo)
75 e-yy.mp -- TeX Y&Y encoding (aka LY1, aka TeX'n'ANSI)
76 e-yysc.mp -- TeX Y&Y encoding (aka LY1, aka TeX'n'ANSI) for fonts
77 containing small caps (*.sc glyps; TeX Gyre fonts)
78 packsubr.awk -- AWK script for making subroutines out of the repeating
79 fragments of PostScript code in a font file
80 afm2pfm.bat -- a batch file that converts an AFM file (Adobe font
81 metric) into a PFM (printer font metric) one
82 afm2pfm.pl -- a Perl script for the above conversion
83 mkproof.bat -- a batch file for running mft (METAFONT nad METAPOST
84 formatting) program; the usage is described in the file
85 mt1form.mft -- formatting data, necessary for mft program
86 mt1form.sty -- TeX (plain) macros for formatting documentation
87 README -- this file
88
89 Additionally, the METATYPE1 distribution contains the pf2mt1 package for
90 converting converting a Type 1 font into a METATYPE1 form. The conversion
91 preserves as much as possible font parameters; the resulting font generated
92 by METATYPE1 is, in normal circumstances, almost identical with the
93 original one. The package pf2mt1 consists of three files:
94 pf2mt1.bat -- batch file; its parameter is the name of the font
95 (without an extension); the font must consist of
96 PFB and AFM files
97 pf2mt1.awk -- AWK script; the main engine
98 pf2mt1.exc -- a sample file defining ``exception chars,'' i.e.,
99 excluded from the conversion or renamed during it
100 This package is useful for beginners who would like to see how METATYPE1
101 works. The fonts generated by pf2mt1 are a good example of using
102 the METATYPE1 package, although they do not make use of all possibilities
103 it offers (in particular, the resulting fonts are not parameterized).
104
105 The METATYPE1 package requires the following external programs (in
106 parentheses are given the versions which we use):
107 Metapost (0.641/Web2c 7.5.2)
108 Gawk (3.1.3)
109 t1utils (t1asm and t1disasm, 1.28)
110 The package also employs:
111 Perl (5.8.0) -- for generating PFM files (afm2pfm.bat)
112 MFT (Web2C 7.5.2, 2.0) -- for formatting documentation (mkproof.bat)
113 EPSINCL (0.43) -- for including stencil EPSes into documentation;
114 this package is attached in the subdirectory ``extra''
115
116 In order to install the package, you should copy batch files into an
117 appropriate subdirectory searched by system (environment variable PATH),
118 copy the other files into a user-chosen directory and change the setting
119 of the METATYPE1 enviroment variable in the batch mt1set.bat -- the variable
120 should contain the name of the chosen directory.
121
122 The subdirectory ``samples'' contains examples of METATYPE1 sources
123 of a few trivial fonts. They may be treated as a part of the documentation
124 of the METATYPE1 package.
125
126 We suggest familiarising with a METATYPE1 version of D. E. Knuth's
127 logo font (the file logomp03.zip)---alike pf2mt1 package, it may
128 prove useful useful during the first steps in METATYPE1.
129
130 === === === === === === === === === === === === === === === === === === ===
131 POLSKI:
132 === === === === === === === === === === === === === === === === === === ===
133 To jest pakiet METATYPE1 -- narz/edzie do tworzenia font/ow Type 1
134 za pomoc/a systemu METAPOST. Pakiet stanowi dobro wsp/olne
135 (/zadnych copyright/ow, copyleft/ow, copyup/ow, copydown/ow, etc.).
136 Wersja: 0.55 (16.09.2009 -- wersja opublikowana wraz z wersj/a /xr/od/low/a
137 2.003 pakietu font/ow Latin Modern)
138 Autorstwo: JNS team <[email protected]>
139
140 Uwaga: pakiet znajduje si/e w fazie rozwoju, mo/zliwe s/a jeszcze
141 zmiany niekompatybilne wstecz.
142
143 W sk/lad pakietu METATYPE1 wchodz/a:
144 mt1set.bat -- plik wsadowy ustawiaj/acy zmienn/a systemow/a METATYPE1
145 tak by wskazywa/la kartotek/e, w kt/orej umieszczone
146 zosta/ly pliki robocze pakiety METATYPE1; pozosta/le
147 pliki wsadowe pakietu odwo/luj/a si/e do mt1set.bat
148 mkfont.bat -- plik wsadowy uruchamiaj/acy proces tworzenia fontu;
149 parametrem jest nazwa fontu bez rozszerzenia
150 fontbase.mp -- zestaw makr METAPOST-owych, umo/zliwiaj/acych
151 generowanie font/ow Type 1
152 plain_ex.mp -- rozszerzenie formatu plain.mp, przydatne nie tylko
153 przy generowaniu font/ow, wczytywane przez fontbase.mp
154 plain_e_.mp -- ilustracje do dokumentacji plain_ex.mp
155 mp2pf.awk -- podstawowy skrypt AWK-owy, tworz/acy font Type 1
156 (w postaci tekstowej) na podstawie EPS-/ow generowanych
157 przez METAPOST-a
158 pfcommon.dat -- dane dla skryptu mp2pf.awk (sta/le elementy fontu)
159 e-*.mp -- podstawowy zestaw plik/ow definiuj/acych przypisanie
160 nazwom znak/ow odpowiednich kod/ow (encoding):
161 e-ase.mp -- Adobe Standard Encoding
162 e-cs.mp -- TeX-owe kodowanie dla j/ezyka czeskiego
163 e-cscsc.mp -- TeX-owe kodowanie dla j/ezyka czeskiego,
164 zgodne kodowaniem cmcsc10
165 e-cssc.mp -- TeX-owe kodowanie dla j/ezyka czeskiego,
166 zawieraj/ace kapitaliki (*.sc glyps; fonty TeX Gyre)
167 e-cstt.mp -- TeX-owe kodowanie dla j/ezyka czeskiego,
168 zgodne kodowaniem cmtt10
169 e-csttsc.mp -- TeX-owe kodowanie dla j/ezyka czeskiego,
170 zgodne kodowaniem cmtcsc10
171 e-ec.mp -- TeX-owe kodowanie EC (Cork; T1 w /zargonie LaTeX-owym)
172 e-ecsc.mp -- TeX-owe kodowanie EC (Cork; T1 w /zargonie LaTeX-owym)
173 zawieraj/ace kapitaliki (*.sc glyps; fonty TeX Gyre)
174 e-l7x.mp -- TeX-owe kodowanie dla j/ezyka litewskiego
175 e-l7xsc.mp -- TeX-owe kodowanie dla j/ezyka litewskiego,
176 zawieraj/ace kapitaliki (*.sc glyps; fonty TeX Gyre)
177 e-qx.mp -- TeX-owe kodowanie dla j/ezyka polskiego
178 e-qxcsc.mp -- TeX-owe kodowanie dla j/ezyka polskiego
179 zgodne kodowaniem cmcsc10
180 e-qxsc.mp -- TeX-owe kodowanie dla j/ezyka polskiego
181 zawieraj/ace kapitaliki (*.sc glyps; fonty TeX Gyre)
182 e-qxtt.mp -- TeX-owe kodowanie dla j/ezyka polskiego
183 zgodne kodowaniem cmtt10
184 e-qxttsc.mp -- TeX-owe kodowanie dla j/ezyka polskiego
185 zgodne kodowaniem cmtcsc10
186 e-qxwin.mp -- windowsowne kodowanie dla j/ezyka polskiego
187 e-rm.mp -- TeX-owe kodowanie RM (,,roman math'')
188 e-rmcsc.mp -- TeX-owe kodowanie RM (,,roman math'')
189 zgodne kodowaniem cmcsc10
190 e-rmsc.mp -- TeX-owe kodowanie RM (,,roman math'')
191 zawieraj/ace kapitaliki (*.sc glyps; fonty TeX Gyre)
192 e-rmtt.mp -- TeX-owe kodowanie RM (,,roman math'')
193 zgodne kodowaniem cmtt10
194 e-rmttsc.mp -- TeX-owe kodowanie RM (,,roman math'')
195 zgodne kodowaniem cmtcsc10
196 e-t2a.mp, e-t2b.mp, e-t2c.mp -- kodowania cyryliczne
197 zawieraj/ace kapitaliki (*.sc glyps; fonty TeX Gyre)
198 e-t5.mp -- TeX-owe kodowanie dla j/ezyka wietnamskiego
199 (T5 w /zargonie LaTeX-owym) zawieraj/ace kapitaliki
200 (*.sc glyps; fonty TeX Gyre)
201 e-t5sc.mp -- TeX-owe kodowanie dla j/ezyka wietnamskiego
202 (T5 w /zargonie LaTeX-owym)
203 e-ts1.mp -- TeX-owe kodowanie ,,Text companion'' (TS1 w /zargonie
204 LaTeX-owym)
205 e-yy.mp -- TeX-owe kodowanie Y&Y (zwane te/z LY1 lub TeX'n'ANSI)
206 e-yysc.mp -- TeX-owe kodowanie Y&Y (zwane te/z LY1 lub TeX'n'ANSI)
207 zawieraj/ace kapitaliki (*.sc glyps; fonty TeX Gyre)
208 packsubr.awk -- skrypt AWK-owy u/zywany do znajdowania w foncie
209 powtarzaj/acych si/e fragment/ow kodu postscriptowego
210 i zast/epowania ich odwo/laniami do procedur
211 afm2pfm.bat -- plik wsadowy uruchamiaj/acy skrypt do generowania
212 plik/ow PFM (Printer Font Metrics) na podstawie danych
213 metrycznych zawartych w pliku AFM (Adobe font metric)
214 afm2pfm.pl -- skrypt w Perlu, realizuj/acy proces opisany powy/zej
215 mkproof.bat -- plik wsadowy uruchamiaj/acy program mft (formater plik/ow
216 METAFONT-owych i METAPOST-owych); spos/ob wywo/lania tego
217 pliku zosta/l opisany w komentarzach na jego pocz/atku
218 mt1form.mft -- dane steruj/ace formatowaniem, wymagane przez program mft
219 mt1form.sty -- makra TeX-owe (plain), u/zywane do formatowania
220 dokumentacji
221 README -- niniejszy plik
222
223 Dodatkowo w zestawie znajduje si/e pakiet pf2mt1, umo/zliwiaj/acy
224 przekszta/lcenie fontu PostScript-owego w formacie Type1 na posta/c
225 METAPOST-ow/a zgodn/a z konwencjami METATYPE1. W trakcie konwersji
226 praktycznie wszystkie parametry fontu /xr/od/lowego s/a zachowywane,
227 co umo/zliwia (w normalnych warunkach) odtworzenie niemal/ze bez zmian
228 fontu wynikowego). W sk/lad tego pakietu wchodz/a:
229 pf2mt1.bat -- plik wsadowy uruchamiaj/acy proces konwersji fontu
230 do postaci METATYPE1; jego parametrem jest nazwa
231 fontu bez rozszerzenia (font musi sk/lada/c si/e
232 z pliku PFB oraz AFM)
233 pf2mt1.awk -- podstawowy skrypt AWK-owy, dokonuj/acy konwersji
234 pf2mt1.exc -- przyk/ladowy plik zawieraj/acy definincj/e ,,znak/ow
235 wyj/atkowych'', tzn. b/ad/x nie podlegaj/acych konwersji,
236 b/ad/x przenazwowywanych w trakcie konwersji.
237 Pakiet pf2mt1 mo/ze by/c przydatny dla pocz/atkuj/acych u/zytkownik/ow
238 METATYPE1. Fonty wygenerowane przez pf2mt1 stanowi/a dobry przyk/lad
239 u/zycia pakietu METATYPE1, cho/c oczywi/scie nie wykorzystuj/a jego
240 wszystkich mo/zliwo/si (np. parametryzacji).
241
242 Do dzia/lania pakietu METATYPE1 niezb/edne s/a nast/epuj/ace
243 zewn/etrzne programy (w nawiasach numery wersji kt/orych u/zywamy):
244 Metapost (0.641/Web2c 7.5.2)
245 Gawk (3.1.3)
246 t1utils (t1asm and t1disasm, 1.28)
247 U/zywane s/a r/ownie/z:
248 Perl (5.8.0) -- do generowania PFM-/ow (afm2pfm.bat)
249 MFT (Web2C 7.5.2, 2.0) -- do formatowania dokumentacji (mkproof.bat)
250 EPSINCL (0.43) -- do ewentualnego do/l/aczania EPS-/ow podk/ladowych
251 (stencils) do tworzonej dokumentacji; pakiet
252 ten znajduje si/e w katalogu ,,extra''
253
254 Instalacja sprowadza si/e do skopiowania plik/ow wsadowych do katalogu
255 znajduj/acego si/e w /sciezce przeszukiwania (PATH), umieszczenia
256 pozosta/lych plik/ow w ustalonej przez u/zytkownika kartotece
257 oraz uaktalnienia w pliku mt1set.bat ustawienia zmiennej
258 systemowej METATYPE1 -- zmienna powinna wskazywa/c t/e kartotek/e.
259
260 W katalogu ,,samples'' znajduj/a si/e przyk/lady u/zycia pakietu METATYPE1;
261 mo/zna je traktowa/c jako dodatkow/a dokumentacj/e.
262
263 Polecamy zapoznanie si/e z wersj/a METATYPE1 fontu LOGO zawart/a w pliku
264 logomp03.zip -- podobnie jak pakiet ,,pf2mt1'' mo/ze okaza/c si/e
265 przydatny podczas pierwszych pr/ob tworzenia font/ow.
266