Chiron Hei HK Webfont
======================

## About

This package contains the webfont version of [Chiron Hei HK (昭源黑體)](https://github.com/chiron-fonts/chiron-hei-hk).

Chiron Hei HK is a CJK typeface derived from the Source Han Sans / Noto Sans CJK font family. It aims to provide a
modern, region-agnostic glyph set adopting the “written” style that is similar to the prevailing, usually commercial,
typefaces such that it is suitable for use in a Traditional Chinese environment.

Chiron Hei HK is available in several configurations: OpenType/CFF (OTF), TrueType (TTF), OpenType/CFF2 (OTF) variable
font, TrueType variable font, and the webfont version in WOFF File Format 2.0 (WOFF2) variable font format.

This package provides the webfont (WOFF2) build of the font. It utilizes Unicode-range subsetting technology to reduce
download size and improve loading performance. Check out the
project's [Github repository](https://github.com/chiron-fonts/chiron-hei-hk) for a complete README, and the font
family's [website](https://chiron-fonts.github.io) for usage example (both in Chinese only).

## Usage

To use this webfont, install the package first:

```bash
npm install chiron-hei-hk-webfont 
```

Then, include the `css/vf.css` file in your web page. For instance, if you use [webpack](https://webpack.js.org/), you
would import the font's CSS file with the following statement:

```css
@import '~chiron-hei-hk-webfont/css/vf.css';
```

Finally, set the `font-family` property to `Chiron Hei HK WS`:

```css
body {
    font-family: "Chiron Hei HK WS", sans-serif;
}
```

You can use the `font-weight` CSS property to set the desired boldness. The following table shows the default static
font weights and their corresponding `font-weight` values. As a variable font, you may also specify any value between
250 and 900.

| Font Weight | CSS `font-weight` value |
|-------------|-------------------------|
| ExtraLight  | 250                     |
| Light       | 300                     |
| Normal      | 350                     |
| Regular     | 400                     |
| Medium      | 500                     |
| SemiBold    | 600                     |
| Bold        | 700                     |
| Heavy       | 900                     |

In addition, you can tweak the glyph space accommodation in the em-box via the font's "PADG" axis. For instance:

```css
p {
    font-variation-settings: "PADG" 6;
}
```

The PADG axis range is valid between 0 and 10. If unspecified, the default value is 0.”

## License

Chiron Hei HK is licensed under the SIL Open Font License, Version 1.1. The full text of the license is available
at [https://scripts.sil.org/OFL_web](https://scripts.sil.org/OFL_web).
