Extension:Ascii Translit

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual
Crystal Clear action run.png
Ascii Translit Extension

Release status: experimental

AsciiTranslitExtension2.png
Implementation Page action
Description Human readable URL while title contains non-Ascii chars.
Author(s) User:Vitas
Latest version 0.0.4
MediaWiki created on 1.6.8
Database changes No
License No license specified
Download .tgz

Translate the Ascii Translit extension if it is available at translatewiki.net

Check usage and version matrix; code metrics

When article title contains non-ascii characters, they apear in URL as urlencoded, (i.e. Těžiště (centroid in Czech) is T%C4%9B%C5%BEi%C5%A1t%C4%9B), which is not so easy to read. AsciiTranslitExtension allows you to use Ascii aproximation (or so called transliteration) in URL, and nonASCII in titles (at the same time). So article Těžiště will be Teziste in URL.

Hack is done by adding coresponding #redirect pages, and translate some types of links.

'Redirected from' message can be suppresed.

Installation[edit | edit source]

  1. Untar AsciiTranslitExtension.php to /extensions/ directory.
    • Note that the file type for the download is wrong. The download box has .tgz and the file downloaded has .gz, but the file contents are really that of an uncompressed .php file. Rename the file after downloading.
  2. Add this to LocalSettings.php:
 require_once( "extensions/AsciiTranslitExtension.php");

Configuration[edit | edit source]

  • $wgAsciiTranslitExtensionHideRedir -- boolean; true -- suppres 'Redirected from *' message for transliterated pages (default: false).
  • $wgAsciiTranslitExtensionHack -- boolean; True lead to not to use iconv for transliteration, when it does not work. It use str_replace, and it translits only few UTF-8 characters (now only Latin characters are supported) (can be easily extended) (default: false).
  • $wgAsciiTranslitExtensionNS -- boolean; translit also spacename names (default: true).

Note: set these variables before 'require_once '.

Bugs[edit | edit source]

  • When added to non empty wiki, redirections to existing pages are not created.
  • When there is collision (two pages have the same transliteration), links are generated incorrectly.
  • Only main namespace is transliterated.
  • Probably more, tell me...

changelog[edit | edit source]

  • 0.0.4 bad utf8 chars used in cyrillic, fixed
  • 0.0.3 Cyrillic support added, but I'm not from russia so i'm not sure about some characters. Especially hard and soft sign.

Who's using it?[edit | edit source]

Please add your wiki here! Add it to the top, and feel free to add a link to your favorite article or two.