Extension:Josa

From mediawiki.org
MediaWiki extensions manual
Josa
Release status: stable
Implementation Parser function
Description Automates josa part of Korean postposition process.
Author(s) Bae Junehyeon (*devunttalk)
Latest version 0.1 (2014-01-29)
MediaWiki >= 1.42
PHP 5.4+
Database changes No
License MIT License
Download
Example {{#은는:한글}} -> 한글은
Quarterly downloads 6 (Ranked 143rd)
Translate the Josa extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The Josa extension automates josa (it's pronounced as /dʒo:sa/ or /ʨo:sa/) part of Korean postposition process.

Installation

  • Download and move the extracted Josa folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Josa
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'Josa' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.


Usage

  • {{#functionname: word }}
  • {{#functionname: word | argument }}
  • {{#functionname: word | argument 1 | argument 2 }} 1.30+

Function names

The function will be one of below:

English and other languages Korean
EulRuel 을를
EunNeun 은는
EGa 이가
GwaWa 과와
AYa 아야
Euro 으로
E

A Josa function call without any option will be rendered to the word and a josa. Some special characters are automatically ignored.

  • {{#EunNeun: 한글}}한글은
  • {{#EulRuel: 위키백과}}위키백과를
  • {{#EGa: '비타민'}}'비타민'이
  • {{#과와: 미디어위키}}미디어위키와
  • {{#아야: 지원}}지원아
  • {{#이: 정민}}가정민이가
  • {{#으로: [[학업]]}}학업으로
  • {{#으로: 100%}}100%으로
  • {{#EulRuel: 글자 Ñ}}글자 Ñ를 (bug)

It is OK that the case in given word is written in English alphabet or ends with a number.

  • {{#EulRuel: DNA}}DNA를
  • {{#EunNeun: ATM}}ATM은
  • {{#Euro: 119}}119로

But other letters will add parenthesis:

  • {{#EulRuel: 직원(3명)}}직원(3명)을(를)

Sometimes results in a bug:

  • {{#EulRuel: 國語}}國語을

Arguments

MediaWiki 1.30+

Argument must be one of those:

Argument Alias Description
josaonly 조사만 Just render a Josa, the given word will be removed. {{#EunNeun: 한글|josaonly}}
override=foo 덮어쓰기, 오버라이드 Replace the Josa with the given text. {{#EulRuel:시약 100g|override=을}}시약 100g을

The order of the arguments does not matter.

MediaWiki 1.29 or earlier

If second argument is 0, the base word will be removed.

  • {{#EulRuel: 한글|0}}

Any other argument makes base word remain. Technically, PHP determines whether the value is true or not. So 'false' is true. See more examples:

  • {{#EulRuel: 한글|false}}한글을
  • {{#EulRuel: 한글|true}}한글을
  • {{#EulRuel: 한글|1}}한글을