// the find
sofish/han
a module for tanslating Chinese(汉字) into /\w+/ or pinyin
Han translates Chinese characters to pinyin romanization or plain ASCII letters, with optional tone marks. It's a utility library for anyone building URLs, slugs, or search indexes from Chinese text. Last touched in 2018.
Handles mixed input cleanly — Chinese, Latin, and symbols in one string without choking. Returns multiple pronunciations per character (homographs), which is the correct behavior for polyphonic characters. Sync and async calling conventions coexist without awkwardness. Reasonable test coverage with a Makefile that actually runs them.
Dead project — no commits since 2018, Travis CI badge is broken, and the npm package may not be maintained against current Node versions. No support for Traditional Chinese, so it's Simplified-only without documentation saying so. The polyphonic character handling punts disambiguation entirely to the caller — there's no context-aware selection, so automated slug generation will silently pick wrong readings. No TypeScript types, which matters if you're using this in a modern TS project.