Chinese Comprehensible Input

by Dany
5
4
3
2
1
Score: 41/100

Description

Obsidian plugin that turns Chinese notes into a comprehensible-input reading environment with SRS, exposure tracking, and AI-generated review stories.

Reviews

No reviews yet.

Stats

5
stars
723
downloads
0
forks
103
days
3
days
4
days
111
total PRs
0
open PRs
13
closed PRs
98
merged PRs
23
total issues
14
open issues
9
closed issues
229
commits

Latest Version

4 days ago

Changelog

Reading-view text and annotation rows became yours to arrange. Thanks to @Olivmamman, whose request in #103 started this, and who answered the design questions that shaped it.

You choose what sits above the characters

Rows are numbered upward from the Chinese: line 2 sits directly above the characters, line 3 above that.

   line 3   English / mnemonic        (three-line mode only)
   line 2   pinyin / English / mnemonic
   line 1   你好                       always the characters

Set both under Settings → Display → Advanced display → Annotation lines. Two-line mode now lets you put the English directly above the characters instead of pinyin — previously impossible. A mnemonic can take either row, and appears only on words you have written one for. (#56)

Three text-size controls, none competing

Reader font size, Line spacing and Annotation size, all in Settings and all in the reading view's More menu, because they are things you adjust while reading rather than once during setup.

To make the Chinese bigger without enlarging the annotations: raise reader font size, then lower annotation size by roughly the same proportion. 22 → 33px is half again as large, so set annotation size to about 67%. That is why the slider reaches down to 50%.

Reader font size is deliberately the control that grows the characters, because it reaches every character in the view — a known word rendered without annotations grows exactly as much as an annotated one.

Shorter translations

An optional Shorten translations setting drops bracketed notes like "(Internet slang)" or "(Ming Dynasty)" from the inline row, keeping the full text on the word card. Measured over the full 125,008-entry CC-CEDICT: 29.3% of first definitions carry one, and removing it sheds about 20 characters — which also narrows the word, since each word is only as wide as its widest row. Off by default. (#103)


⚠️ If you tested 0.7.7-beta.2 or beta.3

Those betas had a Chinese size (%) slider. It is gone, and your characters will look smaller after updating. That is the removal, not a regression.

It only ever worked on annotated words — in a normal sentence unknown words grew and known ones did not — so it was removed rather than repaired. Raising reader font size and lowering annotation size gives the same result on all the text. Nobody on 0.7.6 or earlier is affected.

Fixes

  • Sync no longer rewrites your word knowledge. Merging records re-derived the per-axis flags from the coarse status, and that round trip is lossy for three of the eight combinations — so ticking only "Characters" on a word would untick itself on the next sync, and propagate the corrupted value to your other device. Present since 0.1.62; only ever visible with the vocabulary mirror enabled.
  • Editing a mnemonic updates the reading view immediately. Clearing one used to leave the old text above the word next to a "Mnemonic cleared." notice.
  • The … menu opens on the first tap. Closing it by tapping outside, or via Stats / Generate story, used to leave the next tap dead.
  • Both toolbar menus scroll when they are taller than the screen, instead of running off the bottom. Affects the … menu and the highlighter's Formats list.
  • Changing reader font size from Settings now applies immediately, rather than on next open.
  • Switching tokenizer engine re-segments open notes without a reload.
  • Settings that are not annotation lines no longer appear under the "Annotation lines" heading.
  • A 14th consecutive "easy" SRS review no longer overflows the scheduled date.

Docs

New sections on what goes on each line and on the three size controls, a FAQ entry for "the Chinese characters are too small", and traditional-chinese.md added to the documentation index.