Jump to content

Extension:BudouX

From mediawiki.org
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

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

Installation

[edit]
  • 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
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

[edit]

Languages

[edit]

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

[edit]

(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

[edit]

(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

[edit]

(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

[edit]

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.

See also

[edit]