Extension:BudouX

**MediaWiki extensions manual**
BudouX; Release status: stable
Implementation	Skin, Locale
Description	integrate Google BudouX to enable beautiful and readable line breaks for CJK languages.
Author(s)	Kimagurenote (Corytalk)
Latest version	1.0.1
MediaWiki	1.25+
PHP	7.0+
License	Apache License 2.0
Download	https://kimagurenote.net/kn/BudouX#Download; https://kimagurenote.net/kn/BudouX#History
Example	https://kimagurenote.net/kn/BudouX
	Hooks used BeforePageDisplay;

The BudouX extension provides a way to integrate Google BudouX to enable beautiful and readable line breaks for CJK languages.

Installation

Download zip file from author's website, unzip it and place the file(s) in a directory called BudouX in your extensions/ folder.

Add the following code at the bottom of your LocalSettings.php file:

/* Extension:BudouX */
wfLoadExtension( 'BudouX' );
/* select a value suitable for your contents */
$wgBudouXLang = "ja";		// Japanese
$wgBudouXLang = "zh-hans";	// Simplified Chinese
$wgBudouXLang = "zh-hant";	// Traditional Chinese

Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

Languages

BudouX is supported for Japanese, Simplified Chinese and Traditional Chinese at this time.

You must set a language suitable for your contents.

ja - Japanese
zh-hans - Simplified Chinese
zh-hant - Traditional Chinese

Styles

(option) If you want to display text as justified, edit MediaWiki:Common.css on your server as follows. This is optional, you can fully customize it.

p, dd {
	text-align: justify;
}

Note: (MW 1.32+) You will need some permissions to edit Common.css, see: MediaWiki 1.32/interface-admin.

Exclude specified pages

(v1.0.1+)(option) If you want to exclude some pages, you can specify page names as follows. Case sensitive.

$wgBudouXExcludes = [ "Main Page", "Test Page" ];

Adapt specified tags

(v1.0.1+)(option) If you want to limit adapted tags, you can specify tag names as follows. Set as lower case.

$wgBudouXTags = [ "p", "dd" ];

If this variable not defined, will be used [ "p", "dd", "li" ] by default.

Limitations

This extension works in NS_MAIN or $wgContentNamespaces only.

This extension will not work in auto translated pages by Extension:SubTranslate.

This extension show no errors. It may be terminated quietly if meet some error.

BudouX may be conflicted with ‎<code> styles (background color).

This extension is not supported to load a custom model at this time. If you want to use a custom model, try to use Extension:Postscript to add the script.

BudouX Release status: stable
Implementation	Skin , Locale
Description	integrate Google BudouX to enable beautiful and readable line breaks for CJK languages.
Author(s)	Kimagurenote (Cory^talk)
Latest version	1.0.1
MediaWiki	1.25+
PHP	7.0+
License	Apache License 2.0
Download	https://kimagurenote.net/kn/BudouX#Download https://kimagurenote.net/kn/BudouX#History
Example	https://kimagurenote.net/kn/BudouX
Hooks used BeforePageDisplay