1
0
mirror of https://github.com/google/fonts.git synced 2024-12-16 20:52:41 +03:00
fonts/README.md
Eli Heuer ca57b8c502 Add a code of conduct
Contributor Covenant, version 2.0. As suggested in issue #3515
2021-08-05 08:33:36 -06:00

64 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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` subdirectory contains metadata for the GF Axis Registry, containing information on variable font axes that can be found in the collection, including experimental axes.
## 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).
## 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.
## Download All Google Fonts
You can download all Google Fonts in a simple ZIP snapshot (over 600MB) 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