View source for Help:Extension:WebFonts/id

<languages/>
{{historical|[[Extension:WebFonts]] was replaced by [[Extension:UniversalLanguageSelector]]}}
Ini adalah dokumentasi pengguna untuk fungsionalitas font web. {{ll|Extension:WebFonts|Dokumentasi teknis}} untuk ekstensi Webfonts juga tersedia.

<span lang="en" dir="ltr" class="mw-content-ltr"><!-- Use this space for any language specific documentation that is not covered in the standard text. --></span>
<span lang="en" dir="ltr" class="mw-content-ltr">Many scripts for languages do not have proper fonts easily available. This may be because the operating systems does not have the fonts installed and the user does not know how to install them, or because the user is reading the wiki from a shared computer without the needed fonts installed. Because of all these reasons, providing the content in certain languages is facing issues. Web fonts solves this by embedding the fonts in wiki pages. The fonts are downloaded automatically so that the reading experience is complete and the reader doesn't see gibberish, questions marks or squares instead of letters.</span>
<span lang="en" dir="ltr" class="mw-content-ltr"><!-- Use this space for any language specific documentation that is not covered in the standard text. Start your text with an empty line. --></span>

<span id="Usage"></span>
== Pemakaian ==
[[File:<span lang="en" dir="ltr" class="mw-content-ltr">Screenshot-WebFonts-Menu-Anonymous.png</span>|{{dir|{{pagelang}}|left|right}}|thumb|239px|<span lang="en" dir="ltr" class="mw-content-ltr">WebFonts menu for an anonymous user</span>]]

<div lang="en" dir="ltr" class="mw-content-ltr">
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, the user can disable the font embedding too; this choice will also remembered across pages, even for next visits, for 30 days. The menu will not appear if there is no text in the page in a language WebFonts extension supports.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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, the font will be downloaded from the server the first time it is needed. Next time onwards, the font will be taken from the local cache.
</div>

<span id="Disable_web_fonts"></span>
== Nonaktifkan font web ==

<div lang="en" dir="ltr" class="mw-content-ltr">
To disable WebFonts when you are not logged in: open the WebFonts menu and choose the bottom option "{{int|webfonts-reset}}" (see screenshot). This disables the functionality using a cookie for 30 days. Cached font files may remain rendered for "font-family" styles.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To disable WebFonts when you are logged in: "{{int|preferences}}" {{larr}} "{{int|prefs-rendering}}" {{larr}} Uncheck option "{{int|webfonts-enable-preference}}" {{larr}} Click "{{int|saveprefs}}" to save your settings.
</div>

<div style="float: right; margin: 2em;">__TOC__</div>

<span id="List_of_supported_scripts,_languages_and_fonts"></span>
== Daftar skrip, bahasa, dan font yang didukung ==

<div lang="en" dir="ltr" class="mw-content-ltr">
There is web fonts support for many scripts. Below you can find an exhaustive list of all scripts that are currently supported and the languages they are active for by default.
</div>

<span id="Arabic_script"></span>
=== Skrip Arab ===

