diff options
| author | StefanVukovic99 <stefanvukovic44@gmail.com> | 2024-02-17 02:45:24 +0100 | 
|---|---|---|
| committer | GitHub <noreply@github.com> | 2024-02-17 01:45:24 +0000 | 
| commit | 4aaa9f15d97668203741c1731f15e710ae8b8294 (patch) | |
| tree | d1885f7fbd7d1510a71176597169d6847ae26572 /docs | |
| parent | 4e77741d22778bd09b772fc53f1cbd64107e3d24 (diff) | |
add language select, abstract text transformations (#584)
* Copy functions from JapaneseUtil
* Remove JapaneseUtil
* Update usages of JapaneseUtil functions
* part1
* frotend done?
* fix tests
* offscreen and type complications
* add tests
* start fixing tests
* keep fixing tests
* fix tests
* Copy functions from JapaneseUtil
* Remove JapaneseUtil
* Update usages of JapaneseUtil functions
* delete pt
* renames
* add tests
* kebab-case filenames
* lint
* minor fixes
* merge
* fixes
* fix part of comments
* fix more comments
* delete unused types
* comment
* comment
* do backend
* other files
* move fetch utils to own file
* remove extra line
* add extra line
* remove unnecessary export
* simplify folder structure
* remove redundant async
* fix param type in api
* fix language index
* undo changes to cssStyleApplier
* undo changes to utilities.js
* undo changes to utilities.js
* simplify language util
* lint
* undo phantom changes to anki integration
* require textTransformations options
* explicit locale in localeCompare
* punctuate notes
* prefer early exit
* rename LanguageOptionsObjectMap
* rename to textPreprocessor
* tuple with names instead of boolean array
* safe data setting
* optional chaining
* simplify LanguageOptions
* encapsulate languages
* delete language util
* nullable language in text preprocessors controller
* rename transform to process
* remove settings
* make translation advanced again
* remove unused getTextTransformations api call
* comments
* change language types
* RIP flags
* comments
* fix tests
* lint
* Text preprocessor type changes (#10)
* Add types
* Update types
* Simplify type check
* Refactor typing and structuring of language definitions
* lint
* update translator benchmark
* undo markdown changes
* undo markdown changes
* undo markdown changes
* more merge
* simplify language controller
---------
Co-authored-by: toasted-nutbread <toasted-nutbread@users.noreply.github.com>
Co-authored-by: Darius Jahandarie <djahandarie@gmail.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/anki-integration.md | 120 | 
1 files changed, 60 insertions, 60 deletions
| diff --git a/docs/anki-integration.md b/docs/anki-integration.md index 2bd9fad9..9bd5bd94 100644 --- a/docs/anki-integration.md +++ b/docs/anki-integration.md @@ -23,71 +23,71 @@ Flashcard fields can be configured with the following steps:      #### Markers for Term Cards -    | Marker                     | Description                                                                                                              | -    | -------------------------- | ------------------------------------------------------------------------------------------------------------------------ | -    | `{audio}`                  | Audio sample of a native speaker's pronunciation in MP3 format (if available).                                           | -    | `{clipboard-image}`        | An image which is stored in the system clipboard, if present.                                                            | -    | `{clipboard-text}`         | Text which is stored in the system clipboard, if present.                                                                | -    | `{cloze-body}`             | Raw, inflected term as it appeared before being reduced to dictionary form by Yomitan.                                   | -    | `{cloze-body-kana}`        | Kana reading for `{cloze-body}`.                                                                                         | -    | `{cloze-prefix}`           | Fragment of the containing `{sentence}` starting at the beginning of `{sentence}` until the beginning of `{cloze-body}`. | -    | `{cloze-suffix}`           | Fragment of the containing `{sentence}` starting at the end of `{cloze-body}` until the end of `{sentence}`.             | -    | `{conjugation}`            | Conjugation path from the raw inflected term to the source term.                                                         | -    | `{dictionary}`             | Name of the dictionary from which the card is being created (unavailable in _grouped_ mode).                             | -    | `{document-title}`         | Title of the web page that the term appeared in.                                                                         | -    | `{expression}`             | Term expressed as kanji (will be displayed in kana if kanji is not available).                                           | -    | `{frequencies}`            | Frequency information for the term.                                                                                      | -    | `{frequency-harmonic-rank}` | The harmonic mean of frequency data for the current term. Defaults to rank 9999999 when frequency data is not found, indicating extremely low rank-based term usage. | +    | Marker                            | Description                                                                                                                                                            | +    | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +    | `{audio}`                         | Audio sample of a native speaker's pronunciation in MP3 format (if available).                                                                                         | +    | `{clipboard-image}`               | An image which is stored in the system clipboard, if present.                                                                                                          | +    | `{clipboard-text}`                | Text which is stored in the system clipboard, if present.                                                                                                              | +    | `{cloze-body}`                    | Raw, inflected term as it appeared before being reduced to dictionary form by Yomitan.                                                                                 | +    | `{cloze-body-kana}`               | Kana reading for `{cloze-body}`.                                                                                                                                       | +    | `{cloze-prefix}`                  | Fragment of the containing `{sentence}` starting at the beginning of `{sentence}` until the beginning of `{cloze-body}`.                                               | +    | `{cloze-suffix}`                  | Fragment of the containing `{sentence}` starting at the end of `{cloze-body}` until the end of `{sentence}`.                                                           | +    | `{conjugation}`                   | Conjugation path from the raw inflected term to the source term.                                                                                                       | +    | `{dictionary}`                    | Name of the dictionary from which the card is being created (unavailable in _grouped_ mode).                                                                           | +    | `{document-title}`                | Title of the web page that the term appeared in.                                                                                                                       | +    | `{expression}`                    | Term expressed as kanji (will be displayed in kana if kanji is not available).                                                                                         | +    | `{frequencies}`                   | Frequency information for the term.                                                                                                                                    | +    | `{frequency-harmonic-rank}`       | The harmonic mean of frequency data for the current term. Defaults to rank 9999999 when frequency data is not found, indicating extremely low rank-based term usage.   |      | `{frequency-harmonic-occurrence}` | The harmonic mean of frequency data for the current term. Defaults to 0 occurrences when frequency data is not found, the lowest possible occurrence-based term usage. | -    | `{frequency-average-rank}` | The average of frequency data for the current term. Defaults to rank 9999999 when frequency data is not found, indicating extremely low rank-based term usage. | -    | `{frequency-average-occurrence}` | The average of frequency data for the current term. Defaults to 0 occurrences when frequency data is not found, the lowest possible occurrence-based term usage. | -    | `{furigana}`               | Term expressed as kanji with furigana displayed above it (e.g. <ruby>日本語<rt>にほんご</rt></ruby>).                    | -    | `{furigana-plain}`         | Term expressed as kanji with furigana displayed next to it in brackets (e.g. 日本語[にほんご]).                          | -    | `{glossary}`               | List of definitions for the term (output format depends on whether running in _grouped_ mode).                           | -    | `{glossary-brief}`         | List of definitions for the term in a more compact format.                                                               | -    | `{glossary-no-dictionary}` | List of definitions for the term, except the dictionary tag is omitted.                                                  | -    | `{part-of-speech}`         | Part of speech information for the term.                                                                                 | -    | `{phonetic-transcriptions}`| List of phonetic transcriptions for the term.                                                                            | -    | `{pitch-accents}`          | List of pitch accent downstep notations for the term.                                                                    | -    | `{pitch-accent-graphs}`    | List of pitch accent graphs for the term.                                                                                | -    | `{pitch-accent-positions}` | List of accent downstep positions for the term as a number.                                                              | -    | `{pitch-accent-categories}`| List of pitch accent categories for the term (e.g. heiban, kifuku, atamadaka, odaka, nakadaka).                          | -    | `{reading}`                | Kana reading for the term (empty for terms where the expression is the reading).                                         | -    | `{screenshot}`             | Screenshot of the web page taken at the time the term was added.                                                         | -    | `{search-query}`           | The full search query shown on the search page.                                                                          | -    | `{selection-text}`         | The selected text on the search page or popup.                                                                           | -    | `{sentence}`               | Sentence, quote, or phrase that the term appears in from the source content.                                             | -    | `{sentence-furigana}`      | Sentence, quote, or phrase that the term appears in from the source content, with furigana added.                        | -    | `{tags}`                   | Grammar and usage tags providing information about the term (unavailable in _grouped_ mode).                             | -    | `{url}`                    | Address of the web page in which the term appeared in.                                                                   | +    | `{frequency-average-rank}`        | The average of frequency data for the current term. Defaults to rank 9999999 when frequency data is not found, indicating extremely low rank-based term usage.         | +    | `{frequency-average-occurrence}`  | The average of frequency data for the current term. Defaults to 0 occurrences when frequency data is not found, the lowest possible occurrence-based term usage.       | +    | `{furigana}`                      | Term expressed as kanji with furigana displayed above it (e.g. <ruby>日本語<rt>にほんご</rt></ruby>).                                                                  | +    | `{furigana-plain}`                | Term expressed as kanji with furigana displayed next to it in brackets (e.g. 日本語[にほんご]).                                                                        | +    | `{glossary}`                      | List of definitions for the term (output format depends on whether running in _grouped_ mode).                                                                         | +    | `{glossary-brief}`                | List of definitions for the term in a more compact format.                                                                                                             | +    | `{glossary-no-dictionary}`        | List of definitions for the term, except the dictionary tag is omitted.                                                                                                | +    | `{part-of-speech}`                | Part of speech information for the term.                                                                                                                               | +    | `{phonetic-transcriptions}`       | List of phonetic transcriptions for the term.                                                                                                                          | +    | `{pitch-accents}`                 | List of pitch accent downstep notations for the term.                                                                                                                  | +    | `{pitch-accent-graphs}`           | List of pitch accent graphs for the term.                                                                                                                              | +    | `{pitch-accent-positions}`        | List of accent downstep positions for the term as a number.                                                                                                            | +    | `{pitch-accent-categories}`       | List of pitch accent categories for the term (e.g. heiban, kifuku, atamadaka, odaka, nakadaka).                                                                        | +    | `{reading}`                       | Kana reading for the term (empty for terms where the expression is the reading).                                                                                       | +    | `{screenshot}`                    | Screenshot of the web page taken at the time the term was added.                                                                                                       | +    | `{search-query}`                  | The full search query shown on the search page.                                                                                                                        | +    | `{selection-text}`                | The selected text on the search page or popup.                                                                                                                         | +    | `{sentence}`                      | Sentence, quote, or phrase that the term appears in from the source content.                                                                                           | +    | `{sentence-furigana}`             | Sentence, quote, or phrase that the term appears in from the source content, with furigana added.                                                                      | +    | `{tags}`                          | Grammar and usage tags providing information about the term (unavailable in _grouped_ mode).                                                                           | +    | `{url}`                           | Address of the web page in which the term appeared in.                                                                                                                 |      #### Markers for Kanji Cards -    | Marker                | Description                                                                                                              | -    | --------------------- | ------------------------------------------------------------------------------------------------------------------------ | -    | `{character}`         | Unicode glyph representing the current kanji.                                                                            | -    | `{clipboard-image}`   | An image which is stored in the system clipboard, if present.                                                            | -    | `{clipboard-text}`    | Text which is stored in the system clipboard, if present.                                                                | -    | `{cloze-body}`        | Raw, inflected parent term as it appeared before being reduced to dictionary form by Yomitan.                            | -    | `{cloze-prefix}`      | Fragment of the containing `{sentence}` starting at the beginning of `{sentence}` until the beginning of `{cloze-body}`. | -    | `{cloze-suffix}`      | Fragment of the containing `{sentence}` starting at the end of `{cloze-body}` until the end of `{sentence}`.             | -    | `{dictionary}`        | Name of the dictionary from which the card is being created.                                                             | -    | `{document-title}`    | Title of the web page that the kanji appeared in.                                                                        | -    | `{frequencies}`       | Frequency information for the kanji.                                                                                     | -    | `{frequency-harmonic-rank}` | The harmonic mean of frequency data for the current kanji. Defaults to rank 9999999 when frequency data is not found, indicating extremely low rank-based kanji usage. | +    | Marker                            | Description                                                                                                                                                              | +    | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +    | `{character}`                     | Unicode glyph representing the current kanji.                                                                                                                            | +    | `{clipboard-image}`               | An image which is stored in the system clipboard, if present.                                                                                                            | +    | `{clipboard-text}`                | Text which is stored in the system clipboard, if present.                                                                                                                | +    | `{cloze-body}`                    | Raw, inflected parent term as it appeared before being reduced to dictionary form by Yomitan.                                                                            | +    | `{cloze-prefix}`                  | Fragment of the containing `{sentence}` starting at the beginning of `{sentence}` until the beginning of `{cloze-body}`.                                                 | +    | `{cloze-suffix}`                  | Fragment of the containing `{sentence}` starting at the end of `{cloze-body}` until the end of `{sentence}`.                                                             | +    | `{dictionary}`                    | Name of the dictionary from which the card is being created.                                                                                                             | +    | `{document-title}`                | Title of the web page that the kanji appeared in.                                                                                                                        | +    | `{frequencies}`                   | Frequency information for the kanji.                                                                                                                                     | +    | `{frequency-harmonic-rank}`       | The harmonic mean of frequency data for the current kanji. Defaults to rank 9999999 when frequency data is not found, indicating extremely low rank-based kanji usage.   |      | `{frequency-harmonic-occurrence}` | The harmonic mean of frequency data for the current kanji. Defaults to 0 occurrences when frequency data is not found, the lowest possible occurrence-based kanji usage. | -    | `{frequency-average-rank}` | The average of frequency data for the current kanji. Defaults to rank 9999999 when frequency data is not found, indicating extremely low rank-based kanji usage. | -    | `{frequency-average-occurrence}` | The average of frequency data for the current kanji. Defaults to 0 occurrences when frequency data is not found, the lowest possible occurrence-based kanji usage. | -    | `{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.                                                            | -    | `{screenshot}`        | Screenshot of the web page taken at the time the kanji was added.                                                        | -    | `{search-query}`      | The full search query shown on the search page.                                                                          | -    | `{selection-text}`    | The selected text on the search page or popup.                                                                           | -    | `{sentence}`          | Sentence, quote, or phrase that the character appears in from the source content.                                        | -    | `{sentence-furigana}` | Sentence, quote, or phrase that the character appears in from the source content, with furigana added.                   | -    | `{stroke-count}`      | Number of strokes that the kanji character has.                                                                          | -    | `{url}`               | Address of the web page in which the kanji appeared in.                                                                  | +    | `{frequency-average-rank}`        | The average of frequency data for the current kanji. Defaults to rank 9999999 when frequency data is not found, indicating extremely low rank-based kanji usage.         | +    | `{frequency-average-occurrence}`  | The average of frequency data for the current kanji. Defaults to 0 occurrences when frequency data is not found, the lowest possible occurrence-based kanji usage.       | +    | `{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.                                                                                                            | +    | `{screenshot}`                    | Screenshot of the web page taken at the time the kanji was added.                                                                                                        | +    | `{search-query}`                  | The full search query shown on the search page.                                                                                                                          | +    | `{selection-text}`                | The selected text on the search page or popup.                                                                                                                           | +    | `{sentence}`                      | Sentence, quote, or phrase that the character appears in from the source content.                                                                                        | +    | `{sentence-furigana}`             | Sentence, quote, or phrase that the character appears in from the source content, with furigana added.                                                                   | +    | `{stroke-count}`                  | Number of strokes that the kanji character has.                                                                                                                          | +    | `{url}`                           | Address of the web page in which the kanji appeared in.                                                                                                                  |  When creating your model for Yomitan, _make sure that you pick a unique field to be first_; fields that will  contain `{expression}` or `{character}` are ideal candidates for this. Anki does not allow duplicate flashcards to be |