diff --git a/README.md b/README.md index 1e22e2de7..4f74d4837 100644 --- a/README.md +++ b/README.md @@ -108,7 +108,7 @@ Include one of the following in the <head> section of your HTML file: pre, code { font-family: Hack, monospace; } ``` -See the [WEBFONT_USAGE.md](docs/WEBFONT_USAGE.md) documentation for additional details and instructions on web font use. +See the [WEBFONT_USAGE.md](docs/WEBFONT_USAGE.md) documentation for additional details, including instructions on how to download, host, and serve the web fonts on your own web server. ## Additional tools for Hack font customization diff --git a/docs/WEBFONT_USAGE.md b/docs/WEBFONT_USAGE.md index a2df90145..7f6b5fe31 100644 --- a/docs/WEBFONT_USAGE.md +++ b/docs/WEBFONT_USAGE.md @@ -1,123 +1,63 @@ ### Web Font Usage -Hack webfonts are released in eot, ttf, woff, and woff2 formats. They include a complete Hack character set build and a smaller [basic Latin](http://www.unicode.org/charts/PDF/U0000.pdf) + [Latin-1 supplement](http://www.unicode.org/charts/PDF/U0080.pdf) Unicode character block build. The latter build set is smaller in size and is intended to improve page loading times when you do not need the entire Hack character set. +Hack web fonts are released in woff and woff2 formats. They include a complete Hack character set build and a subset build that includes ASCII, Latin-1, Latin Extended A, General Punctuation, and Currency Unicode character set support. The latter build set is smaller in size and is intended to improve page loading times when you do not need the entire Hack character set. -You can view the rendering of the web fonts at a range of sizes on the [Hack type specimen](http://chrissimpkins.github.io/Hack/font-specimen.html). +You can view the rendering of the web fonts at a range of sizes on the [Hack web font type specimen](http://source-foundry.github.io/Hack/font-specimen.html). #### Hack by CDN -Thanks to the generous gang at [jsDelivr](https://github.com/jsdelivr/jsdelivr), you can use a CDN to include Hack on your site with a single stylesheet link in the head of your HTML files. There is no need to download font files from the repository or serve them from your web server. - -Average latency, average uptime, and total downtime data for jsDelivr vs. other popular CDN are available for [http](http://www.cdnperf.com/#jsdelivr,cdnjs,google,yandex,microsoft,jquery,bootstrapcdn/http/30) and [https](http://www.cdnperf.com/#jsdelivr,cdnjs,google,yandex,microsoft,jquery,bootstrapcdn/https/30) protocols. - -Include **one** of the following lines in the `` section of your site's HTML: - -##### Basic Latin + Latin-1 Supplement Character Set - -```html - -``` - -##### Full Character Set - -```html - -``` - -Then style your text by including `Hack` in the appropriate `font-family` property of your CSS. For example: - -```css -pre, code { - font-family: Hack, monospace; -} -``` - -**Bold** and _italic_ styles are included by default and work out-of-the-box via the `` and `` tags. +Thanks to the generous gang at [jsDelivr](https://github.com/jsdelivr/jsdelivr), you can use a CDN to include Hack on your site with a single stylesheet link in the head of your HTML files. There is no need to download font files from the repository or serve them from your web server. Instructions for web font CDN use are available on our README page. #### Host Hack Font Files on Your Server -Download the entire web font archive at this link: +The following instructions are for those who prefer not to use the web font CDN approach described above. If you would like to host the web fonts and CSS files yourself, please follow the instructions below. -- [Download Web Font Archive (all)](https://github.com/chrissimpkins/Hack/releases/download/v2.020/Hack-v2_020-webfonts.zip) +Download the [latest release of the Hack web fonts and associated CSS files](https://github.com/source-foundry/Hack/releases/latest). -Or select the fonts that you need in subdirectories of the build directory: - -- [Download .eot fonts](https://github.com/chrissimpkins/Hack/tree/master/build/webfonts/fonts/eot) -- [Download .ttf fonts](https://github.com/chrissimpkins/Hack/tree/master/build/webfonts/fonts/web-ttf) - **Note**: these differ from the desktop versions and are intended for web use -- [Download .woff fonts](https://github.com/chrissimpkins/Hack/tree/master/build/webfonts/fonts/woff) -- [Download .woff2 fonts](https://github.com/chrissimpkins/Hack/tree/master/build/webfonts/fonts/woff2) - -The web font archive download is structured like this: +The web font archive path structure is as follows: ``` -. -├── css -│   ├── hack-extended.css -│   ├── hack-extended.min.css -│   ├── hack.css -│   └── hack.min.css -└── fonts - ├── eot - │   ├── hack-bold-webfont.eot - │   ├── hack-bolditalic-webfont.eot - │   ├── hack-regular-webfont.eot - │   ├── hack-italic-webfont.eot - │   └── latin - │   ├── hack-bold-latin-webfont.eot - │   ├── hack-bolditalic-latin-webfont.eot - │   ├── hack-regular-latin-webfont.eot - │   └── hack-italic-latin-webfont.eot - ├── ttf - │   ├── hack-bold-webfont.ttf - │   ├── hack-bolditalic-webfont.ttf - │   ├── hack-regular-webfont.ttf - │   ├── hack-italic-webfont.ttf - │   └── latin - │   ├── hack-bold-latin-webfont.ttf - │   ├── hack-bolditalic-latin-webfont.ttf - │   ├── hack-regular-latin-webfont.ttf - │   └── hack-italic-latin-webfont.ttf - ├── woff - │   ├── hack-bold-webfont.woff - │   ├── hack-bolditalic-webfont.woff - │   ├── hack-regular-webfont.woff - │   ├── hack-italic-webfont.woff - │   └── latin - │   ├── hack-bold-latin-webfont.woff - │   ├── hack-bolditalic-latin-webfont.woff - │   ├── hack-regular-latin-webfont.woff - │   └── hack-italic-latin-webfont.woff - └── woff2 - ├── hack-bold-webfont.woff2 - ├── hack-bolditalic-webfont.woff2 - ├── hack-regular-webfont.woff2 - ├── hack-italic-webfont.woff2 - └── latin - ├── hack-bold-latin-webfont.woff2 - ├── hack-bolditalic-latin-webfont.woff2 - ├── hack-regular-latin-webfont.woff2 - └── hack-italic-latin-webfont.woff2 + web + ├── fonts + │   ├── hack-bold-subset.woff + │   ├── hack-bold-subset.woff2 + │   ├── hack-bold.woff + │   ├── hack-bold.woff2 + │   ├── hack-bolditalic-subset.woff + │   ├── hack-bolditalic-subset.woff2 + │   ├── hack-bolditalic.woff + │   ├── hack-bolditalic.woff2 + │   ├── hack-italic-subset.woff + │   ├── hack-italic-subset.woff2 + │   ├── hack-italic.woff + │   ├── hack-italic.woff2 + │   ├── hack-regular-subset.woff + │   ├── hack-regular-subset.woff2 + │   ├── hack-regular.woff + │   └── hack-regular.woff2 + ├── hack-subset.css + └── hack.css ``` -Push the `css` and `fonts` directories to your web server, then import **one** of the included CSS files in the `head` section of the HTML where you would like to use it. +Push one of the CSS files and the `fonts` directory to your web server, then import the CSS file in the `head` section of the HTML where you would like to use it. Replace `path/to/` with the actual path to your css directory. -##### Basic Latin + Latin-1 Supplement Character Set +##### Subset web font import ```html - + ``` -##### Full Character Set +##### Full character set import ```html - + ``` -You can alter the path to the Hack files (e.g. place the files in a `hack` resource subdirectory); however, please make sure that you preserve the relative file paths included in the release archive (*or be prepared to modify the paths to the font files*). +You can alter the path to the Hack files (e.g. place the files in a `hack` resource subdirectory); however, please make sure that you preserve the relative file paths included in the release archive (*or modify the paths to the font files included in the CSS files*). Then style your text by including `Hack` in the appropriate `font-family` property of your CSS. For example: @@ -129,17 +69,3 @@ code { The **bold**, *oblique*, and bold oblique text styles are formatted with HTML using `text block`, `text block`, and `text block` HTML tags, respectively. - -##### Webfont Caching and gzip Compression with Cloudflare - -*The following information applies to both paid and free accounts* - -If you use [Cloudflare](https://cloudflare.com), woff files are cached by default. To cache the remaining webfont files, add a new page rule for the path to your fonts directory: - -``` -yoursite.com/path/to/fonts/ -``` - - and set the rule to `Cache Everything`. - - Cloudflare automates gzip compression of ttf, eot, woff, and svg font files. The service does not gzip compress woff2 files.