Skip to content

Generate rich Unicode open fonts with custom annotations, transliterations, pronunciations.

Notifications You must be signed in to change notification settings

parlr/ruby-font-creator

Repository files navigation

Build Status Code Climate

Ruby Font Creator

Font creator to help students learn and read foreign languages faster by appending pronunciation or meaning to each glyph.

Features

languages preview state repository base-font
Chinese top ✔️ hanzi-pinyin-font DroidSansFallbackFull
Tifinagh - 🏃‍ hanzi-pinyin-font DroidSansFallbackFull
🗣️ request new one - - - Please provide an open-source font

Legend: 🏃‍✔️

Install

Requirements: nodejs, yarn or npm.

yarn install

Usage

Requirements: a JSON file describing codepoint-glyph-gloss tuple (e.g. src/data.json).

yarn build

Custom config:

yarn build --config ./src/config/default.js

Custom data:

yarn build --data ./path-to/data.json

Custom Font Name:

yarn build --font-name 'custom-font-name'

ℹ️ maintenance tasks available are in the [makefile][./makefile], run make to see possible actions.

Data Structure

A list of objects, each describing a glyph, with the following 3 elements:

  1. a unicode codepoint ;
  2. a base glyph ;
  3. a ruby text.

Example:

[
  {
    "codepoint": "U+03B1",
    "glyph": "α",
    "ruby": "alpha"
  }
]

Font

This project use fonts under open-source licenses : DejaVuSans, DroidSansFallbackFull, Noto Sans CJK.

License

Apache License 2.0

Contributors