Chinese Character Variant Converter,
an open-source library for converting Chinese character variants to standard simplified or traditional characters.
* About the project's name and logo: "CHAR" comes from "Chinese character variant" and also refers to a type of beautiful fish with a gradient of red color (Arctic Char).
2024-11-15: npm package for JavaScript has been released.
pip install char-converter
Important Note: We have been checking and updating the data from time to time. Please run the following command to ensure the package is the latest version before using it to handle important mateirals every time.
pip install char-converter -U
- Mode: one2one
from char_converter import CharConverter
text = '苟馀情其訫姱㠯练要兮，镸顑頷亦何伤。'
converter = CharConverter('v2t')
converted_text = converter.convert(text)
# 苟餘情其信姱以練要兮，長顑頷亦何傷。
converter = CharConverter('v2s')
converted_text = converter.convert(text)
# 苟余情其信姱以练要兮，长顑颔亦何伤。
- Mode: one2many
from char_converter import CharConverter
text = '鈡𩄇毓秀'
converter = CharConverter('v2t')
converter.set_mode('one2many')
converted_text = converter.convert(text)
# 【鍾|鐘】靈毓秀
from char_converter import CharConverter
converter = CharConverter('v2s')
converter.convert_file(input_file, output_file)
<script src="https://unpkg.com/char_converter@latest/dist/bundle.js"></script>
<script>
const CharConverterClass = CharConverter.default;
const converter = new CharConverterClass('v2t', 'offline');
converter.setMode('one2many');
async function testConversion() {
const result = await converter.convert('鈡𩄇毓秀');
console.log(result);
}
testConversion();
</script>
npm install char_converter
Important Note: We have been checking and updating the data from time to time. When initializing the converter, two options ("online" and "offline") are both available. If choosing "online", the data will be retrieved directly from the updated online source. If choosing "offline", please run the following command to ensure the package is the latest version regularly to check if the data is up-to-date.
npm install char_converter@latest
- Mode: one2one
const CharConverter = require('char_converter');
const text = '苟馀情其訫姱㠯练要兮，镸顑頷亦何伤。';
const converter = new CharConverter('v2t', source = 'online'); // Variant to Traditional
converter.setMode('one2one');
const convertedText = converter.convert(text);
console.log(convertedText); // 苟餘情其信姱以練要兮，長顑頷亦何傷。
const converter = new CharConverter('v2s', source = 'online'); // Variant to Simplified
converter.setMode('one2one');
const convertedText = converter.convert(text);
console.log(convertedText); // 苟余情其信姱以练要兮，长顑颔亦何伤。
- Mode: one2many
const CharConverter = require('char_converter');
const text = '鈡𩄇毓秀'
const converter = new CharConverter('v2t', source = 'online'); // Variant to Traditional
converter.setMode('one2many');
const convertedText = converter.convert(text);
console.log(convertedText); // 【鍾|鐘】靈毓秀
Dictionary of Variant Chinese Characters
General Standard Chinese Characters Table
Yuqi Chen (data collection and programming)
Hongsu Wang (project manager)
Yiyi Wang (proofreading)
Fengyi Ji (data collection)
Kaini Xiong (proofreading)