<div lang="en" dir="ltr" class="mw-content-ltr">
Supported languages:
</div>
{{#language:fa|{{PAGELANGUAGE}}}} (fa)
<div lang="en" dir="ltr" class="mw-content-ltr">
* Iranian Sans
</div>

<span id="Assamese_and_Bengali_script"></span>
=== Skrip Assamese dan Bengali ===

<div lang="en" dir="ltr" class="mw-content-ltr">
Supported languages:
</div>
{{#language:bn|{{PAGELANGUAGE}}}} (bn),
{{#language:as|{{PAGELANGUAGE}}}} (as),
{{#language:bpy|{{PAGELANGUAGE}}}} (bpy)
<div lang="en" dir="ltr" class="mw-content-ltr">
* Lohit Bengali (default)
* Lohit Assamese
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Devanagari script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Supported languages:
</div>
{{#language:hi|{{PAGELANGUAGE}}}} (hi),
{{#language:mr|{{PAGELANGUAGE}}}} (mr),
{{#language:mai|{{PAGELANGUAGE}}}} (mai),
{{#language:bh|{{PAGELANGUAGE}}}} (bh, bho),
{{#language:gom|{{PAGELANGUAGE}}}} (gom),
<!--{{#language:ahr|{{PAGELANGUAGE}}}} (ahr) does not work-->Ahirani (ahr)

<div lang="en" dir="ltr" class="mw-content-ltr">
* Lohit Devanagari
* Samyak Devanagari (not available in menu because of rendering issues)
* Madan (not available in menu because of rendering issues)
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Ethiopic (Geʻez) script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Supported languages:
</div>
{{#language:am|{{PAGELANGUAGE}}}} (am),
{{#language:ti|{{PAGELANGUAGE}}}} (ti)

<div lang="en" dir="ltr" class="mw-content-ltr">
* AbyssinicaSIL
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gujarati script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Lohit Gujarati
* Samyak Gujarati
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Gurmukhi script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Lohit Punjabi
* Saab
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Hebrew script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Miriam CLM
* Taamey Frank CLM
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Khmer script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Supported languages:
</div>Khmer (km).
{{#language:km|{{PAGELANGUAGE}}}} (km)

<div lang="en" dir="ltr" class="mw-content-ltr">
* KhmerOSbattambang
* KhmerOSbokor
* KhmerOSfreehand
* KhmerOSmuol
* KhmerOSmuollight
* KhmerOSmuolpali
* KhmerOSsiemreap
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Kannada script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Supported languages:
</div>
{{#language:kn|{{PAGELANGUAGE}}}} (kn),
{{#language:tcy|{{PAGELANGUAGE}}}} (tcy)

<div lang="en" dir="ltr" class="mw-content-ltr">
* Lohit Kannada
* Kedage
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Latin script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Charis SIL – supports Min Dong Chinese
* Perizia
* RufScript
* Ubuntu – stylized font made by Ubuntu
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Malayalam script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* AnjaliOldLipi
* Meera
* RaghuMalayalam
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Myanmar (Burmese) script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Masterpiece Uni Sans
* Myanmar3
* Padauk-Regular
* Yunghkio
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Oriya script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Lohit Oriya
* Utkal
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Saurashtra script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Pagul
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Tamil script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Lohit Tamil
* Thendral
* Thenee
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Telugu script ===
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* Lohit Telugu
* Pothana2000
* Vemana2000
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Advanced use ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
There are two ways in wiki text to trigger web fonts functionality. Text can be tagged with a language code and with a specific font style. When language tagging is used, the default web font for that language will be used. Language tagging is necessary when the language is different from the language of a page. Language tagging is encouraged, because it will also lead to improved search engine results, spell-checking, speech synthesis, speech recognition, etc.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''To mark a paragraph of text as Hindi and load the default web font for it:'''
</div>

{| class="wikitable"
|-
! Teks sumber !! Hasil
|-
| <syntaxhighlight lang=html><div lang="hi">नमूना पाठ</div></syntaxhighlight>
|| <div lang="hi">नमूना पाठ</div>
|}

<div lang="en" dir="ltr" class="mw-content-ltr">
'''To mark a paragraph of text as Hindi and load the non-standard web font "Samyak Devanagari" for it:'''
</div>

{| class="wikitable"
|-
! Teks sumber !! Hasil
|-
| <syntaxhighlight lang=html><div lang="hi" style="font-family: 'Samyak Devanagari'">नमूना पाठ</div></syntaxhighlight>
|| <div lang="hi" style="font-family: 'Samyak Devanagari'">नमूना पाठ</div>
|}

<div lang="en" dir="ltr" class="mw-content-ltr">
== Limitations and known issues ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Even if a browser supports web fonts, there is no guarantee that it can render the text correctly. This is often a problem for example in Indic scripts, where the glyphs are not just placed one after another without any changes, like in Latin and Cyrillic scripts. The correct rendering and rendering quality also depend on the browser and the operating system that is used. Modern web browsers and operating systems like recent Linux desktop distributions, Mac OS X and Windows 7 perform pretty well, but older web browsers (like Internet Explorer 6) and operating systems like Windows XP may provide a sub-optimal user experience.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Because of the ''flash of unstyled text'' (FOUT) that happens on first load, this technology gets unpractical if the font files grow very big. This currently prevents adding fonts for Chinese for example. The WebFonts extension does not support partial font downloading, where only those glyphs that are used in the page would be loaded.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Web fonts are currently not supported for Internet Explorer 6 on any Windows version or Internet Explorer 8 on Windows XP because of known issues.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
A list of known issues is in the [https://bugzilla.wikimedia.org/buglist.cgi?component=WebFonts&product=MediaWiki%20extensions&resolution=---&resolution=LATER&resolution=DUPLICATE&order=priority%2Cbug_severity%2Cbug_id%20DESC MediaWiki bug tracker].
</div>

<span id="New_scripts,_languages_and_translations"></span>
== Skrip, bahasa, dan terjemahan baru ==

<div lang="en" dir="ltr" class="mw-content-ltr">
Only free fonts can be used for web fonts. The font license must allow redistributing the font and converting it to another formats. [[w:SIL Open Font License|SIL Open Font License]] is preferred. Bugs or bad rendering caused by missing hinting information in the font may prevent using a font as a web font. If you are aware of a suitable font, please request it to be added in the [https://bugzilla.wikimedia.org/enter_bug.cgi?product=MediaWiki%20extensions&component=WebFonts bug tracker].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Please report all issues in the [https://bugzilla.wikimedia.org/enter_bug.cgi?product=MediaWiki%20extensions&component=WebFonts bug tracker] and [[translatewiki:Special:Translate/ext-webfonts|translate this functionality]] at translatewiki.net.
</div>

[[Category:Extension help{{#translation:}}|WebFonts]]