Extension:Josa

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.47.0
Database changes	No
Hooks used ParserFirstCallInit
Licence	MIT License
Download	Download extension Git [?]: Browse repository (GitHub) Gerrit code review Git commit log Download source tarball
Example	{{#은는:한글}} -> 한글은
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' );
  

• 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}} → 한글을