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.
* `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
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:

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

@ -1,4 +1,4 @@
### See https://github.com/be5invis/Iosevka/blob/master/doc/custom-build.md for comprehensive
### See https://github.com/be5invis/Iosevka/blob/master/doc/custom-build.md for comprehensive
### documentation of the options in this file
[buildPlans.iosevka-custom] # <iosevka-custom> is your plan name
@ -53,17 +53,17 @@ enables = [] # Optional; enable specific ligation groups, overrid
# 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
# 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.
menu = 400 # Weight for the font's names.
css = 400 # Weight for webfont CSS.
[buildPlans.iosevka-custom.weights.book]
[buildPlans.iosevka-custom.weights.Book]
shape = 450
menu = 450 # Use 450 here to name the font's weight "Book"
css = 450
[buildPlans.iosevka-custom.weights.bold]
[buildPlans.iosevka-custom.weights.Bold]
shape = 700
menu = 700
css = 700
@ -75,19 +75,19 @@ css = 700
# Override default building slope sets
# 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]
shape = "upright" # Slope grade used for shape selection. `upright` | `oblique` | `italic`
menu = "upright" # Slope grade used for naming. `upright` | `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
shape = "oblique"
menu = "oblique"
css = "oblique"
[buildPlans.iosevka-custom.slopes.italic]
[buildPlans.iosevka-custom.slopes.Italic]
angle = 9.4
shape = "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,
# 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.
menu = 5 # Width grade for the font's names.
css = "normal" # "font-stretch' property of webfont CSS.
[buildPlans.iosevka-custom.widths.extended]
[buildPlans.iosevka-custom.widths.Extended]
shape = 600
menu = 7
css = "expanded"