Font description template: Difference between revisions

Latest revision as of 12:42, 13 February 2016

Foreword

Our SIG workflow is organised around wiki pages that adhere to this template.
The source of this page contains comments providing guidance to fill out each section. They are invisible in view mode. To read them, choose the « Edit » tab.
Copy the source to a new page before making changes! Do not edit this template directly!

Curabitur ut dui ac justo rhoncus facilisis

Description

Etiam velit quam, accumsan ac, semper vitae, laoreet non, sapien. Quisque mauris dui, bibendum sed, suscipit id, vestibulum eget, metus. Donec ipsum mauris, luctus in, porta a, ultrices congue, nulla. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Integer pede. Maecenas blandit luctus eros. Vivamus vel lectus. Suspendisse dapibus commodo sapien. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Suspendisse at diam.

Characteristics

Homepage	Format & features	License	Review reference	Koji page	pkgdb page
①	②	③	④	⑤	⑥

Style					Faces					Scripts
Sans		Serif		Other	R	B	I	BI	Other	Latin	Greek	Cyrillic	Other
Variable	Monospace	Variable	Monospace	Other	R	B	I	BI	Other	Latin	Greek	Cyrillic	Other
				①					②				③

Caveats

Etiam gravida lobortis ligula.
Proin ultricies sapien vitae eros.
Aliquam dignissim luctus risus.

Additional information

Suspendisse libero orci, sodales non, interdum vel, accumsan non, lectus. Vivamus at neque nec lacus porta molestie. Etiam et metus at urna egestas dictum. Donec sagittis velit sed urna.

Fonts in Fedora
The Fonts SIG takes loving care of Fedora fonts. Please join this special interest group if you are interested in creating, improving, packaging, or just suggesting a font. Any help will be appreciated.

@@ Line 1: / Line 1: @@
 {{CompactHeader|fonts-sig}}
-{{admon/note | Foreword |
+{{admon/important | Foreword |
-* This template plays a huge part in the [[Font_package_lifecycle| lifecycle]] of our font packages.
+* Our SIG [[Font_package_lifecycle| workflow]] is organised around wiki pages that adhere to this template.
-* Use it to create « ''Name_Font'' » or « ''Name_Fonts'' » pages:
+* The source of this page contains '''comments''' providing guidance to fill out each section. They are invisible in view mode.  To read them, choose the « Edit » tab.
-** ''Name_Fonts'' should be « ''Foo_fonts'' » and not « ''FooFonts_fonts'' » or « ''FooFont_fonts'' ».
+* Copy the source to a '''new page''' before making changes! '''Do not edit this template directly!'''}}
-** use the ''Foundry Name'' convention if necessary (i.e « ''SIL_Abyssinica_fonts'' » good, « ''Abyssinica_SIL_fonts'' » bad).
-* Frames that use this style are '''redaction tips'''. Please remove them from your page once they are no longer necessary. Do the same for the ''lorem ipsum'' bits.
-* Remember the more complete and accurate the information you add is, the more likely a font is to be packaged and widely used.
-* Do not forget to update the page categorization once the font status changes.
-}}
+<!--
+◆ Use this template to create « Name_Fonts » pages:
+  — « Name_Fonts » should be « Foo_fonts » and not « FooFonts_fonts » or « FooFont_fonts ».
+  — use the « Foundry Name » convention if necessary.
+  ⇒ See also Packaging:FontsPolicy#Naming we try to follow the same conventions for our wiki pages.
+◆ Please remove the « lorem ipsum » filers once they are no longer necessary. Do the same for those comments.
+◆ Do not forget to update the page categorization each time the font described in this page passes one packaging step.
+-->
 ''Curabitur ut dui ac justo rhoncus facilisis''
-{{admon/note | Requester | Replace the preceding line with a package '''summary''' proposal. For example « ''Foo decorative font'' ».}}
+<!--
-{{admon/note | Packager | Correct the proposal and replace it with the final package '''summary'''.}}
+◆ Requester: replace the preceding line with a package summary proposal. For example: A decorative font inspired from xxx.
+◆ Packager:  correct the proposal and replace it with the final package summary.
+-->
@@ Line 22: / Line 27: @@
 Etiam velit quam, accumsan ac, semper vitae, laoreet non, sapien. Quisque mauris dui, bibendum sed, suscipit id, vestibulum eget, metus. Donec ipsum mauris, luctus in, porta a, ultrices congue, nulla. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Integer pede. Maecenas blandit luctus eros. Vivamus vel lectus. Suspendisse dapibus commodo sapien. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Suspendisse at diam.
