Writing systems

This page gives basic information on support for various aspects of writing systems: languages written in multiple scripts; writing direction; font rendering and input.

Multiple scripts, multiple dialects
Many languages are written with multiple scripts. Often this is possible but lacks support in the software, and sometimes it is difficult if not impossible to implement. Some languages do have a LanguageConverter that adds support for multiple writing systems.

Some languages have very similar dialects that are written in the same script(s) and can&mdash;on a technical level—be treated in the same way as different scripts.

LanguageConverter
For documentation on how to use LanguageConverter, see 

(LC) is a system based on language variants that automatically converts the content of a page into a different variant. A variant is mostly the same language in a different script. To use the LanguageConverter, go to your Internationalisation preferences. If you are on a wiki that supports conversion, you'll see an extra option for choosing the script.

'''T21044 -- this needs more documentation! '''

It is implemented for the following languages (as of July 2023; see languagesWithVariants for the latest list):


 * (ban): Balinese (ban-bali), Latin (ban-latn) [1.36+]
 * (crh): Latin (crh-latn), Cyrillic (crh-cyrl)
 * (en): Normal (en), Pig Latin (en-x-piglatin) (for testing, only when is enabled)
 * (gan): Simplified (gan-hans), Traditional (gan-hant)
 * (iu): Latin (ike-latn), Syllabics (ike-cans) [1.18+]
 * (kk): Cyrillic (kk-cyrl), Latin (kk-latn), Arabic (kk-arab)
 * (ku): Latin (ku-latn), Arabic (ku-arab) [ + ]
 * (sh): Cyrillic (sh-cyrl), Latin (sh-latn) [1.40+]
 * (shi): Tifinagh (shi-tfng), Latin (shi-latn) [1.19+]
 * (sr): Cyrillic (sr-ec), Latin (sr-el)
 * (tg): Cyrillic (tg-cyrl), Latin (tg-latn)
 * (tly): Cyrillic (tly-cyrl), Latin (tly-latn) [1.36+]
 * (uz): Cyrillic (uz-cyrl), Latin (uz-latin) [1.20+]
 * (wuu): Simplified (wuu-hans), Traditional (wuu-hant) [1.41+]
 * (zh):
 * (zh-hans): China (zh-cn), Singapore (zh-sg), Malaysia (zh-my)
 * (zh-hant): Taiwan (zh-tw), Hong Kong (zh-hk), Macau (zh-mo)

And it is needed for many more languages!

Language code tags for scripts should follow the ISO 15924 standard.

A current limitation of this system is that it may be particularly bad at dealing with multiple writing systems based on the same underlying script. Chinese Wikipedians occasionally use  (unidirectional) for failing cases. As LC always tries to eat up the largest chunks of words using  in PHP,   (breaking up words) can be often useful too.

Supporting configuration
The wgULS/wgUVS functions in zhwp's sitelib allows for easy variant selection in userscript UIs. This can help scriptwriters produce a variant-aware interface for users. For other places unreachable by LC, can be used to fetch the current UI language/variant.

The PreviewWithVariant gadget allows Wikipedians to check conversion results in the editor preview. You can configure it for your own wiki.

"Foreign language marker" templates like should add "disable conversion" markers   around the quoted foreign text to avoid mis-conversion. On Hans/Hant wikipedias this becomes a concern for Japanese Kanji and Vietnamese Han Nom, while on Wikipedias with Latin text marked for conversion this concern should be immediate.

The WikitextLC module allows for easily inserting LC commands to Lua output. The NoteTA and CGroup system allow for accessing pre-defined sets of subject-specific conversions. Module:地区用词 allows for an adaptive output of the form "foo, known in PLACE and PLACE as bar, and PLACE as baz".

Automated title redirection on URLs may cause apparent inconvenience for interfaces without this feature. See T49725 for the Lua task and T160952 for the section-anchor task.

Directionality
Most writing systems operate as characters written left-to-right (LTR), with lines stacked from top-to-bottom (TtB).

A few common scripts (Arabic and Hebrew in particular) write characters right-to-left (RTL) -- see directionality support for more details on how we handle right-to-left and mixed bidirectional text with HTML output and CSS styles.

Note that an individual language can be used with scripts that have different directionalities, such as Kazakh and Kurdish which support Latin and Arabic variants.

Note also that the World Wide Web Consortium has defined more directionalities for the use in web pages, such as North East Asian top-to-bottom ones, with lines stacked either from left to right or right to left.

Font rendering and input
Many scripts do not have proper fonts easily available to users. This may be because operating systems do not ship these fonts, or users don't know how to install them or don't have enough permissions to do this. The 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.

UniversalLanguageSelector adds support to be able to type a certain script, so users do not have to rely on external tools or support on their systems.