A machine-discoverable table contract for data catalogs, ETL pipelines, RDF tooling and reproducible language-data workflows.
The metadata uses the standard <CSV URL>-metadata.json name and sits beside the CSV, so CSVW-aware tools can discover it directly.
The pinned command checks metadata syntax, column names, datatypes, required values, URI templates, the primary key and every row.
python3 -m pip install csvw==4.1.0 csvwvalidate https://alice51849.github.io/ios-app-guide/data/zhuyin-bopomofo-ml-dataset.csv-metadata.json
from csvw.metadata import Table
table = Table.from_file("https://alice51849.github.io/ios-app-guide/data/zhuyin-bopomofo-ml-dataset.csv-metadata.json")
rows = list(table)
assert len(rows) == 37| Column | Datatype | Meaning | RDF property |
|---|---|---|---|
order | integer (minimum=1, maximum=37) | Stable educational display order from 1 through 37. | http://schema.org/position |
symbol_id | string (format=^u31(?:0[5-9A-F]|1[0-9A-F]|2[0-9])$) | ASCII identifier derived from the uppercase Unicode code point. | http://purl.org/dc/terms/identifier |
concept_uri | anyURI | Stable IRI for the corresponding SKOS concept. | suppressed |
symbol | string (length=1) | One Bopomofo character. | http://www.w3.org/2004/02/skos/core#prefLabel |
unicode | string (format=^U\+31(?:0[5-9A-F]|1[0-9A-F]|2[0-9])$) | Unicode notation in U+XXXX form. | http://www.w3.org/2004/02/skos/core#notation |
pinyin | string | Hanyu Pinyin correspondence. | https://alice51849.github.io/ios-app-guide/data/zhuyin-bopomofo-vocabulary.html#pinyin |
ipa | string | Broad IPA transcription without brackets. | https://alice51849.github.io/ios-app-guide/data/zhuyin-bopomofo-vocabulary.html#ipa |
category | string (format=^(initial|medial|final)$) | One of initial, medial or final. | http://schema.org/category |
category_uri | anyURI | IRI for the broader SKOS category concept. | http://www.w3.org/2004/02/skos/core#broader |
example_character | string (length=1) | Traditional Chinese example character. | https://alice51849.github.io/ios-app-guide/data/zhuyin-bopomofo-vocabulary.html#exampleCharacter |
example_pinyin | string | Tone-marked Hanyu Pinyin for the example. | https://alice51849.github.io/ios-app-guide/data/zhuyin-bopomofo-vocabulary.html#examplePinyin |
example_meaning_en | string | Short English meaning for the example. | https://alice51849.github.io/ios-app-guide/data/zhuyin-bopomofo-vocabulary.html#exampleMeaning |
| Order | Symbol | Category | Pinyin | IPA | Example |
|---|---|---|---|---|---|
| 1 | ㄅ | initial | b | p | 爸 (bà) |
| 2 | ㄆ | initial | p | pʰ | 怕 (pà) |
| 3 | ㄇ | initial | m | m | 媽 (mā) |
| 4 | ㄈ | initial | f | f | 飛 (fēi) |
| 5 | ㄉ | initial | d | t | 大 (dà) |
| 6 | ㄊ | initial | t | tʰ | 天 (tiān) |
| 7 | ㄋ | initial | n | n | 你 (nǐ) |
| 8 | ㄌ | initial | l | l | 來 (lái) |
| 9 | ㄍ | initial | g | k | 狗 (gǒu) |
| 10 | ㄎ | initial | k | kʰ | 看 (kàn) |
| 11 | ㄏ | initial | h | x | 好 (hǎo) |
| 12 | ㄐ | initial | j | tɕ | 家 (jiā) |
| 13 | ㄑ | initial | q | tɕʰ | 去 (qù) |
| 14 | ㄒ | initial | x | ɕ | 小 (xiǎo) |
| 15 | ㄓ | initial | zh | ʈʂ | 中 (zhōng) |
| 16 | ㄔ | initial | ch | ʈʂʰ | 吃 (chī) |
| 17 | ㄕ | initial | sh | ʂ | 是 (shì) |
| 18 | ㄖ | initial | r | ʐ | 人 (rén) |
| 19 | ㄗ | initial | z | ts | 早 (zǎo) |
| 20 | ㄘ | initial | c | tsʰ | 菜 (cài) |
| 21 | ㄙ | initial | s | s | 三 (sān) |
| 22 | ㄧ | medial | i / yi | i | 一 (yī) |
| 23 | ㄨ | medial | u / wu | u | 五 (wǔ) |
| 24 | ㄩ | medial | ü / yu | y | 魚 (yú) |
| 25 | ㄚ | final | a | a | 大 (dà) |
| 26 | ㄛ | final | o | ɔ | 波 (bō) |
| 27 | ㄜ | final | e | ɤ | 喝 (hē) |
| 28 | ㄝ | final | ê | ɛ | 誒 (ề) |
| 29 | ㄞ | final | ai | ai | 愛 (ài) |
| 30 | ㄟ | final | ei | ei | 給 (gěi) |
| 31 | ㄠ | final | ao | au | 好 (hǎo) |
| 32 | ㄡ | final | ou | ou | 有 (yǒu) |
| 33 | ㄢ | final | an | an | 安 (ān) |
| 34 | ㄣ | final | en | ən | 恩 (ēn) |
| 35 | ㄤ | final | ang | aŋ | 忙 (máng) |
| 36 | ㄥ | final | eng | əŋ | 冷 (lěng) |
| 37 | ㄦ | final | er | ɚ | 二 (èr) |
The metadata targets the immutable 17 December 2015 W3C Recommendations. Offline context and vocabulary snapshots are hash-pinned for deterministic validation.
The table is reusable under CC BY 4.0 with attribution to Lumi Apps. W3C snapshots retain their own W3C terms.
CC BY 4.0Lumi Bopomofo offers a separate on-device way to practise the symbols. The CSVW table remains open, independent and usable without the app.
View Lumi Bopomofo on the App Store