#About section on any specimen page of Google Fonts to provide further information about the font family.
The Article file is a new expanded version of the DESCRIPTION.en_us.html file that 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 images should live in an article/ directory alongside the METADATA.pb file in the root of the ofl/fontname directory. Typically, only the Noto fonts are expected to combine the DESCRIPTION.en_us.html and ARTICLE.en_us.html files. For all the other families (non-Noto), if an article with images is added, the description should be overwritten by the Article. This means that, in the case of adding expanded content and images, we should shift all the Description content to the Article and delete the DESCRIPTION.en_us.html.
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 has a long text.
You can copy/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 definitely add a translation to the description 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>
Please refer to the Promote your font section of this Guide for fully detailed information on these images. The following summarizes the main specifications for the required images.
<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><img> and <video>See Space+Grotesk#about provided by DESCRIPTION.en_us.html as an example: it gives plenty of links (mini-website, original authors, referenced font published in GF), and follows all requirements.
See Zen+Antique#about as an example, provided by this file DESCRIPTION.en_us.html.
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
This file follows the same requirements as the Article file with some exceptions:
<img> and video are not allowed.However, please bear in mind that following our new efforts to promote the fonts, the Description file is considered legacy.