Hanconv converts between Chinese characters variants base on OpenCC's dictionaries and conversion rules. It provides efficient conversion between Simplified Chinese and Traditional Chinese both as a command-line tool and as a library for integration into other projects.

cargo install hanconv

go install github.com/fhluo/hanconv/go/cmd/hanconv@latest

• Display the help message:

  hanconv --help

• Convert a text file from Simplified to Traditional Chinese:

  hanconv s2t -i input.txt -o output.txt

• Convert a text file from Traditional to Simplified Chinese:

  hanconv t2s -i input.txt -o output.txt

• Convert text directly from command line:

  hanconv s2t "简繁转换"

• Read from stdin and write to stdout:

  cat input.txt | hanconv s2t > output.txt

• For files with non-UTF-8 encodings, specify the encoding:

  # Same encoding for input and output
  hanconv t2s -i input.txt -o output.txt --encoding GBK
  
  # Different encodings for input and output
  hanconv t2s -i input.txt -o output.txt --input-encoding GBK --output-encoding UTF-8

1. Add hanconv as a dependency in your Cargo.toml.

   [dependencies]
   hanconv = "0.4"

2. Use the provided conversion functions in your project.

   fn main() {
       let result = hanconv::s2t("简繁转换");
       println!("{}", result);
   }

3. Available conversion functions:

   • s2t: Simplified Chinese → Traditional Chinese
   • t2s: Traditional Chinese → Simplified Chinese
   • s2tw: Simplified Chinese → Traditional Chinese (Taiwan)
   • tw2s: Traditional Chinese (Taiwan) → Simplified Chinese
   • s2twp: Simplified Chinese → Traditional Chinese (Taiwan) with Taiwanese idiom
   • tw2sp: Traditional Chinese (Taiwan) → Simplified Chinese with Mainland Chinese idiom
   • t2tw: Traditional Chinese → Traditional Chinese (Taiwan)
   • tw2t: Traditional Chinese (Taiwan) → Traditional Chinese
   • s2hk: Simplified Chinese → Traditional Chinese (Hong Kong)
   • hk2s: Traditional Chinese (Hong Kong) → Simplified Chinese
   • t2hk: Traditional Chinese → Traditional Chinese (Hong Kong)
   • hk2t: Traditional Chinese (Hong Kong) → Traditional Chinese
   • t2jp: Traditional Chinese characters (Kyūjitai) → New Japanese Kanji (Shinjitai)
   • jp2t: New Japanese Kanji (Shinjitai) → Traditional Chinese characters (Kyūjitai)

1. Add hanconv to your Go project:

   go get github.com/fhluo/hanconv/go

2. Import and use the conversion functions in your project:

   import hanconv "github.com/fhluo/hanconv/go"
   
   func main() {
       result := hanconv.S2T("简繁转换")
       fmt.Println(result)
   }