-
New repositories. Hit the green button above ("Use this template") to create your own repository.
Make sure to click the checkbox marked "Include all branches". -
Updating a repository. To update your font repository to bring in the latest best-practices from our Unified Font Repository, run
make update-ufr
from the command line. -
Replace the font sources in the
sources
directory with your own fonts. These sources may be either in Glyphs format or UFO/Designspace formats.
Unlike many open source distributors, Google Fonts is a curated content. Fonts shipped to the platform have to match the Google Fonts Specifications. Please read them carefully.
(The sample font provided in this template is Rubik by Philipp Hubert, Sebastian Fischer, and contributors.) -
Then reference the sources in the file
sources/config.yaml
, as well as making any other changes you would like to make based on the instructions in the Google Font Builder documentation. -
Add yourself to the
AUTHORS.txt
andCONTRIBUTORS.txt
files. -
Update the first line of the OFL.txt (year and project name). Update also the Copyright string in the sources, it has to be the same as the OFL.txt. The
.glyphs
file in this repo gives you required base charset and font info. -
Finally, add and commit any files you have modified (i.e.
README.md
,AUTHORS.txt
,CONTRIBUTORS.txt
, the font sources, andsources/config.yaml
) to git, then push to GitHub. -
Once you are happy with your font, add promotional assets in the documentation directory. Make it different from the pic you use in this README. You can get inspired by existing tweet @googlefonts like: https://twitter.com/googlefonts/status/1415562928657416192.
-
Remove this section from the readme. :-)
Description of your font goes here. We recommend to start with a very short presentation line (the kind you would use on twitter to present your project for example), and then add as much details as necesary :-) Origin of the project, idea of usage, concept of creation… but also number of masters, axes, character sets, etc.
Don't hesitate to create images!
Description of you and/or organisation goes here.
Fonts are built automatically by GitHub Actions - take a look in the "Actions" tab for the latest build.
If you want to build fonts manually on your own computer:
make build
will produce font files.make test
will run FontBakery's quality assurance tests.make proof
will generate HTML proof files.
The proof files and QA tests are also available automatically via GitHub Actions - look at https://yourname.github.io/your-font-repository-name
.
When you update your font (new version or new release), please report all notable changes here, with a date. Font Versioning is based on semver. Changelog example:
26 May 2021. Version 2.13
- MAJOR Font turned to a variable font.
- SIGNIFICANT New Stylistic sets added.
This Font Software is licensed under the SIL Open Font License, Version 1.1. This license is copied below, and is also available with a FAQ at https://scripts.sil.org/OFL
This font repository structure is inspired by Unified Font Repository v0.3, modified for the Google Fonts workflow.