UNICOPEDIA SINICA

Unicopedia Sinica is a developer-oriented set of Unicode utilities related to ideographs, wrapped into one single app, built with Electron.

This desktop application works on macOS, Linux and Windows operating systems.

Utilities

The following utilities are currently available:

CJK Components
- Look Up IDS
- Parse IDS
- Match IDS
- Find by Components
CJK Sources
JavaScript Runner

CJK Components

Look Up IDS

The Look Up IDS feature of the CJK Components utility displays all the IDS (Ideographic Description Sequences) of a given Unihan character, as compiled in the freely available IDS.TXT data file, maintained by Andrew West.
Any Unihan character can be entered in the Unihan input field either as a character or a code point. Click on the Look Up button to display the IDS.
Previously looked up characters are kept in a history stack; use the Alt+↑ and Alt+↓ keyboard shortcuts to navigate through them up and down inside the input field. Alternatively, you can also use the Lookup History ▾ pop-up menu to automatically look up a specific character.
Click on the Show Graphs checkbox to display the IDS as graphs instead of text strings.
IDS are provided for the set of 92,865 Unihan characters (excluding CJK compatibility ideographs) defined in Unicode 14.0.
Notes:
- Unencoded components of IDS, if any, are assigned code points belonging to the PUA (Private Use Area) block, and are properly displayed by using an embedded copy of the custom font BabelStone Han PUA, created by Andrew West.
- For best display results, most recent versions of the following fonts should be downloaded and installed at the OS level:
  - BabelStone Han (BabelStoneHan.ttf)
  - TH-Tshyn (TH-Tshyn-P0.ttf, TH-Tshyn-P1.ttf, TH-Tshyn-P2.ttf, TH-Tshyn-P16.ttf)
- The IDS are based on the reference character glyphs shown in their respective Unicode 14.0 code charts:

Parse IDS

The Parse IDS feature of the CJK Components utility displays the parsing graph of any well-formed IDS (Ideographic Description Sequence).
The IDS string can by directly typed, or pasted from the clipboard into the IDS input field.
Optionally, a Unihan character can be used as reference in the Entry input field.
It is possible to input predefined sets of Entry and IDS strings selected from the Samples ▾ pop-up menu.
As a convenience, the input fields can be emptied using the Clear button.
The IDS graph can be displayed either vertically or horizontally. Use the Display Mode drop-down menu to toggle between the two modes.
Notes:
- Unencoded components of IDS, if any, are assigned code points belonging to the PUA (Private Use Area) block, and are properly displayed by using an embedded copy of the custom font BabelStone Han PUA, created by Andrew West.
- For best display results, most recent versions of the following fonts should be downloaded and installed at the OS level:
  - BabelStone Han (BabelStoneHan.ttf)
  - TH-Tshyn (TH-Tshyn-P0.ttf, TH-Tshyn-P1.ttf, TH-Tshyn-P2.ttf, TH-Tshyn-P16.ttf)
- The IDS are based on the reference character glyphs shown in their respective Unicode 14.0 code charts:

Match IDS

The Match IDS feature of the CJK Components utility displays a list of IDS-matching Unihan characters, including through regular expressions. It makes use of the IDS (Ideographic Description Sequences) defined in the IDS.TXT data file, maintained by Andrew West.
After entering a query, click on the Search button to display a list of all relevant matches, if any, ordered by code point value.
Click on the Nested Match toggle button to extend the search to IDS-nested characters whose IDS match the query string.
Click on the Code Points checkbox to display the code point under each matching Unihan character.
It is possible to choose how many characters are shown one page at a time.
The search is performed on the set of 92,865 Unihan characters (excluding CJK compatibility ideographs) defined in Unicode 14.0.
The results may include the searched component itself when it happens to be a proper Unihan character too.
Use the Results ▾ pop-up menu to perform an action among:
- Copy Results [copy the results as string to the clipboard]
- Save Results.. [save the results as string to a text file]
- Clear Results [clear the current list of results]
Various examples of regular expressions are provided for quick copy-and-paste.
Notes:
- Unencoded components of IDS, if any, are assigned code points belonging to the PUA (Private Use Area) block, and are properly displayed by using an embedded copy of the custom font BabelStone Han PUA, created by Andrew West.
- For best display results, most recent versions of the following fonts should be downloaded and installed at the OS level:
  - BabelStone Han (BabelStoneHan.ttf)
  - TH-Tshyn (TH-Tshyn-P0.ttf, TH-Tshyn-P1.ttf, TH-Tshyn-P2.ttf, TH-Tshyn-P16.ttf)
- The IDS are based on the reference character glyphs shown in their respective Unicode 14.0 code charts:

Find by Components

