1# Open Chinese Convert 開放中文轉換
2
3[ ![Download](https://api.bintray.com/packages/byvoid/opencc/OpenCC/images/download.svg) ](https://bintray.com/byvoid/opencc/OpenCC/_latestVersion)
4[![Build Status](https://travis-ci.org/BYVoid/OpenCC.svg?branch=master)](https://travis-ci.org/BYVoid/OpenCC)
5
6## Introduction 介紹
7
8Open Chinese Convert (OpenCC, 開放中文轉換) is an opensource project for conversion between Traditional Chinese and Simplified Chinese, supporting character-level conversion, phrase-level conversion, variant conversion and regional idioms among Mainland China, Taiwan and Hong kong.
9
10中文簡繁轉換開源項目,支持詞彙級別的轉換、異體字轉換和地區習慣用詞轉換(中國大陸、臺灣、香港)。
11
12### Features 特點
13
14* 嚴格區分「一簡對多繁」和「一簡對多異」。
15* 完全兼容異體字,可以實現動態替換。
16* 嚴格審校一簡對多繁詞條,原則爲「能分則不合」。
17* 支持中國大陸、臺灣、香港異體字和地區習慣用詞轉換,如「裏」「裡」、「鼠標」「滑鼠」。
18* 詞庫和函數庫完全分離,可以自由修改、導入、擴展。
19* 支持C、C++、Python、PHP、Java、Ruby、Node.js and Android。
20* 兼容Windows、Linux、Mac平臺。
21
22### Links 相關鏈接
23
24* Introduction 詳細介紹 https://github.com/BYVoid/OpenCC/wiki/%E7%B7%A3%E7%94%B1
25* OpenCC Online (在線轉換) http://opencc.byvoid.com/
26* 現代漢語常用簡繁一對多字義辨析表 http://ytenx.org/byohlyuk/KienxPyan
27
28## Installation 安裝
29
30* [Debian](http://packages.qa.debian.org/o/opencc.html)
31* [Ubuntu](https://launchpad.net/ubuntu/+source/opencc)
32* [Fedora](https://admin.fedoraproject.org/pkgdb/package/opencc/)
33* [Arch Linux](https://www.archlinux.org/packages/community/x86_64/opencc/)
34* [Mac OS](https://github.com/Homebrew/homebrew-core/blob/master/Formula/opencc.rb)
35* [Node.js](https://npmjs.org/package/opencc)
36
37## Download 下載
38
39https://bintray.com/byvoid/opencc/OpenCC
40
41## Usage 使用
42
43### Command Line 命令行
44
45`opencc --help`
46
47### Configurations 配置文件
48
49#### 預設配置文件
50
51* `s2t.json` Simplified Chinese to Traditional Chinese 簡體到繁體
52* `t2s.json` Traditional Chinese to Simplified Chinese 繁體到簡體
53* `s2tw.json` Simplified Chinese to Traditional Chinese (Taiwan Standard) 簡體到臺灣正體
54* `tw2s.json` Traditional Chinese (Taiwan Standard) to Simplified Chinese 臺灣正體到簡體
55* `s2hk.json` Simplified Chinese to Traditional Chinese (Hong Kong Standard) 簡體到香港繁體(香港小學學習字詞表標準)
56* `hk2s.json` Traditional Chinese (Hong Kong Standard) to Simplified Chinese 香港繁體(香港小學學習字詞表標準)到簡體
57* `s2twp.json` Simplified Chinese to Traditional Chinese (Taiwan Standard) with Taiwanese idiom 簡體到繁體(臺灣正體標準)並轉換爲臺灣常用詞彙
58* `tw2sp.json` Traditional Chinese (Taiwan Standard) to Simplified Chinese with Mainland Chinese idiom 繁體(臺灣正體標準)到簡體並轉換爲中國大陸常用詞彙
59* `t2tw.json` Traditional Chinese (OpenCC Standard) to Taiwan Standard 繁體(OpenCC 標準)到臺灣正體
60* `t2hk.json` Traditional Chinese (OpenCC Standard) to Hong Kong Standard 繁體(OpenCC 標準)到香港繁體(香港小學學習字詞表標準)
61
62## Development Documentation 開發文檔
63
64* http://byvoid.github.io/OpenCC/
65
66## Build 編譯
67
68### Build with CMake
69
70Linux (gcc 4.6 is required):
71
72```
73make
74sudo make install
75```
76
77Mac OS X (clang 3.2 is required):
78
79```
80make PREFIX=/usr/local
81sudo make PREFIX=/usr/local install
82```
83
84Windows MSYS:
85
86```
87cmake -H. -Bbuild -G "MSYS Makefiles" -DCMAKE_INSTALL_PREFIX="path/to/install"
88cmake --build build --config Release --target install
89```
90
91Windows Visual Studio (2013 or higher required):
92
93```
94cmake -H. -Bbuild -G"Visual Studio 12" -DCMAKE_INSTALL_PREFIX="path/to/install"
95cmake --build build --config Release --target install
96```
97
98### iOS
99
100See https://github.com/gelosie/OpenCC/tree/master/iOS
101
102### Android
103
104See [android-opencc](https://github.com/qichuan/android-opencc)
105
106## Projects using Opencc 使用OpenCC的項目
107
108* [ibus-pinyin](http://code.google.com/p/ibus/)
109* [fcitx](http://code.google.com/p/fcitx/)
110* [rimeime](http://code.google.com/p/rimeime/)
111* [libgooglepinyin](http://code.google.com/p/libgooglepinyin/)
112* [ibus-libpinyin](https://github.com/libpinyin/ibus-libpinyin)
113* [BYVBlog](https://github.com/byvoid/byvblog)
114* [豆瓣同城微信](http://weixinqiao.com/douban-event/)
115* [alfred-chinese-converter](https://github.com/amowu/alfred-chinese-converter)
116* [GoldenDict](https://github.com/goldendict/goldendict)
117
118## License 許可協議
119
120Apache License 2.0
121
122## Third Party Library 第三方庫
123
124* [darts-clone](https://code.google.com/p/darts-clone/) BSD License
125* [tclap](http://tclap.sourceforge.net/) MIT License
126* [rapidjson](https://github.com/miloyip/rapidjson) MIT License
127
128All these libraries are statically linked.
129
130## Change History 版本歷史
131
132https://github.com/BYVoid/OpenCC/blob/master/NEWS.md
133
134## Contributors 貢獻者
135
136* [BYVoid](http://www.byvoid.com/)
137* [佛振](https://github.com/lotem)
138* [Peng Huang](https://github.com/phuang)
139* [LI Daobing](https://github.com/lidaobing)
140* [Kefu Chai](https://github.com/tchaikov)
141* [Kan-Ru Chen](http://kanru.info/)
142* [Ma Xiaojun](https://twitter.com/damage3025)
143* [Jiang Jiang](http://jjgod.org/)
144* [Ruey-Cheng Chen](https://github.com/rueycheng)
145* [Paul Meng](http://home.mno2.org/)
146* [Lawrence Lau](https://github.com/ktslwy)
147* [瑾昀](https://github.com/kunki)
148* [Marguerite Su](https://www.marguerite.su/)
149* [Brian White](http://mscdex.net)
150* [Qijiang Fan](https://fqj.me/)
151* [LEOYoon-Tsaw](https://github.com/LEOYoon-Tsaw)
152* [Steven Yao](https://github.com/stevenyao)
153* [Pellaeon Lin](https://github.com/pellaeon)
154* [stony](https://github.com/stony-shixz)
155* [steelywing](https://github.com/steelywing)
156* [吕旭东](https://github.com/lvxudong)
157* [Weng Xuetian](https://github.com/wengxt)
158* [Ma Tao](https://github.com/iwater)
159* [Heinz Wiesinger](https://github.com/pprkut)
160* [J.W](https://github.com/jakwings)
161* [Amo Wu](https://github.com/amowu)
162* [Mark Tsai](https://github.com/mxgit1090)
163* [Zhe Wang](https://github.com/0x1997)
164* [sgqy](https://github.com/sgqy)
165* [Qichuan (Sean) ZHANG](https://github.com/qichuan)
166* [Flandre Scarlet](https://github.com/XadillaX)
167* [宋辰文](https://github.com/songchenwen)
168* [iwater](https://github.com/iwater)
169* [Xpol Wan](https://github.com/xpol)
170* [Weihang Lo](https://github.com/weihanglo)
171* [Cychih](https://github.com/pi314)
172* [kyleskimo](https://github.com/kyleskimo)
173* [Ryuan Choi](https://github.com/bunhere)
174
175Please update this list you have contributed OpenCC.
176