Hanzi Web for Anki

This addon generates a “web” of hanzi/kanji amongst your Anki notes, adding a few examples taken from cards you’ve already reviewed for each hanzi in each note. The intent is that you’ll be able to more easily learn the readings of hanzi if you are reminded of other words it comprises that you’ve already studied.

Installation

You may install this from its Anki Web page. You may alternatively download it from the GitHub releases page, then install in Anki via Tools -> Add-ons -> Install from file…

Configuration

Note that Hanzi Web has changed significantly from v0.1.2 to v1.0.0. If you are getting nagged that your config is out of date, please re-read this section and then update your config_version to 1.

You can configure Hanzi Web through Anki after installing via Tools -> Add-ons -> Hanzi Web -> Config. See config.md.

You may want to also configure the CSS of your notes, as Hanzi Web does no styling by default. It instead exposes the following CSS classes:

• .hanziweb, applied to the whole <table>.
• .hanziweb-hanzi, which is the hanzi for which terms are listed (the left side of the screenshot shown above).
• .hanziweb-kind, which is applied to the <td> for the indicator for the "kind" of row. This is 聲 for Chinese phonetic series (as in 諧聲) and 音 for Japanese on'yomi readings (as in 音読). For the row containing the hanzi itself, this is blank.
• .hanziweb-terms, .hanziweb-phonetic-series, and .hanziweb-onyomi, which is applied to the <td> for the list of terms for each of the corresponding categories. This is the right-hand side of the table.

The styling in the above screenshot was achieved with the following CSS. You may copy it into your note type’s CSS if you wish.

.hanziweb {
  margin: 10px auto;
  max-width: 400px;
  border-style: solid;
  border-color: gray;
  border-width: 1px;
  border-collapse: collapse;
}

.hanziweb td {
  border-style: solid;
  border-color: gray;
  border-width: 1px;
  padding: 5px;
}

.hanziweb-hanzi {
  font-family: IPAMincho, serif;
  text-align: center;
  font-size: 30px;
  margin: 5px;
}

.hanziweb-kind {
  font-size: 20px;
  text-align: right;
}

.hanziweb-terms {
  font-size: 20px;
  text-align: left;
  word-break: keep-all;
}

.hanziweb-phonetic-series,
.hanziweb-onyomi {
  color: gray;
  word-break: keep-all;
}

You can specify display: none; on .hanziweb-phonetic-series or .hanziweb-onyomi if you don’t wish to see either. For example, to disable displaying on’yomi:

.hanziweb-onyomi {
  display: none;
}

Chinese notes vs. Japanese notes

Notes can be configured to be recognized as either Chinese or Japanese by adjusting the japanese_search_query option. There are subtle differences to each.

Chinese

• Characters are used as-is to look up phonetic series. In the future, simplified characters will be converted to traditional characters.
• Japanese on’yomi readings are omitted.

Japanese

• On’yomi are included in entries, and further differentiated into go’on, kan’on, etc. This data is derived from MarvNC’s Wiktionary Yomichan dictionary, which in turn is derived from Wiktionary. There may be errors from parsing or from incorrect source information. (NOTE: Unreleased feature!)
• When looking up the phonetic series, shinjitai characters will be converted to kyūjitai. This is done because the included database of phonetic series is based on traditional Chinese, which more closely matches kyūjitai variants. Regardless, there is not perfect coverage of Japanese.
• If both a hanzi_fields_regexp field and a kyujitai_field field are found on a note, there will be a one way conversion from shinjitai to kyūjitai on the matched notes. The results are not perfect. The intent is not necessary for users to study the kyūjitai forms (this is probably not generally helpful when learning Japanese), but rather to be able to have broader coverage when looking up Japanese words in Chinese dictionaries, for example, the Outlier Dictionary of Chinese Characters in Pleco.

Usage

Ensure that the note types of the notes you want to add web entries to have a field called “HanziWeb” (without quotes). Also ensure that you’ve configured Hanzi Web as described in the Configuration section, so that you are including the correct cards and using the hanzi from the correct fields. Make sure that you add {{HanziWeb}} to your cards’ HTML templates as well.

Now you can add web entries to your notes by accessing Tools -> Hanzi Web -> Update notes… or by pressing Control-W (Command-W on macOS). A dialog with a report of the pending changes will be shown; you’ll want to consider this carefully if it’s your first time running Hanzi Web or if you’ve recently changed your configuration to make sure that you haven’t made any mistakes. Click “Apply” and your notes’ “HanziWeb” fields will be filled!

Alternatively, you can set auto_run_on_sync to true to automatically run Hanzi Web before and after each sync operation.

Copyright

This addon uses data from Wiktionary for both the phonetic series and on’yomi. Please view Wiktionary’s copyright information here.