From 8bf781e801c3fd25caaa9369b159b5aa056becfb Mon Sep 17 00:00:00 2001 From: Alex Yatskov Date: Wed, 29 Mar 2017 20:25:49 -0700 Subject: [PATCH] Updating README.md --- README.md | 52 ++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 38 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index bcebff31..5b1e9182 100644 --- a/README.md +++ b/README.md @@ -20,22 +20,14 @@ Yomichan provides advanced features not available in other browser-based diction ## Browser Support ## -* Google Chrome (versions 45+) +* **Google Chrome** (versions 45+) [![](https://foosoft.net/projects/yomichan/img/chrome-web-store.png)](https://chrome.google.com/webstore/detail/yomichan/ogmnaimimemjmbakcfefmnahgdfhfami) -* Mozilla Firefox (versions 51+) - - [![](https://foosoft.net/projects/yomichan/img/firefox-marketplace.png)](https://addons.mozilla.org/en-US/firefox/addon/yomichan/) - - Yomichan is sitting in a queue to be reviewed and signed by Mozilla. This process can take months; if you wish to - use this extension today: - - 1. Type `about:config` into the browser address bar. - 2. Skip past the "voiding your warranty" nag screen. - 3. Type `xpinstall.signatures.required` into the search bar on top. - 4. Double-click the displayed entry to set its value to `false`. - 5. Install extension as usual from the [Firefox Marketplace](https://addons.mozilla.org/en-US/firefox/addon/yomichan/). +* **Mozilla Firefox** (versions 51+) + * [Locally hosted](https://foosoft.net/projects/yomichan/dl/latest.xpi) *(recommended)*: Latest and greatest, released simultaneously with the Chrome version. + * [Marketplace hosted](https://addons.mozilla.org/en-US/firefox/addon/yomichan/): Officially hosted version, + likely to be substantially out of date (queued for initial approval). ## Basic Features ## @@ -104,6 +96,9 @@ Flashcard fields can be configured with the following steps: Marker | Description -------|------------ `{audio}` | Audio sample of a native speaker's pronunciation in MP3 format (if available). + `{cloze-body}` | Raw, inflected term as it appeared before being reduced to dictionary form by Yomichan. + `{cloze-prefix}` | Text for the containing `{sentence}` from the start up to the value of `{cloze-body}`. + `{cloze-suffix}` | Text for the containing `{sentence}` from the value of `{cloze-body}` to the end. `{dictionary}` | Name of the dictionary from which the card is being created (unavailable in *grouped* mode). `{expression}` | Term expressed as Kanji (will be displayed in Kana if Kanji is not available). `{furigana}` | Term expressed as Kanji with Furigana displayed above it (e.g. 日本語にほんご). @@ -118,10 +113,14 @@ Flashcard fields can be configured with the following steps: Marker | Description -------|------------ `{character}` | Unicode glyph representing the current Kanji. + `{cloze-body}` | Raw, inflected parent term as it appeared before being reduced to dictionary form by Yomichan. + `{cloze-prefix}` | Text for the containing `{sentence}` from the start up to the value of `{cloze-body}`. + `{cloze-suffix}` | Text for the containing `{sentence}` from the value of `{cloze-body}` to the end. `{dictionary}` | Name of the dictionary from which the card is being created. `{glossary}` | List of definitions for the Kanji. `{kunyomi}` | Kunyomi (Japanese reading) for the Kanji expressed as Katakana. `{onyomi}` | Onyomi (Chinese reading) for the Kanji expressed as Hiragana. + `{sentence}` | Sentence, quote, or phrase in which the character appears in the source content. `{url}` | Address of the web page in which the Kanji appeared in. When creating your model for Yomichan, *please make sure that you pick a unique field to be first*; fields that will @@ -144,6 +143,32 @@ Below are some troubleshooting tips you can try if you are unable to create new * If all of the buttons appear grayed out then you should double-check your deck and model configuration settings. * If no icons appear at all, please make sure that Anki is running in the background and that [AnkiConnect](https://foosoft.net/projects/anki-connect) has been installed. +## Keyboard Shortcuts ## + +The following shortcuts are globally available: + +Shortcut | Action +---------|------- +Alt + Insert | Open search page. +Alt + Delete | Toggle extension on/off. + +The following shortcuts are available on search results: + +Shortcut | Action +---------|------- +Esc | Cancel current search +Alt + PgUp | Page up through results. +Alt + PgDn | Page down through results. +Alt + End | Go to last result. +Alt + Home | Go to first result. +Alt + Up | Go to previous result. +Alt + Down | Go to next result. +Alt + b | Go to back to source term. +Alt + e | Add current term as expression to Anki. +Alt + r | Add current term as reading to Anki. +Alt + p | Play audio for current term. +Alt + k | Add current Kanji to Anki. + ## Development ## Working on Yomichan and related tools is very time consuming and I am always on the lookout for code contributions from @@ -165,7 +190,6 @@ can use the included `build_tmpl.sh` and `build_tmpl_auto.sh` (requires [inotify-tools](https://github.com/rvoicilas/inotify-tools/wiki)) shell scripts to do this for you. Otherwise, simply execute `handlebars tmpl/*.html -f ext/bg/js/templates.js` from the project's base directory. - ### Dependencies ### Yomichan relies on several third-party libraries to function. The following are links to homepages and snapshots of the