Module:Convert character width/doc

This is a documentation subpage for Module:Convert character width.
It may contain usage information, categories and other content that is not part of the original module page.

This module is rated as ready for general use. It has reached a mature state, is considered relatively stable and bug-free, and may be used wherever appropriate. It can be mentioned on help pages and other Wikipedia resources as an option for new users. To minimise server load and avoid disruptive output, improvements should be developed through sandbox testing rather than repeated trial-and-error editing.

This Lua module is used on approximately 2,700 pages and changes may be widely noticed. Test changes in the module's /sandbox or /testcases subpages, or in your own module sandbox. Consider discussing changes on the talk page before implementing them.

This module converts a limited set of characters between halfwidth and fullwidth forms.

Usage

From half-width to full-width

{{#invoke:convert character width|full|text to convert}}

From full-width to half-width

{{#invoke:convert character width|half|text to convert}}

Examples

{{#invoke:convert character width|full|some text 0123456789}} → ｓｏｍｅ　ｔｅｘｔ　０１２３４５６７８９
{{#invoke:convert character width|half|ｓｏｍｅ　ｔｅｘｔ　０１２３４５６７８９}} → some text 0123456789

Support

Care should be taken when using this module with Hangul and katakana; as of September 2013 there is only limited support for katakana and no support for Hangul. Some of the more obscure punctuation characters are also not yet supported.

Data

The character data used by the module is located at Module:Convert character width/data. Fixes and updates to the data set are welcomed enthusiastically.