Git Product home page Git Product logo

iosevka's Introduction

Iosevka Version Patreon Donate

Coders’ typeface, built from code.

Installation

Quit your editor/program. Unzip and open the folder.

  • Instructions for Windows
  • Instructions for macOS
    • Standard distribution in Homebrew: brew tap caskroom/fonts && brew cask install font-iosevka (May be outdated).
    • Customizable install using Homebrew: see robertgzr/homebrew-tap.
  • Linux : Copy the TTF files to your fonts directory → Run sudo fc-cache.
    • Arch Linux users can install the font from the AUR here using an AUR wrapper or by doing it manually. All variants.
    • Void Linux users can install the font with xbps-install font-iosevka.

Weights, Variants and OpenType features

The typeface contains 9 weights (Thin to Heavy) alongside with both italic and oblique versions, with the same metrics as the regular one.

Weights sample

All versions include the same ranges of characters: Latin letters, Greek letters (including Polytonic), some Cyrillic letters, IPA symbols and common punctuations and some symbols. You can check out the full list here.

Languages Sample

Iosevka supports accessing all letter variants using OpenType features.

Style Sets

Character Variants

Ligations

Ligations Sample

Iosevka’s default ligation set is assigned to calt feature, though not all of them are enabled by default.

Iosevka supports Language-Specific Ligations, which is the ligation set enabled only under certain languages. These ligation sets are assigned to custom feature tags, like XHS0.

Building from Source

To build Iosevka you should:

  1. Ensure that nodejs (≥ 8.4), ttfautohint, otfcc (≥ 0.9.3).
  2. Install necessary libs by npm install. If you’ve installed them, upgrade to the latest.
  3. npm run build -- contents:iosevka.

You will find TTFs, as well as WOFF(2) web fonts and one Webfont CSS in the dist/ directory.

Build Your Own Style

Since version 2.0, Iosevka would no longer support building via makefile. To initialize a custom build, you need:

  1. Create private-build-plans.toml file.

  2. Add a build plan into private-build-plans.toml, following this format:

    [buildPlans.iosevka-custom]            # <iosevka-custom> is your plan name
    family = "Iosevka Custom"              # Font menu family name
    design = ["common styles"]             # Common styles
    upright = ["upright-only", "styles"]   # Upright-only styles
    italic = ["italic-only", "styles"]     # Italic-only styles
    oblique = ["oblique-only", "styles"]   # Oblique-only styles
    
    # Override default building weights
    # When buildPlans.<plan name>.weights is absent
    # All weights would built and mapped to default shape/CSS
    [buildPlans.iosevka-custom.weights.regular]
    shape = 400                            # Weight for glyph shapes
    menu  = 400                            # Weight for menu name
    css   = 400                            # Weight for WebFont CSS
    
    [buildPlans.iosevka-custom.weights.bold]
    shape = 700
    menu  = 700
    css   = 700
    
    # Override default building slant sets
    # Format: <upright|italic|oblique> = <"normal"|"italic"|"oblique">
    # When this section is absent, all slants would be built.
    [buildPlans.iosevka-custom.slants]
    upright = "normal"
    italic = "italic"
    oblique = "oblique"
  3. Run npm run build -- contents:<your plan name> and the built fonts would be avaliable in dist/. Aside from contents:<plan>, other options are:

    1. contents:<plan> : TTF (Hinted and Unhinted), WOFF(2) and Webfont CSS;
    2. ttf:<plan> : TTF;
    3. ttf-unhinted:<plan> : Unhinted TTF only;
    4. woff:<plan> : TTF and WOFF only;
    5. woff2:<plan> : TTF and WOFF2 only;

