Help:Extension:WebFonts

Story: As a user, I can find on this page what I need to know about web fonts, so that I can use it without being confused about it.

Web Fonts
Many languages do not have proper fonts easily available. This may be because the operating systems do not ship these fonts, the script has fonts but users don't know from where they will get them or how to install them in their system, or even the user is reading the wiki from a shared computer without these fonts. Sometimes it may be because the user does not know how to configure the operating system for a language or the user does not have enough permissions to do this. Because of all these reasons, providing the content in certain languages is facing issues. This extension tries to solve this by embedding the fonts in the wiki itself. Fonts will be served from the server and the user's system would not need to have the fonts installed.

Usage
When the extension is installed and enabled, along with the login, preferences link in the wiki page, a menu will appear to select a font for the page. By default, the first font in that menu will be applied to the wiki. A user can change the font and it will be remembered across the pages. Optionally user can disable the font embedding too, this choice will also remembered across pages, even for next visits, for 30 days.

If the font is available in user's local system, font will not be downloaded from the MediaWiki server. It will be taken from the user's computer. Otherwise, font will be downloaded from the server only once. ie when the user selects the font first time. Next time onwards, font will be taken from the local cache.

Disabling Webfonts extension
To disable the extension for your user account, go to Preferences -> Apprearance -> Uncheck Enable Webfonts option.

List of supported scripts, languages and fonts
... introduction sentence ...

Arabic
...

Devanagari
The following fonts are available for languages Hindi, Marathi, Maithili, Bhojpuri
 * Lohit Devanagari

Latin
...

...
...

Advanced use
There are two ways in wiki text to request web font functionality. Text can either be tagged with a language code or with a specific font style. When language tagging is used, the default web font for that language will be used. Examples are given below:

Some Hindi text here

Some Devanagari text here

Limitation and known issues

 * does not work on ...
 * link to open issues

Requesting support for new languages
...

Reporting issues
...

= TODO =
 * finish first version of documentation (Siebrand/Amir/Gerard)
 * help link to //mediawiki.org/wiki/Special:MyLanguage/HelpWeb_fonts in WebFonts code, similar to how it is done in Narayam (Santhosh)
 * Enable Narayam, WebFonts on this wiki (send out updated deployment announcement) (Niklas)