The assembly of character sets is currently undergoing a transition from the previous approach of using the glyphsets
command and data.json
as a database to using the gflanguages
package as the database and assembling .nam
and other files from that.
Note
Please see GLYPHSETS.md for an up-to-date description of the state of the new language definitions.
- Define the glyphset in the Python module in
Lib/glyphsets/definitions/__init__.py
with language codes for your character set. - Optional: Have a
.stub.nam
file underGF_Glyphsets/*/definitions/
for your character set, containing encoded characters that you want to see included that can't be inferred from thegflanguages
definitions. - Optional: Have a
.stub.glyphs
file underGF_Glyphsets/*/definitions/
for your character set, containing unencoded glyphs that you want to see included. - Update all glyphsets using
sh build.sh
, see below for details.
The final .glyphs
files are the sum of gflanguages
+ .stub.nam
+ .stub.glyphs
. See chart below.
Note
glyphsets uses the version of gflanguages that's currently installed on your system to query for characters per language. This enables you working on both packages locally at once. In any case, make sure that the gflanguages package is up-to-date on your system.
Note
Bonus points: Sadly, in the creation of the .glyphs
files, it's not possible to exactly recreate the glyph sorting that Glyphs.app uses by default, so the .glyphs
files look a bit different from what's expected. If you care, please open every freshly adjusted .glyphs
file in Glyphs.app, select all glyphs, and run "Update Glyph Info" from the "Glyphs" menu on them to sort them and save the file. But the files will work as-is in any case.
Visualizes in a simplified way how the various data sources are combined into a final glyphset, then rendered out to various format.
This process is repeated for every glyphset defined in Lib/glyphsets/definitions/__init__.py
.
Read this top to bottom.
┌──────────────────┐
│ Language codes │
│ "en_Latn" │
│ "de_Latn" │
│ ... │
└──────────────────┘
│
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ gflanguages │ │ .stub.nam │ │ .stub.glyphs │
│ (Python package) │ │ (optional) │ │ (optional) │
└──────────────────┘ └──────────────────┘ └──────────────────┘
│ │ │
╰──────────────────────┼──────────────────────╯
│
╔═══════════════════════════════╗
║ complete glyphset ║
╚═══════════════════════════════╝
│
╭──────────────────────┼──────────────────────┬──────────────────────╮
│ │ │ │
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│ .txt │ │ .nam │ │ .glyphs │ │ .plist │
│ (nice & prod) │ │ │ │ │ │ │
└──────────────────┘ └──────────────────┘ └──────────────────┘ └──────────────────┘