The current available styles for design/upright/italic/oblique options are:

  • Styles for general shape:
    • sans : Sans serif (default).
    • slab : Slab serif.
  • Styles related to ligations and spacing:
    • term : Disable ligations and exact monospace.
      • The font built will not contain ligatures.
      • All glyphs wider than one letter would be deleted.
      • In case of your OS or editor cannot handle ligatures correctly, you can disable ligations with it.
    • termlig : Similar to term, the font is exact monospace to make fontconfig happy, while ligations are still present.
    • nolig : Disable ligation only.
    • type : Make some symbols, like arrows () and mathematical operators full-width.
    • stress-fw : When included, full-width characters varying form U+FF00 to U+FFFF will be boxed to present a clear distinguish between ASCII and Full-width.
  • All registered ss## and cv## feature tags, including:
    • ss01~ss10 : Predefined stylistic sets based on other Monospace fonts.
    • cv01~cv53 : Standalone character variants.
  • Styles for ligation sets, include:
    • ligset-haskell: Default ligation set would be assigned to Haskell.
    • ligset-idris: Default ligation set would be assigned to Idris.
    • ligset-coq: Default ligation set would be assigned to Coq.
    • ligset-elm: Default ligation set would be assigned to Elm.
    • ligset-ml: Default ligation set would be assigned to ML.
    • ligset-fs: Default ligation set would be assigned to F#.
    • ligset-fstar: Default ligation set would be assigned to F*.
    • ligset-swift: Default ligation set would be assigned to Swift.
    • ligset-purescript: Default ligation set would be assigned to PureScript.
  • Styles for further customizing default (calt) ligation sets. When any of these styles present in your configuration, the ligset-* styles would be overridden.
    • calt-clear: Clear the calt ligation set.
    • calt-center-ops: Vertically align some of the operators (like *) to the center position it is before or after a "center" operator (like +);
    • calt-arrow: Enable ligation set that forms arrows;
    • calt-arrow2: Enable ligation for more arrows, like >>=;
    • calt-html-comment: Enable ligation for <!-- and <!---;
    • calt-eqeq: Enable ligation for == and ===;
    • calt-ineq: Enable ligation for <= and >=;
    • calt-arrowZALE: Enable ligation for <= to form a left double arrow;
    • calt-arrowZAGE: Enable ligation for >= to form a right inverse double arrow;
    • calt-exeq: Enable ligation for != and !==;
    • calt-slasheq: Enable ligation for /= and /==;
    • calt-plusplus: Enable ligation for ++ and further plus-chaining;
    • calt-llgg: Enable ligation for <<, >> and other angle-bracket chaining;
    • calt-trig: Enable ligation for <|, |> , <||, and other bar-and-angle-bracket symbols;
    • calt-dotoper: Treat dot (.) as operator and perform chained centering;
    • calt-brst: Center asterisk in (* and *);
    • calt-logic: Enable ligation for /\ and \/;
    • calt-colons: Enable ligation for :: and ::: ;
  • Styles for changing the line space (leading):
    • leading-750, leading-1000, leading-1250, leading-1500, leading-1750, leading-2000: Change the line space. Default is leading-1250.
  • Styles for changing Powerline symbols' position:
    • powerline-scale-y-750, powerline-scale-y-875, powerline-scale-y-1000, powerline-scale-y-1125, powerline-scale-y-1250, powerline-scale-y-1375, powerline-scale-y-1500: Resize the Powerline symbols vertically, from 75% to 150%.
    • powerline-scale-x-750, powerline-scale-x-875, powerline-scale-x-1000, powerline-scale-x-1125, powerline-scale-x-1250, powerline-scale-x-1375, powerline-scale-x-1500: Resize the Powerline symbols horizontally, from 75% to 150%.
    • powerline-shift-y-n500, powerline-shift-y-n450, powerline-shift-y-n400, powerline-shift-y-n350, powerline-shift-y-n300, powerline-shift-y-n250, powerline-shift-y-n200, powerline-shift-y-n150, powerline-shift-y-n100, powerline-shift-y-n50, powerline-shift-y-0, powerline-shift-y-p50, powerline-shift-y-p100, powerline-shift-y-p150, powerline-shift-y-p200, powerline-shift-y-p250, powerline-shift-y-p300, powerline-shift-y-p350, powerline-shift-y-p400, powerline-shift-y-p450, powerline-shift-y-p500: Shift the Powerline symbols vertically, from -0.5em to +0.5em.
    • powerline-shift-x-n500, powerline-shift-x-n450, powerline-shift-x-n400, powerline-shift-x-n350, powerline-shift-x-n300, powerline-shift-x-n250, powerline-shift-x-n200, powerline-shift-x-n150, powerline-shift-x-n100, powerline-shift-x-n50, powerline-shift-x-0, powerline-shift-x-p50, powerline-shift-x-p100, powerline-shift-x-p150, powerline-shift-x-p200, powerline-shift-x-p250, powerline-shift-x-p300, powerline-shift-x-p350, powerline-shift-x-p400, powerline-shift-x-p450, powerline-shift-x-p500: Shift the Powerline symbols horizontally, from -0.5em to +0.5em.
  • Styles for changing the width:
    • expanded: Expand the width by 10%;
    • compressed: Compress the width by 10%.
    • NOTE: these styles are highly experimental. Handle with extreme care.
  • Styles for individual characters. They are easy-to-understand names of the cv## styles, including:
    • Styles for letter l:
      • v-l-hooky : Hooky l.
      • v-l-zshaped : Z-shaped l.
      • v-l-serifed : Serifed l (default for upright and oblique).
      • v-l-italic : Italic l (default for italic).
      • v-l-tailed : l with a curved tail.
      • v-l-hookybottom : l with a straight tail.
    • Styles for letter i:
      • v-i-hooky : Hooky i.
      • v-i-zshaped : Z-shaped i.
      • v-i-serifed : Serifed i (default for upright and oblique).
      • v-i-italic : Italic i (default for italic).
    • Styles for letter a:
      • v-a-doublestorey : Double-storey a (default for upright and oblique).
      • v-a-singlestorey : Single-storey a (default for italic).
    • Styles for letter f:
      • v-f-straight: f without bottom hook (default for upright and oblique).
      • v-f-tailed: f with a leftward bottom hook (default for italic).
    • Styles for letter g:
      • v-g-doublestorey : Double-storey g (default for upright and oblique).
      • v-g-singlestorey : Single-storey g (default for italic).
      • v-g-opendoublestorey : Open Double-storey g.
    • Styles for letter m:
      • v-m-longleg : m with long middle leg (default).
      • v-m-shortleg : m with shorter middle leg.
    • Styles for letter t:
      • v-t-standard : Standard t shape (default).
      • v-t-cross : Futura-like t shape.
    • Styles for letter Q:
      • v-q-taily : Q with a curly tail (default).
      • v-q-straight : Q with a straight tail in the old versions.
    • Styles for letter y:
      • v-y-straight: More-straight letter y.
      • v-y-curly: Curly, cursive-like y.
    • Styles for zero (0):
      • v-zero-slashed : Slashed Zero 0 (default).
      • v-zero-dotted : Dotted Zero 0.
      • v-zero-unslashed : O-like 0.
    • Styles for one (1)
      • v-one-serifed : 1 with bottom serif (default for Slab).
      • v-one-hooky : 1 without bottom serif (default for Sans).
    • Styles for three (3):
      • v-three-flattop : Flat top 3 (Like Museo Sans / Montserrat).
      • v-three-twoarks : Arched top 3 (default).
    • Styles for ASCII tilde (~), asterisk (*), paragaraph(), underscore (_) and ASCII Caret (^):
      • v-tilde-high : Higher tilde ~.
      • v-tilde-low : Lower tilde ~ (default).
      • v-asterisk-high : Higher asterisk * (default).
      • v-asterisk-low : Lower asterisk *.
      • v-paragraph-high : Higher paragraph symbol (default).
      • v-paragraph-low : Lower paragraph symbol .
      • v-caret-high : Higher circumflex ^ (default).
      • v-caret-low : Lower circumflex ^.
      • v-underscore-high : Higher underscore _ (default).
      • v-underscore-low : Lower underscore _.
    • Styles for At (@):
      • v-at-long : The long, three-fold At symbol in Iosevka 1.7.x.
      • v-at-fourfold : The traditional, four-fold At symbol.
      • v-at-short : The shorter, Fira-like At symbol introduced in Iosevka 1.8.
    • Styles for Eszet (ß):
      • v-eszet-traditional : Tratidional, Fraktur-like Eszet.
      • v-eszet-sulzbacher : A more modern, beta-like Eszet (default).
    • Styles for curly brackets ({}):
      • v-brace-straight : More straight braces.
      • v-brace-curly : More curly braces (default).
    • Styles for dollar symbol ($):
      • v-dollar-open : Dollar symbol with open contour.
      • v-dollar-through : Dollar symbol with strike-through vertical bar (default).
      • v-dollar-opencap : Dollar symbol with open contour, not exceeding baseline and ascender.
      • v-dollar-throughcap : Dollar symbol with strike-through vertical bar, not exceeding baseline and ascender.
    • Styles for Number sign (#):
      • v-numbersign-upright : Number sign with vertical bars (default).
      • v-numbersign-slanted : Number sign with slanted bars.

For Chinese and Japanese users...

Sarasa Gothic.


Family Matrix

iosevka's People

Contributors

be5invis avatar mrkgnao avatar alexeyten avatar jnv avatar sprang avatar damieng avatar davelab6 avatar 4e6 avatar kigerpunk avatar iceman81 avatar leonbreedt avatar artoria2e5 avatar eiszfuchs avatar reli-msft avatar robertgzr avatar nomoon avatar

Watchers

Kent avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.