mikeslab/Iosevka
1
0
Fork 0
Code Issues Pull requests Projects Releases 1 Packages Wiki Activity Actions 1

doc

Browse source
This commit is contained in:
be5invis 2023-11-12 00:49:27 -08:00
parent 560ffcb304
commit 2f0f0d0654
2 changed files with 9 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

2
doc/custom-build.md
View file

@ -512,8 +512,6 @@ Subsection `slopes` is used to change the slope angles and grades that the custo
* `menu`: String from `upright`, `italic` or `oblique`. Configures the slope grade used when naming fonts. * `menu`: String from `upright`, `italic` or `oblique`. Configures the slope grade used when naming fonts.
* `css`: String from `normal`, `italic` or `oblique`. Configures the [CSS font-style](https://developer.mozilla.org/zh-CN/docs/Web/CSS/font-style) value. * `css`: String from `normal`, `italic` or `oblique`. Configures the [CSS font-style](https://developer.mozilla.org/zh-CN/docs/Web/CSS/font-style) value.
Subsection `slopes` is a simple string-to-string dictionary maps slopes (`upright`, `italic` or `oblique`) to [CSS font-style](https://developer.mozilla.org/zh-CN/docs/Web/CSS/font-style) values, represented in string.
#### Compatibility Ligatures #### Compatibility Ligatures
Certain software, notably Emacs, relies on pre-encoded ligatures instead of OpenType to provide ligations. Iosevka could be configured with additional subsection `compatibility-ligatures`, being an array of records with following fields: Certain software, notably Emacs, relies on pre-encoded ligatures instead of OpenType to provide ligations. Iosevka could be configured with additional subsection `compatibility-ligatures`, being an array of records with following fields:

16
private-build-plans.sample.toml
View file

@ -53,17 +53,17 @@ enables = [] # Optional; enable specific ligation groups, overrid
# and "shape" properly only supports number between 100 and 900 (inclusive). # and "shape" properly only supports number between 100 and 900 (inclusive).
# If you decide to use custom weights you have to define all the weights you # If you decide to use custom weights you have to define all the weights you
# plan to use otherwise they will not be built. # plan to use otherwise they will not be built.
[buildPlans.iosevka-custom.weights.regular] [buildPlans.iosevka-custom.weights.Regular]
shape = 400 # Weight for glyph shapes. shape = 400 # Weight for glyph shapes.
menu = 400 # Weight for the font's names. menu = 400 # Weight for the font's names.
css = 400 # Weight for webfont CSS. css = 400 # Weight for webfont CSS.
[buildPlans.iosevka-custom.weights.book] [buildPlans.iosevka-custom.weights.Book]
shape = 450 shape = 450
menu = 450 # Use 450 here to name the font's weight "Book" menu = 450 # Use 450 here to name the font's weight "Book"
css = 450 css = 450
[buildPlans.iosevka-custom.weights.bold] [buildPlans.iosevka-custom.weights.Bold]
shape = 700 shape = 700
menu = 700 menu = 700
css = 700 css = 700
@ -75,19 +75,19 @@ css = 700
# Override default building slope sets # Override default building slope sets
# When this section is absent, all slopes would be built. # When this section is absent, all slopes would be built.
[buildPlans.iosevka-custom.slopes.upright] [buildPlans.iosevka-custom.slopes.Upright]
angle = 0 # Angle in degrees. Valid range [0, 15] angle = 0 # Angle in degrees. Valid range [0, 15]
shape = "upright" # Slope grade used for shape selection. `upright` | `oblique` | `italic` shape = "upright" # Slope grade used for shape selection. `upright` | `oblique` | `italic`
menu = "upright" # Slope grade used for naming. `upright` | `oblique` | `italic` menu = "upright" # Slope grade used for naming. `upright` | `oblique` | `italic`
css = "normal" # Slope grade used for webfont CSS. `normal` | `oblique` | `italic` css = "normal" # Slope grade used for webfont CSS. `normal` | `oblique` | `italic`
[buildPlans.iosevka-custom.slopes.oblique] [buildPlans.iosevka-custom.slopes.Oblique]
angle = 9.4 angle = 9.4
shape = "oblique" shape = "oblique"
menu = "oblique" menu = "oblique"
css = "oblique" css = "oblique"
[buildPlans.iosevka-custom.slopes.italic] [buildPlans.iosevka-custom.slopes.Italic]
angle = 9.4 angle = 9.4
shape = "italic" shape = "italic"
menu = "italic" menu = "italic"
@ -106,12 +106,12 @@ css = "italic"
# If you decide to use custom widths you have to define all the widths you plan to use, # If you decide to use custom widths you have to define all the widths you plan to use,
# otherwise they will not be built. # otherwise they will not be built.
[buildPlans.iosevka-custom.widths.normal] [buildPlans.iosevka-custom.widths.Normal]
shape = 500 # Unit Width, measured in 1/1000 em. shape = 500 # Unit Width, measured in 1/1000 em.
menu = 5 # Width grade for the font's names. menu = 5 # Width grade for the font's names.
css = "normal" # "font-stretch' property of webfont CSS. css = "normal" # "font-stretch' property of webfont CSS.
[buildPlans.iosevka-custom.widths.extended] [buildPlans.iosevka-custom.widths.Extended]
shape = 600 shape = 600
menu = 7 menu = 7
css = "expanded" css = "expanded"