mirror of
https://github.com/google/fonts.git
synced 2024-11-28 11:00:21 +03:00
76 lines
4.7 KiB
Markdown
76 lines
4.7 KiB
Markdown
[](https://github.com/google/fonts/actions/workflows/ci.yml?query=workflow%3ATest+branch%3Amain)
|
||
|
||
|
||
# Google Fonts Files
|
||
|
||
This project mainly contains the binary font files served by Google Fonts ([fonts.google.com](https://fonts.google.com))
|
||
|
||
The top-level directories indicate the license of all files found within them.
|
||
Subdirectories are named according to the family name of the fonts within.
|
||
|
||
Each family subdirectory contains the `.ttf` font files served by Google Fonts, plus a `METADATA.pb` file with metadata for the family (such as information on the project designer(s), genre category, and license - [learn more](https://github.com/googlefonts/gf-docs/tree/master/METADATA)) and a `DESCRIPTION.en_us.html` with a description of the family in US English.
|
||
|
||
The `/catalog` subdirectory contains additional metadata, such as profile texts and portrait/avatar images of font designers, and this is open for contributions and corrections from anyone via Github.
|
||
|
||
The `/axisregistry` subtree contains metadata for the GF Axis Registry, containing information on variable font axes that can be found in the collection, including experimental axes.
|
||
As a subtree, no changes should be made directly to this repo, instead please use the upstream, [github.com/googlefonts/axisregistry](http://github.com/googlefonts/axisregistry)
|
||
|
||
The `/lang` subtree contains language support data, and should also not be changed here but instead upstream.
|
||
[github.com/googlefonts/lang](https://github.com/googlefonts/lang)
|
||
|
||
## Bug Reports and Improvement Requests
|
||
|
||
If you find a problem with a font file or have a request for the future development of a font project, please [create a new issue in this project's issue tracker](https://github.com/google/fonts/issues).
|
||
|
||
## Contribute Fonts
|
||
|
||
If you need more context on how to create issues in a GitHub issue tracker, or if you want to contribute a font directly, see [CONTRIBUTING](https://github.com/google/fonts/blob/main/CONTRIBUTING.md)
|
||
|
||
## Contributor Code of Conduct
|
||
|
||
However you choose to contribute, please abide by our [code of conduct](CODE_OF_CONDUCT.md) to keep our community a healthy and welcoming place.
|
||
|
||
## Self Host Fonts Available From Google Fonts
|
||
|
||
Since all the fonts available here are licensed with permission to redistribute, subject to the license terms, you can self-host using a variety of third-party projects.
|
||
|
||
One popular service is [Fontsource](https://github.com/fontsource/fontsource), which offers bundled NPM packages.
|
||
|
||
## Local installation package managers
|
||
|
||
For Linux, macOS, FreeBSD, or HaikuOS you can also use [fnt](https://github.com/alexmyczko/fnt), to install single fonts. For [RPM](http://bootes.ethz.ch/fonts/rpm/), [DEB](http://bootes.ethz.ch/fonts/deb/) based systems, feel free to try the linked URLs for individual fonts. Others can also use the [webservice](http://bootes.ethz.ch/fonts/).
|
||
|
||
## Download All Google Fonts
|
||
|
||
You can download all Google Fonts in a simple ZIP snapshot (over 1GB) from <https://github.com/google/fonts/archive/main.zip>
|
||
|
||
#### Sync With Git
|
||
|
||
You can also sync the collection with git so that you can update by only fetching what has changed. To learn how to use git, Github provides [illustrated guides](https://guides.github.com) and a [youtube channel](https://www.youtube.com/user/GitHubGuides), and an [interactive learning lab](https://lab.github.com).
|
||
Free, open-source git applications are available for [Windows](https://git-scm.com/download/gui/windows) and [Mac OS X](https://git-scm.com/download/gui/mac).
|
||
|
||
## License
|
||
|
||
It is important to always read the license for every font that you use.
|
||
Each font family directory contains the appropriate license file for the fonts in that directory.
|
||
The fonts files themselves also contain licensing and authorship metadata.
|
||
|
||
Most of the fonts in the collection use the SIL Open Font License, v1.1.
|
||
Some fonts use the Apache 2 license.
|
||
The Ubuntu fonts use the Ubuntu Font License v1.0.
|
||
|
||
The SIL Open Font License has an option for copyright holders to include a Reserved Font Name requirement, and this option is used with some of the fonts.
|
||
If you modify those fonts, please take care of this important detail.
|
||
|
||
## Source Files
|
||
|
||
Source files for each family are often available from the designer, or from [github.com/googlefonts](https://github.com/googlefonts)
|
||
|
||
These fonts are usually the result of collaborative projects, where you are invited to discuss issues with the designers and even contribute to their ongoing development.
|
||
|
||
When customizing or remixing fonts, please do contact the designers to understand what they might need in order to include your improvements.
|
||
|
||
Most of all: Enjoy the fonts!
|
||
|
||
– The Google Fonts team
|