Usage¶
1. To use lotecc
in terminal¶
$ lotecc
Above command is equal to $ lotecc -c s2t -i . --ignore .gitignore
. Which convert all files in current directory and subdirectories from Simplified Chinese to Traditional Chinese, excluding files matching the pattern in .gitignore
:
-c s2t
: conversion is Simplified Chinese to Traditional Chinese-i .
: input is current directory--ignore .gitignore
: files excluding files matching the pattern in.gitignore
2. To use lotecc
in a project¶
from lotecc import lote_chinese_conversion as lotecc
converted = lotecc(conversion='s2t',
input='.',
output=None,
in_enc='utf-8',
out_enc='utf-8',
suffix=None,
ignore='.gitignore')
for source, output in converted:
print(f'The source file <{source}> has been '
f'converted into <{output}>.')
You can get helps by type $ lotecc --help
in terminal:
Options:
-c, --conversion TEXT Conversion method between Simplified Chinese and
Traditional Chinese. [default: s2t]
-i, --input TEXT Input file or directory. The default is current dir.
-o, --output TEXT Output file or directory. The default is the same as
the source file, which means that the source file
will be overwritten.
-q, --quiet Disable screen output. [default: False]
--ignore TEXT Can be a .gitignore syntax file. Also can be one or
more patterns, separated by commas. [default:
.gitignore]
--suffix TEXT Suffix of output filename, add this to keep both the
source file and converted file.
--in-enc TEXT Encoding for input. [default: utf-8]
--out-enc TEXT Encoding for output. [default: utf-8]
--help Show this message and exit.
3. Supported conversions¶
hk2s
: Traditional Chinese (Hong Kong standard) to Simplified Chineses2hk
: Simplified Chinese to Traditional Chinese (Hong Kong standard)s2t
: Simplified Chinese to Traditional Chineses2tw
: Simplified Chinese to Traditional Chinese (Taiwan standard)s2twp
: Simplified Chinese to Traditional Chinese (Taiwan standard, with phrases)t2hk
: Traditional Chinese to Traditional Chinese (Hong Kong standard)t2s
: Traditional Chinese to Simplified Chineset2tw
: Traditional Chinese to Traditional Chinese (Taiwan standard)tw2s
: Traditional Chinese (Taiwan standard) to Simplified Chinesetw2sp
: Traditional Chinese (Taiwan standard) to Simplified Chinese (with phrases)