From d00ddb89fdef9b9abff54425d15fdebd9f4826af Mon Sep 17 00:00:00 2001 From: Kartik Mistry Date: Fri, 4 May 2018 16:36:04 +0530 Subject: [PATCH] Documentation: Update sfntly URL and formatting Change-Id: I1c821d7e20c7428f34495aed32f6cc091fd0109b --- data/fontrepo/fonts/README | 27 +++++++++++++++------------ 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/data/fontrepo/fonts/README b/data/fontrepo/fonts/README index 8fea6d15..8fdbee59 100644 --- a/data/fontrepo/fonts/README +++ b/data/fontrepo/fonts/README @@ -1,9 +1,10 @@ -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. +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. +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 --------- @@ -35,14 +36,16 @@ 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. +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/googlei18n/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. +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.