tidycjk: Tidy Tools for Chinese, Japanese and Korean Text

A tidy toolkit for text that is written in Chinese, Japanese or Korean. Most text tooling in R assumes that words are separated by whitespace, which CJK writing does not use, so ordinary summaries of a text column either treat a sentence as one undifferentiated blob or split it into isolated characters. Word segmentation is a pluggable engine, with dictionary-based segmentation for Chinese and Japanese supplied through 'ICU' and further engines registrable by the caller, because where a word ends is a fact about a language and not about Unicode. 'tidycjk' classifies characters by Unicode block, reports which script and which language a text is written in, measures how much of a text is CJK, and turns those measurements into tibbles that slot straight into a 'tidyverse' workflow. It also measures display width in terminal columns, pads, truncates and wraps to a width rather than to a character count, and normalises fullwidth and halfwidth forms surgically – including composing halfwidth katakana voiced marks into single code points – while offering the Unicode normalisation forms separately for when a full 'NFKC' fold is what is wanted. Romanisation, conversion between simplified and traditional Han, conversion between the two kana syllabaries, and decomposition of Hangul syllables into jamo are provided on the same vectorised contract. Sentence segmentation, character n-grams, punctuation removal by Unicode category and locale-aware ordering cover the preprocessing that generic tooling gets wrong on CJK, where the sentence terminators are ideographic, a code point sort is not an alphabetical one, and the POSIX punctuation class is resolved by the C library rather than by Unicode. Language detection deliberately returns NA rather than guessing when a text is written in Han characters only, because Japanese written without kana cannot be distinguished from Chinese by script alone. Everything is derived from the Unicode specification; the package makes no network requests and needs no compiled code of its own.

Version: 0.2.0
Depends: R (≥ 3.5.0)
Imports: dplyr (≥ 1.1.0), stringi, tibble, utils
Suggests: knitr, rmarkdown, testthat (≥ 3.0.0)
Published: 2026-10-11
DOI: 10.32614/CRAN.package.tidycjk
Author: Youzhi Yu [aut, cre]
Maintainer: Youzhi Yu <yuyouzhi666 at icloud.com>
BugReports: https://github.com/PursuitOfDataScience/tidycjk/issues
License: GPL (≥ 3)
URL: https://pursuitofdatascience.github.io/tidycjk/, https://github.com/PursuitOfDataScience/tidycjk
NeedsCompilation: no
Language: en-GB
Materials: README, NEWS
CRAN checks: tidycjk results

Documentation:

Reference manual: tidycjk.html , tidycjk.pdf
Vignettes: Segmenting CJK text (source, R code)
Introduction to tidycjk (source, R code)
Romanisation, script conversion and kana (source, R code)
Width, padding, truncation and wrapping (source, R code)

Downloads:

Package source: tidycjk_0.2.0.tar.gz
Windows binaries: r-devel: tidycjk_0.1.0.zip, r-release: tidycjk_0.1.0.zip, r-oldrel: tidycjk_0.2.0.zip
macOS binaries: r-release (arm64): tidycjk_0.2.0.tgz, r-oldrel (arm64): tidycjk_0.2.0.tgz, r-release (x86_64): tidycjk_0.2.0.tgz, r-oldrel (x86_64): tidycjk_0.2.0.tgz
Old sources: tidycjk archive

Linking:

Please use the canonical form https://CRAN.R-project.org/package=tidycjk to link to this page.