1. Forum
  2. USENET
  3. comp.text.tex

  • CTAN update: xpinyin

    From CTAN Announcements via ctan-ann@erik@ctan.org to ctan-ann on Wed Sep 30 16:54:34 2026
    From Newsgroup: comp.text.tex

    Liam Huang submitted an update to the

    xpinyin

    package.

    Version: 3.2 2026-09-27
    License: lppl1.3c

    Summary description: Automatically add pinyin to Chinese characters

    Announcement text: --------------------------------------------------------------------------------

    xpinyin v3.2 brings new commands for querying pinyin data, broader input support, updated Unicode data, and several bug fixes.

    NEW FEATURES

    - `\disablepinyin` now has a starred form that also covers the `\xpinyin` command itself. (#265)
    - Four new commands `\xpinyinvalue`, `\xpinyininitial`, `\xpinyinshengmu`, and `\xpinyinyunmu` for querying the pronunciation of individual characters, useful
    for Chinese index grouping and sorting; the data table is loaded on demand via the `query` option. (#550)
    - Pinyin arguments now accept `|+`/`|L` directly, equivalent to the existing `v`/`V` notation. Previously `\pinyin{n|+3}` produced the literal text `n|+3` under XeTeX, and caused an error under pdfTeX with `CJKutf8`. (#1069)

    BUG FIXES

    - When xeCJK's `AutoFallBack` has switched to a fallback font, the box used for
    width measurement no longer reselects the main font, fixing ruby text being compressed to an incorrect width. (#997)
    - `\setpinyin` now also updates the query table for characters not in the built-in database; previously only the ruby table was updated while `\xpinyinvalue` still reported "no pronunciation". (PR #1051)
    - `\setpinyin` now strips the trailing `5` (neutral tone marker) when storing to
    the query table, consistent with the convention that the query table omits the digit for neutral tone; previously the `none` form returned `shi5` instead of `shi`. (PR #1051)

    OTHER CHANGES

    - Pinyin data updated to Unicode 18.0 Unihan (v3.1 used 14.0), adding pronunciations for about 3,000 more characters; the preferred reading of about 300 characters has changed accordingly, mostly corrections to the current standard pronunciation, e.g. "t+-" changed from `j-2` to `j|4`. The characters "o!E", "oCa", "ooe", "ooa", and "ooc" retain their original neutral-tone readings.
    Use `\setpinyin` to override when needed.
    - Added standalone regression tests and integrated version-consistency checks for tag-based release builds. This only affects the test and release workflow, not the package behavior.

    Source code: https://github.com/CTeX-org/ctex-kit
    Issue tracker: https://github.com/CTeX-org/ctex-kit/issues

    --------------------------------------------------------------------------------

    This package is located at
    https://mirrors.ctan.org/macros/latex/contrib/xpinyin

    More information is at
    https://ctan.org/pkg/xpinyin


    --------------------------------------------------------------------------------

    Thanks for the upload.

    For the CTAN Team
    Erik Braun


    CTAN is run entirely by volunteers and supported by TeX user groups.
    Please join a user group or donate to one, see https://ctan.org/lugs .
    --- Synchronet 3.22a-Linux NewsLink 1.2