diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/xcjk2uni/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/xcjk2uni/README | 80 |
1 files changed, 80 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/xcjk2uni/README b/Master/texmf-dist/doc/latex/xcjk2uni/README new file mode 100644 index 00000000000..7e044598085 --- /dev/null +++ b/Master/texmf-dist/doc/latex/xcjk2uni/README @@ -0,0 +1,80 @@ +Introduction +------------ +The `xCJK2uni` package provides commands to convert CJK character to Unicode in +non-UTF-8 encoding. It provides hooks for `hyperref` to get the correct bookmarks. +It also provides some /ToUnicode mapping file for CJK subfont. They can be used +with `cmap` package and make CJK character searchable and copyable in PDF files +generated by pdfLaTeX. + +It may be distributed and/or modified under the conditions of the +LaTeX Project Public License (LPPL), either version 1.3c of this license or +(at your option) any later version. The latest version of this license is in + + http://www.latex-project.org/lppl.txt + +and version 1.3 or later is part of all distributions of LaTeX version +2005/12/01 or later. + +This work has the LPPL maintenance status "maintained". +The Current Maintainer of this work is Qing Lee. + +This work consists of the file xCJK2uni.dtx, + and the derived files xCJK2uni.pdf, + xCJK2uni.sty, + xCJK2uni.ins, + xCJK2uni-make.ltx, + xCJK2uni-UBg5plus.def, + xCJK2uni-UBig5.def, + xCJK2uni-UGB.def, + xCJK2uni-UGBK.def, + xCJK2uni-UJIS.def, + xCJK2uni-UKS.def, + c****.cmap, and + README (this file). + +Basic Usage +----------- +The package provides the following macros: + + \useCJKencmap{<encoding>} + Set the current encoding. The default encoding is GBK. + + \CJKchartouni{<character>} + Convert a single CJK character to its Unicode. + It requires two steps of expansion. + + \CJKsfdtouni{<plane>}{<slot>} + Convert the .sfd coordinate to its Unicode. + It requires two steps of expansion. + +You can read the package manual (in Chinese) for more detailed explanations. + +Author +------ +Qing Lee +Email: sobenlee@gmail.com + +If you are interested in the process of development you may observe + + http://code.google.com/p/ctex-kit/ + +Installation +------------ +The package is supplied in dtx format and as a pre-extracted zip file, +xCJK2uni.tds.zip. The later is most convenient for most users: simply +unzip this in your local texmf directory and run texhash to update the +database of file locations. If you want to unpack the dtx yourself, +running "xetex xCJK2uni.dtx" will extract the package whereas +"xelatex xCJK2uni.dtx" will typeset the documentation. +You should copy "UBg5plus.sfd", "UBig5.sfd", "UGB.sfd", "UGBK.sfd", +"UJIS.sfd", and "UKS.sfd" from main texmf directory to current directory. +Then run "latex xCJK2uni-make.ltx" to generate some definition files and +/ToUnicode mapping files. + +The package requires LaTeX3 support as provided in the l3kernel. +It is available on CTAN as ready-to-install zip files. +Suitable versions are available in the latest version of MiKTeX and TeX Live +(updating the relevant packages online may be necessary). + +To compile the documentation without error, you will need the xeCJK package +and some specific Chinese Simplified fonts. |