-{{admon/note | Requester | Replace the preceding paragraph with a package '''description''' proposal.}}
+<!--
-{{admon/note | Packager | Correct the proposal and replace it with the final package '''description'''.}}
+◆ Requester: replace the preceding paragraph with a package description proposal:
+  — who designed this font family,
+  — how can its style be described,
+  — what unusual world scripts does it add support for,
+  — what's its intended use (Titling…).
+◆ Packager: correct the proposal and replace it with the final package description.
+-->
 == Characteristics ==
@@ Line 45: / Line 55: @@
 |}
-{{admon/note | Requester |
+<!--
-Fill in the following information:
+◆ Requester: fill in the following information:
-* '''Homepage''' ① is a link to the font project upstream home, for example [http://dejavu.sf.net/ DejaVu].
+  – Homepage ① : is a link to the font project upstream home, for example [http://dejavu.sf.net/ DejaVu].
-* '''Format''' ② we prefer modern [http://www.myanmarnlp.net.mm/doc/Workshop%20on%20Myanmar%20Unicode%20Font_2005-12-16/Presentations/Myanmar%20OpenType%20Font%2020051215.ppt OpenType] (''TTF''/''OTF'') fonts, and [http://www.unicode.org/standard/WhatIsUnicode.html Unicode] encoding is mandatory<ref>Fedora does not support legacy custom encodings.</ref>. If the font includes advanced smart font [http://linuxlibertine.sourceforge.net/Libertine-EN.html#opentype features] such as ''locl'' or ''hinting'', please document them too.
+  – Format ② :
-* '''License''' ③ should correspond to an entry on our [[Legal_considerations_for_fonts#licenses|legal page]]. If that's not the case please follow the procedure documented on that page to check the license acceptability.
+    ‣ we prefer modern TTF or OTF fonts,
-}}
+      ⇒ http://www.myanmarnlp.net.mm/doc/Workshop%20on%20Myanmar%20Unicode%20Font_2005-12-16/Presentations/Myanmar%20OpenType%20Font%2020051215.ppt
-{{admon/note | Packager |
+    ‣ Unicode encoding is mandatory.
-* Once a package has entered the review stage, add a '''Review reference''' ④ such as [[rhbug:181994|181994]]. You can reference this wiki page in your review request as additional information. Please do not forget to CC ''fedora-fonts-bugs-list@redhat.com'' on your bugzilla ticket.
+      ⇒ http://www.unicode.org/standard/WhatIsUnicode.html
-* Once a package has been approved, add the corresponding:
+    ‣ If the font includes advanced smart font features please document them too.
-** '''Koji page''' ⑤ pointer (for example [[koji:dejavu-fonts|dejavu-fonts]]).
+      ⇒ http://linuxlibertine.sourceforge.net/Libertine-EN.html#opentype
-** '''pkgdb page''' ⑥ pointer (for example [[pkgdb:dejavu-fonts|dejavu-fonts]]).
+  – License ③: should correspond to an entry on our legal page. If that's not the case please follow the procedure documented on that page to check the license acceptability.
-}}
+      ⇒ Legal_considerations_for_fonts#licenses
+◆ Packager:
+  — Once a package has entered the review stage:
+    ‣ add a Review reference ④ such as [[rhbug:181994|181994]].
+    ‣ you can reference this wiki page in your review request as additional information.
+    ‣ please do not forget to CC fonts-bugs@lists.fedoraproject.org on your bugzilla ticket.
+    ‣ please do not forget to change this page category (see below).
+  — Once a package has been approved:
+    ‣ add the corresponding Koji page ⑤ pointer (for example [[koji:dejavu-fonts|dejavu-fonts]]).
+    ‣ add the corresponding pkgdb page ⑥ pointer (for example [[pkgdb:dejavu-fonts|dejavu-fonts]]).
+    ‣ please do not forget to change this page category (see below).
+-->
 {|
@@ Line 98: / Line 118: @@
 |}
-{{admon/note | Requester |
+<!--
-* Add as many lines as necessary in the preceding table. Be careful not to mix faces with different characteristics on the same line (for example if a font bundle includes a serif font with a regular and bold face, and a sans-serif font with regular, bold, italic and bold-italic faces, use two different lines).
+◆ Requester:
-* Use ✘s to indicate a common feature is present.
+  — Add as many lines as necessary in the preceding table. Be careful not to mix faces with different characteristics on the same line (for example if a font bundle includes a serif font with a regular and bold face, and a sans-serif font with regular, bold, italic and bold-italic faces, use two different lines).
-* '''Other''' features can be filled this way:
+  — Use ✘s to indicate a common feature is present.
-** other styles ①: ''fantasy'', ''cursive'', etc,
+  — « Other » features can be filled this way:
-** other faces ②: ''condensed'', ''extralight'', etc,
+    ‣ other styles ①: fantasy, cursive, etc
-** other scripts ③: list the corresponding [http://www.unicode.org/iso15924/iso15924-codes.html IS0 15924] codes. Tools like '''gucharmap''' or [http://www.fileformat.info/info/unicode/font/custom.htm fileformat's online test] can be used to check coverage if upstream's information is not clear enough.
+    ‣ other faces ②: condensed, extralight, etc
-}}
+    ‣ other scripts ③: list the corresponding IS0 15924 codes.
+      ⇒ http://www.unicode.org/iso15924/iso15924-codes.html
+      ⇒ tools you can use to check coverage: gucharmap, fontforge, http://www.fileformat.info/info/unicode/font/custom.htm
+-->
 == Caveats ==
@@ Line 113: / Line 136: @@
 # Aliquam dignissim luctus risus.
-{{admon/note | Requester and reviewer |
+<!--
-List there the elements you know of that will impact packaging activity, such as licensing that needs clarifying, an upstream that uses a specific non-english language to communicate, broken or incomplete build scripts, etc.
+◆ Requester and packager: list there the elements you know of that will impact packaging activity, such as licensing that needs clarifying, an upstream that uses a specific non-english language to communicate, broken or incomplete build scripts, etc.
-}}
+◆ Packager: take care of those items and remove them from the page once they've been dealt with.
-{{admon/note | Packager | Take care of those items and remove them from the page once they've been dealt with.
+-->
-}}
@@ Line 124: / Line 146: @@
 Suspendisse libero orci, sodales non, interdum vel, accumsan non, lectus. Vivamus at neque nec lacus porta molestie. Etiam et metus at urna egestas dictum. Donec sagittis velit sed urna.
-{{admon/note | Reviewer and packager |
+<!--
-If you have some additional information that does not fit in the previous sections, add it there.
+◆ Requester and packager: if you have some additional information that does not fit in the previous sections, add it there.
-}}
+-->
-{{:Fonts_SIG_signature}}
-{{admon/note | Requester | You '''MUST''' replace the [[:Category:Fonts SIG]] and [[:Category:Documentation]] tag with [[:Category:Font wishlist]].}}
-{{admon/note | Packager |
-You '''MUST''' replace the [[:Category:Font wishlist]] tag with:
-* [[:Category:In-progress fonts]] for a font being worked on, but not available in Fedora yet. Typically in packaging review stage.
-* [[:Category:Packaged fonts]] for a packaged font, available in Fedora.
-* [[:Category:Rejected and retired fonts]] for a font we decided not to package after review, or removed from current Fedora repositories for some other reason.
-Don't forget to remove the ''« : »'' before ''« Category »'' to activate a particular category tag.}}
-{{admon/note | Requester and packager | You '''MAY''' additionnaly tag your page with one of the following categories:
+{{:Fonts_SIG_signature}} [[Category:Fonts SIG|Template for describing fonts]] [[Category:Documentation|Font description template]] [[Category:Template]]
-* [[:Category:Decorative fonts]] for a font used in titles and other short runs of text, typically requested by the [[Artwork | artTeam]].
-* [[:Category:International fonts]] for a font with unusual unicode coverage, typically requested by the [[I18N | internationalization project]] or a [http://translate.fedoraproject.org/teams localization team].
-* [[:Category:Technical fonts]] for a font with coverage of technical unicode blocks (math, engineering and other non-text blocks).
-Again, don't forget to remove the ''« : »'' before ''« Category »'' to activate your category tag.
-}}
-[[Category:Fonts SIG|Template for describing fonts]] [[Category:Documentation|Font description template]] [[Category:Template]]
+<!--
+◆ Requester: replace existing categories with « Category:Font wishlist »
+◆ Packager: replace the « Category:Font wishlist » by
+  — « Category:In-progress fonts » for a font being worked on, but not available in Fedora yet. Typically in packaging review stage.
+  — « Category:Packaged fonts » for a packaged font, available in Fedora.
+  — « Category:Rejected and retired fonts » for a font we decided not to package after review, or removed from current Fedora repositories for some other reason.
+◆ Requester and packager: you may additionally tag your page with one of the following categories:
+  — « Category:Decorative fonts » for a font used in titles and other short runs of text, typically requested by the Artwork team
+  — « Category:International fonts » for a font with unusual unicode coverage, typically requested by the I18N or L10N teams
+  — « Category:Technical fonts » for a font with coverage of technical unicode blocks (math, engineering, music and other non-text blocks).
+-->

Search