summaryrefslogtreecommitdiff
path: root/www/wiki/extensions/UniversalLanguageSelector/data/fontrepo/fonts/README
blob: 8fdbee596c7afa6ac47d20dc8e096ced0b828ac9 (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
This is font repository for Universal Language Selector. These fonts are used
by jquery.webfonts to deliver on demand or based on users preferences. There is
a script named "compile-font-repo.php" to generate the font repository in
JavaScript syntax. It reads this font.ini files.

Each folder contains a font.ini file, which is the description about the font.
The fields in the font.ini is described below. Use ';' to add any comments.

languages
---------
list of language(s) to use for font. * in language code suggests it is default
font for language.

version
-------
Font version.

license
-------
License in SPDX format. see licenses/README file for format and details.

licensefile
-----------
Name of license file from licenses folder.

request-url
-----------
URL of bug or request where font addition request was made. For more than 2
languages, use URLs separated by comma in,

request-url=url1, url2

url
---
Upstream location of font to download.

formats
-------
If there are style variants, font.ini should contain file names for each
variants(bold, italic etc). Otherwise, based on the extension of files, the
font compilation script can pick it up.

Preparing font formats
-----------------------

1. From the upstream releases, take the TTF versions.
2. To generate woff format, get: https://github.com/rillig/sfntly
3. Use https://github.com/google/woff2 to generate woff2 from ttf. This will
   produce a compressed woff2 file. Modern browsers support this format.
4. The eot file format is used only by older IE, but it can be generated using
   sfntly. Make sure to use -mtx flag to get enhanced compression.