#About section of any specimen page on Google Fonts, giving readers further details about the font family.
The Article file includes images and longer-form information and content. It appears on the Google Fonts site as the main content in the About & License section. For example, see the About page of Playpen Sans, and then view the ofl/playpensans directory in the Google Fonts repo: github.com/google/fonts/tree/main/ofl/playpensans.
The ARTICLE.en_us.html file and its images should live in an article/ directory alongside the METADATA.pb file in the root of the ofl/fontname directory.
Every family now uses an ARTICLE.en_us.html file, even when it contains no images. (The legacy DESCRIPTION.en_us.html file has been retired: all of the About content now lives in the Article.)
Here are some guidelines for how to prepare the article/ directory and files:
It must include a hypertext link to the upstream repository — that is, the designer’s GitHub repository. This line of text usually goes at the end of the first paragraph, before the line that separates it from the added text when the article is long.
You can copy and paste the following line (don’t forget to adjust the URL):
To contribute, see <a href="https://github.com/owner/fontname">github.com/owner/fontname</a>
The text should be updated when the font is upgraded, to let people know what changed.
Example:
This font was upgraded in July 2021 to expand its language coverage. It now supports Greek and Cyrillic.
.en_us extension, but you can add a translation to the text when the font primarily targets an audience reading a non-Latin script.You may format text with the font family by using HTML span tags with the "autonym" class. This should not be used to style the entire document; use it sparingly to document available features in the font family. For example, to style the text “THIS TEXT” with the font family, enter HTML like this:
<span class="autonym">THIS TEXT</span>
The Article file supports images, which must live in the article/ directory alongside ARTICLE.en_us.html. For the full image specifications — formats, file sizes, resolution, and social media requirements — see the Promote your font section of this Guide. In summary:
knowledge_graph.py GitHub workflow).The images in this repository are licensed under the CC https://creativecommons.org/licenses/by-sa/4.0/. This license mention must be present in the repository, inside the documentation folder (see Promote your font for details).
There are two options for including videos in the Article file: an MP4 with a maximum file size of 1.4 MB, or a YouTube link.
For an MP4 video, it must follow this format:
<video autoplay muted src="your-video-name.mp4" type="video/mp4"></video>
or, if you need to loop it:
```
</video>```
You can use these cases as reference: Danfo, Savate
The YouTube link option requires a cover image to display as a preview, and must follow this format:
<a href="https://youtu.be/videoIDnumber"><img src="your-cover-image.png" /></a>
<p><em><a href="https://youtu.be/videoIDnumber">Watch the introduction video on YouTube</a></em></p>
<a>, <blockquote>, <code>, <em>, <figcaption>, <figure>, <hr>, <h3>, <h4>, <h5>, <img>, <li>, <p>, <pre>, <span>, <strong>, <ul>, <ol>, <sub><img> and <video>.<applet>, <base>, <embed>, <form>, <frame>, <frameset>, <head>, <iframe>, <link>, <math>, <meta>, <object>, <script>, <style>, <svg>, <template>See Space+Grotesk#about as an example: it gives plenty of links (mini-website, original authors, referenced font published on GF), and follows all the requirements.
See Zen+Antique#about as an example.
HTML snippet
<p>Zen Antique features two kinds of Antique Japanese with Kanji.
The impression of the weights (thickness) of strokes are different among characters—Hiragana and Latin alphabets are slightly lighter,
while Katakana and Kanji are slightly heavier, which gives the unique rhythm and taste in this font.
<a href="https://fonts.google.com/specimen/Zen+Antique+Soft">Zen Antique Soft</a> has a slightly rounded effect on the corners.</p>
<p>To contribute to the project, visit <a href="https://github.com/googlefonts/zen-antique">github.com/googlefonts/zen-antique</a></p>
<p>Zen Antique には、古風な雰囲気の二種類の漢字を含む日本語書体があります。
文字によって画線の太さに変化があり、ひらがなと欧文は細め、カタカナと漢字は太めで、フォントに独特のリズムと味わいを与えています。
また、<a href="https://fonts.google.com/specimen/Zen+Antique+Soft?subset=japanese">Zen Antique Soft</a> では、角が少し丸くなっています。</p>
<p>このプロジェクトに参加して貢献したい方は、次の URL をご参照ください。<a href="https://github.com/googlefonts/zen-antique">github.com/googlefonts/zen-antique</a></p>
Result on Google Fonts
About Zen Antique
Zen Antique features two kinds of Antique Japanese with Kanji. The impression of the weights (thickness) of strokes are different among characters—Hiragana and Latin alphabets are slightly lighter, while Katakana and Kanji are slightly heavier, which gives the unique rhythm and taste in this font. Zen Antique Soft has a slightly rounded effect on the corners.
To contribute to the project, visit github.com/googlefonts/zen-antique
Zen Antique には、古風な雰囲気の二種類の漢字を含む日本語書体があります。 文字によって画線の太さに変化があり、ひらがなと欧文は細め、カタカナと漢字は太めで、フォントに独特のリズムと味わいを与えています。 また、Zen Antique Soft では、角が少し丸くなっています。
このプロジェクトに参加して貢献したい方は、次の URL をご参照ください。github.com/googlefonts/zen-antique