CTAN Comprehensive TeX Archive Network

Directory macros/latex/contrib/pxcjkcat

README.md

PXcjkcat Package

: interface for the CJK category codes of up

The package provides management of the CJK category code (‘kcatcode’) table of the up extended engine.

Package options are available for tailored use in the cases of documents that are principally written in Japanese, or principally written in English or other Western languages.

System Requirements

  • format: .
    • engine: up, p-ng.
    • DVI-ware: Anything.

Installation

In the distribution in conformance with TDS 1.1:

  • *.sty → $TEXMF/tex/platex/PXcjkcat

License

This package is distributed under the MIT License.

The pxcjkcat Package ー main

Please refer to the manual pxcjkcat.pdf (in Japanese) for detail.

Below is described the most basic use.

Overview

The up engine is an extention to the engine and is developed by Takuji TANAKA since 2007. This extension mainly aims in providing better Unicode support to the p engine, which has long been the de facto standard of the engine in Japan. The up engine inherits the basic architecture of p, and only Japanese processing (which is already on multi-byte basis in p) is lift to the full Unicode range, and non-Japanese processing remains on 8-bit basis (just like the original engine). Thus one can typeset UTF-8 encoded documents that contain all kinds of Unicode letters with use of up accompanied with the standard techniques for handling UTF-8 letters in the traditional 8-bit engines (such as pdf).

Since up could treat all the Unicode letters either as non-CJK or CJK letter, it has the mechanism (called “CJK category table”) for specifying which letters should be treated as CJK. The pxcjkcat package provides a concise and user-friendly interface to the mechanism.

Basic Usage

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:

usepackageprefernoncjk{pxcjkcat} usepackageutf8{inputenc}

If your document is mainly in Japanese, then put the following lines in the preamble:

usepackageprefercjkvar{pxcjkcat} usepackageutf8{inputenc}

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.

A Sample Document

% upLaTeX; UTF-8
\documentclass[a4paper]{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[prefernoncjk]{pxcjkcat}
\usepackage[french]{babel}
\begin{document}
\emph{Je suis un chat} (吾輩は猫である) est un roman japonais
écrit par Sōseki Natsume (夏目漱石) de 1905 à 1906
dans la revue littéraire \emph{Hototogisu} (ホトトギス).
\end{document}

Revision History

  • Version 1.1 〈2018/04/01〉
    • Version 1.0 〈2012/09/22〉

Takayuki YATO (aka. "ZR") https://github.com/zr-tex8r

Download the contents of this package in one zip archive (199.9k).

pxcjkcat – interface for the CJK category codes of up

The package provides management of the CJK category code (‘kcatcode’> table of the up extended engine.

Package options are available for tailored use in the cases of documents that are principally written in Japanese, or principally written in English or other Western languages.

Packagepxcjkcat
Version1.1
LicensesMIT License
Copyright2012,2018 Takayuki YATO
MaintainerTakayuki Yato
Contained inTeX Live as pxcjkcat
MiKTeX as pxcjkcat
TopicsJapanese
Multi-lingual
...
Guest Book Sitemap Contact Contact Author