1
0
mirror of https://github.com/google/fonts.git synced 2024-12-11 10:02:13 +03:00
fonts/README.md

64 lines
3.6 KiB
Markdown
Raw Normal View History

2015-03-09 00:19:41 +03:00
# Google Fonts Files
2015-03-07 02:44:52 +03:00
2019-08-28 22:27:10 +03:00
This project mainly contains the binary font files served by Google Fonts ([fonts.google.com](https://fonts.google.com))
2015-03-07 02:44:52 +03:00
2020-03-03 13:32:30 +03:00
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.
2015-03-07 02:44:52 +03:00
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.
2015-03-07 02:44:52 +03:00
2019-08-28 22:27:10 +03:00
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
2016-02-05 02:30:48 +03:00
2020-03-03 13:32:30 +03:00
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).
2016-02-05 02:30:48 +03:00
## 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.
2015-06-18 18:01:17 +03:00
## Download All Google Fonts
2015-03-07 02:44:52 +03:00
2021-03-01 12:34:54 +03:00
You can download all Google Fonts in a simple ZIP snapshot (over 600MB) from <https://github.com/google/fonts/archive/main.zip>
2015-06-18 18:01:17 +03:00
#### 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).
2020-03-03 13:32:30 +03:00
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
2015-06-18 18:01:17 +03:00
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.
2015-06-18 18:01:17 +03:00
The fonts files themselves also contain licensing and authorship metadata.
2015-03-08 10:03:30 +03:00
2015-03-07 02:44:52 +03:00
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.
2015-03-07 02:44:52 +03:00
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.
2015-06-18 18:01:17 +03:00
If you modify those fonts, please take care of this important detail.
2015-03-07 02:44:52 +03:00
## Source Files
2019-08-28 22:27:10 +03:00
Source files for each family are often available from the designer, or from [github.com/googlefonts](https://github.com/googlefonts)
2015-03-07 02:44:52 +03:00
2017-07-24 00:57:58 +03:00
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.
2015-03-07 02:44:52 +03:00
2017-07-24 00:57:58 +03:00
When customizing or remixing fonts, please do contact the designers to understand what they might need in order to include your improvements.
2015-03-07 02:44:52 +03:00
Most of all: Enjoy the fonts!
2021-03-04 02:15:59 +03:00
The Google Fonts team