The Find by Components feature of the CJK Components utility displays a list of Unihan characters matching a set of individual components. It makes use of the IDS (Ideographic Description Sequences) defined in the IDS.TXT data file, maintained by Andrew West.
After entering a query, click on the Search button to display a list of all relevant matches, if any, ordered by code point value.
Click on the Code Points checkbox to display the code point under each matching Unihan character.
It is possible to choose how many characters are shown one page at a time.
The search is performed on the set of 92,865 Unihan characters (excluding CJK compatibility ideographs) defined in Unicode 14.0.
Use the Results ▾ pop-up menu to perform an action among:
- Copy Results [copy the results as string to the clipboard]
- Save Results.. [save the results as string to a text file]
- Clear Results [clear the current list of results]
Notes:
- Unencoded components of IDS, if any, are assigned code points belonging to the PUA (Private Use Area) block, and are properly displayed by using an embedded copy of the custom font BabelStone Han PUA, created by Andrew West.
- For best display results, most recent versions of the following fonts should be downloaded and installed at the OS level:
  - BabelStone Han (BabelStoneHan.ttf)
  - TH-Tshyn (TH-Tshyn-P0.ttf, TH-Tshyn-P1.ttf, TH-Tshyn-P2.ttf, TH-Tshyn-P16.ttf)
- The IDS are based on the reference character glyphs shown in their respective Unicode 14.0 code charts:

CJK Sources

The CJK Sources utility displays in a grid fashion the various sources of a given set of CJK (Chinese/Japanese/Korean) characters, as referenced in their respective Unicode 14.0 code charts:
This is especially useful for comparison purposes between relatable character glyphs.
For best display results, most recent versions of the following fonts should be downloaded and installed at the OS level:
- BabelStone Han (BabelStoneHan.ttf)
- TH-Tshyn (TH-Tshyn-P0.ttf, TH-Tshyn-P1.ttf, TH-Tshyn-P2.ttf, TH-Tshyn-P16.ttf)
CJK characters can be entered either directly in the "Characters" input field, or using a series of code points in hexadecimal format in the "Code points" input field.
It is also possible to input predefined strings of CJK characters selected from the Samples ▾ pop-up menu.
As a convenience, the input fields can be emptied using the Clear button. In output, the standard Unicode code point format U+9999 is used, i.e. "U+" directly followed by 4 or 5 hex digits.
In input, more hexadecimal formats are allowed, including Unicode escape sequences, such as \u6E7E or \u{21FE7}. Moving out of the field or typing the Enter key converts all valid codes to standard Unicode code point format.
Code point and alphanumeric source references of CJK compatibility characters are systematically displayed in italics.

Whereas the original code charts are making use of mutually incompatible, block-specific source orderings, this utility displays the relevant sources always sorted in the same order, discarding any empty column for the sake of clarity:

Prefix	Source	Unihan Property
G	China	kIRG_GSource
H	Hong Kong	kIRG_HSource
M	Macao	kIRG_MSource
T	Taiwan	kIRG_TSource
J	Japan	kIRG_JSource
K	South Korea	kIRG_KSource
KP	North Korea	kIRG_KPSource
V	Vietnam	kIRG_VSource
UTC	UTC	kIRG_USource
SAT	SAT	kIRG_SSource
UK	U.K.	kIRG_UKSource

A table of glyphs statistics is available for quick reference.

JavaScript Runner

The JavaScript Runner utility lets you execute JavaScript code, and comes with several sample scripts related to CJK and IDS; it is useful for quick testing/prototyping or data processing.

Using

You can download the latest release for macOS.

Building

You'll need Node.js (which comes with npm) installed on your computer in order to build this application.

Clone method

# Clone the repository
git clone https://github.com/tonton-pixel/unicopedia-sinica
# Go into the repository
cd unicopedia-sinica
# Install dependencies
npm install
# Run the application
npm start

Note: to use the clone method, the core tool git must also be installed.

Download method

If you don't wish to clone, you can download the source code, unZip it, then directly run the following commands from a Terminal opened at the resulting unicopedia-sinica-master folder location:

# Install dependencies
npm install
# Run the application
npm start

Packaging

Several scripts are also defined in the package.json file to build OS-specific bundles of the application, using the simple yet powerful Electron Packager Node module.
For instance, running the following command (once the dependencies are installed) will create a Unicopedia Sinica.app version for macOS:

# Build macOS (Darwin) application
npm run build-darwin

License

The MIT License (MIT).

Key	Action
`/`	Focus the search bar
`Esc`	Focus the search bar and cleans it
`↓`	Select the next search result
`↑`	Select the previous search result
`Enter`	Open the selected search result
`cmdEnter`	`Ctrl`+`Enter`	Open the selected search result in a new tab

Unicopedia Sinica

Set of Unicode utilities related to ideographs, wrapped into one single app.

Website

Category

Downloads (v1.4.2)

Keywords

License

Latest Release

UNICOPEDIA SINICA

Utilities

CJK Components

Look Up IDS

Parse IDS

Match IDS

Find by Components

CJK Sources

JavaScript Runner

Using

Building

Clone method

Download method

Packaging

License

Keyboard Shortcuts