summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pxcjkcat/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/pxcjkcat/README')
-rw-r--r--Master/texmf-dist/doc/latex/pxcjkcat/README63
1 files changed, 63 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/pxcjkcat/README b/Master/texmf-dist/doc/latex/pxcjkcat/README
new file mode 100644
index 00000000000..f0f1927ebd9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pxcjkcat/README
@@ -0,0 +1,63 @@
+PXcjkcat package
+
+A LaTeX package to provide LaTeX interface for manipulating the
+CJK category code ('kcatcode') table of upTeX, which determines the
+behavior of Unicode (non-ASCII) characters in source files.
+
+1. Overview
+
+The upTeX engine is an extention to the TeX engine and is developed by
+Takuji TANAKA since 2007. This extension mainly aims in providing
+better Unicode support to the pTeX engine, which has long been the
+de facto standard of the TeX engine in Japan. The upTeX engine inherits
+the basic architecture of pTeX, and only Japanese processing (which is
+already on multi-byte basis in pTeX) is lift to the full Unicode range,
+and non-Japanese processing remains on 8-bit basis (just like tra
+original TeX engine). Thus one can typeset UTF-8 encoded documents that
+contain all kinds of Unicode letters with use of upTeX accompanied with
+the standard techniques for handling UTF-8 letters in the traditional
+8-bit TeX engines (such as pdfTeX). The advantage of upTeX is the
+ability of high-quality Japanese typesetting, which is fully inherited
+from pTeX and is still lacking or at least on development in modern
+Unicode-aware engines such as XeTeX and LuaTeX.
+
+Since upTeX could treat all the Unicode letters either as non-CJK or
+CJK letter, it has the mechanism (called "kcatcode table") for
+specifying which letters should be treated as CJK. The pxcjkcat package
+provides a concise and user-friendly LaTeX interface to the mechanism.
+
+2. Installation
+
+In the distribution in conformance with TDS 1.1:
+
+ - *.sty -> $TEXMF/tex/platex/PXcjkcat/
+
+3. (Very) Basic Usage
+
+Unfortunately the full-fledged manual comes only in Japanese. Here
+the most basic usage is described.
+
+If your document is mainly in English (or some other Western language)
+and has sporadic occurrences of Japanese words/phrases, then put the
+following lines in the preamble:
+
+ \usepackage[prefernoncjk]{pxcjkcat}
+ \usepackage[utf8]{inputenc} % or utf8x if needed
+
+If your document is mainly in Japanese, then put the following lines
+in the preamble:
+
+ \usepackage[prefercjkvar]{pxcjkcat}
+ \usepackage[utf8]{inputenc} % or utf8x if needed
+
+The former setting treats the "CJK-ambiguous" punctuation symbols as
+non-CJK letters, while the latter as CJK letters. Of course, your
+document must in encoded in UTF-8.
+
+4. License
+
+This package is distributed under the MIT License. See the file LICENSE
+for more detail.
+
+----------------------------------------
+Takayuki YATO (aka. "ZR") <zrbabbler@yahoo.co.jp>