Skip to content

Transfer Existing Notes

Overview

This section is dedicated to explaining how you can change other Anki cards into this note format.

Note

If you are simply importing old JPMN notes, updating JPMN will properly update all the notes in place. See this section instead.


Introduction

Unfortunately, there are so many card formats out there that it would be impossible to cover how to import from every format with detailed rigor. Instead, this section will give you some general tips on operations that will likely be common across most or all formats, as well as present a small example for Anime Cards.

Additionally, although you maybe able to import most of the card, it is unlikely that you will have complete 100% full functionality after importing the notes. The biggest example is frequency list information, as it requires special HTML + css formatting that can only be specified in the Yomichan Templates section.


Prerequisites

Before doing anything that affects your Anki collection in a major way (for example, basically everything on this page), please make a complete backup of your collection.

Note

Transferring your previous notes shouldn't change your media files at all. However I recommend exporting with media just in case, so long as you have the disk space for it.


Anki

Anki provides a feature to switch between note types, without affecting scheduling information. To do this, follow the proceeding steps:

  1. Head to the Card Browser window:

    Main Window → Browse

  2. Select all the cards that you want to switch.

    Tip

    ctrl+a selects all cards in the browser.

  3. Right click the selection → NotesChange Note Type...


Mapping Fields

Here is where I can't give specific advice, as every note is different. However, here are a few tips:

  1. Map Word to Key and Word.

    Your card likely doesn't have a separate Key and Word field, and instead only contains one Word field. To import this correctly into JPMN, make sure JPMN's Key and Word field are exactly your old card's Word field.

  2. Leave AJTWordPitch and SentenceReading empty.

    These fields can be empty as AJT Japanese can batch generate both word pitches and sentence furigana.

  3. You may have some word pitch fields already in your card. Pitch accent graphs should be mapped to PAGraphs, and pitch accent positions should be mapped to PAPositions.

    Note that if you plan to use colored pitch accent on old cards, you must have a pitch accent positions field.2

  4. FrequencySort maps to the frequency value used to sort by frequency, which works exactly the same as Marv's Frequency field as documented in this page.

  5. If you have a field that stores the source of the media, I recommend mapping that to AdditionalNotes.

  6. The WordReading field should ideally be a simplified furigana format. For example, if the word is 成り立つ, this field should be 「成[な]り 立[た]つ」. If you do not have any field that resembles this, use the kana reading (なりたつ) or true furigana (つ), and continue with the steps below.

  7. I recommend not setting FrequenciesStylized to anything, even if you have a field for frequency lists1.

An example with Anime cards is shown below.

Example for Anime Cards (click here)
jp-mining-note fields Anime Cards Fields
Key front
Word front
WordReading Reading
PAOverride
PAOverrideText
AJTWordPitch
PrimaryDefinition Glossary
PrimaryDefinitionPicture
Sentence Sentence
SentenceReading
AltDisplay
AltDisplayPASentenceCard
AdditionalNotes
IsSentenceCard
IsClickCard
IsHoverCard
IsTargetedSentenceCard
PAShowInfo
PATestOnlyWord
PADoNotTest
PASeparateWordCard
PASeparateSentenceCard
SeparateClozeDeletionCard
Hint
HintNotHidden Hint
Picture Picture
WordAudio Audio
SentenceAudio SentenceAudio
PAGraphs Graph
PAPositions
PASilence
WordReadingHiragana
FrequenciesStylized
FrequencySort
SecondaryDefinition
ExtraDefinitions
UtilityDictionaries
Comment

Note

Anything not specified should be set to (Nothing)


Batch Editing

After switching your notes, you will have to do the following few steps:

(1) Correctly Formatting Sentence Field

If your sentence fields have been highlighted in a way that isn't using <b>, then it will be incompatable with JPMN by default.

To see what the formatting of the sentence is, view the raw HTML of the Sentence field.

Sentences are usually formatted in one of three ways, as shown below:

If the tested content is highlighted with <b>, then it is already formatted correctly. You can skip this step.

Example:

今日も、なんか、昼<b>爆睡</b>してしまったんので…

The note comes with a feature to automatically highlight the word within the sentence. However, this is an imperfect solution, and there is currently no easy way to add accurate highlighting to existing sentences.

As there is nothing to do, you can skip this step.

Example:

今日も、なんか、昼爆睡してしまったんので…

If the tested content is highlighted with something that isn't <b>, then continue with the following instructions to change it.

Example:

今日も、なんか、昼<span style="color: #ffc2c7">爆睡</span>してしまったんので…
Instructions to port formatted sentences (click here)

Note

You may want to make another backup before doing the following, just in case.

  1. Determine how the sentence is formatted.

    We will be using the above for this example. This example highlights the word using a <span> with a custom color.

    今日も、なんか、昼<span style="color: #ffc2c7">爆睡</span>してしまったんので…
    

    The above is created from the following Yomichan fields:

    {cloze-prefix}<span style="color: #ffc2c7">{cloze-body}</span>{cloze-suffix}
    
  2. Testing the Conversion.

    In the Anki card viewer, select only one of your old notes.

    Afterwards, right click the selection, and head over to:

    NotesFind and Replace...

  3. Setting the fields.

    Set the Find field to something that can find your highlighted content. We will use the above as an example.

    It is extremely likely that you will have to change the Find field according to your note's sentence format.

    Field name Value
    Find: <span style="color: #ffc2c7">(?P<t>.*?)</span>
    Replace With: <b>$t</b>
    In: Sentence
    Selected notes only Checked ()
    Ignore case Unchecked ()
    Treat input as a
    regular expression
    Checked ()
    Example image (click here)

    The above table in Anki

  4. Verify.

    Press Ok, and then preview the card.

    If the highlight is yellow (or blue on light mode), then it it was successful! Repeat steps 2 and 3, except select all of the affected notes instead of just one.

    If it was not successful, you likely have to adjust the Find field. See here to see Anki's official documentation on regex.


(2) Batch generate pitch accents and sentence furigana

This step requires the AJT Japanese addon to be correctly setup. Although this step is optional, pitch accents likely won't show for imported cards if you had nothing to import into PAPositions. In that case, this step is highly recommended.

  1. Head to the Card Browser window:

    Main Window → Browse

  2. Select all of your newly imported notes.

    Tip

    The following query should reveal all of your newly imported notes. Make sure you include the double quotes in the query search.

    "note:JP Mining Note"
    
    Afterwards, you can do ctrl+a to select all of the resulting cards.
  3. Head over to:

    Edit (top left corner) → AJT: Bulk-generate.


(3) Batch Set PASilence Field

This will ensure all PASilence are filled correctly. See here to understand what this field does. This can be done within Anki itself, or with Python.

  1. Head to the Card Browser window.
  2. Right click a card, and then head to:

    NotesFind and Replace...

  3. Set the fields to the following:

    Field name Value
    Find: .*
    Replace With: [sound:_silence.wav]
    In: PASilence (IMPORTANT! Do not forget this field!)
    Selected notes only Unchecked ()
    Ignore case Unchecked ()
    Treat input as a
    regular expression
    Checked ()
    Example image (click here)

    The above table in Anki

# assuming you are at the root of the repo,
# i.e. after the `git clone ...` and `cd jp-mining-note`
cd ./tools

# make sure you have Anki open and Anki-Connect installed!
python3 ./batch.py -f "set_pasilence_field"


(4) Correctly Formatting WordReading Field

Your WordReading field is likely formatted in one of three ways:

This is generated with the {furigana-plain} marker.

Example: 成[な]り 立[た]つ

If your WordReading field is formatted this way, then the WordReading field is already formatted correctly. You can skip this step.

This is generated with the {furigana} marker.

Example: つ (HTML: <ruby>成<rt>な</rt></ruby>り<ruby>立<rt>た</rt></ruby>つ)

If your WordReading field is formatted this way, it would be ideal to convert this into plain furigana so the note can properly parse the field.

Instructions for converting furigana into plain furigana (click here)
  1. Head to the Card Browser window.
  2. Right click a card, and then head to:

    NotesFind and Replace...

  3. Set the fields to the following:

    Field name Value
    Find: <ruby>(<rb>)?(?P<kanji>.*?)(</rb>)?<rt>(?P<furigana>.*?)</rt></ruby>
    Replace With:  $kanji[$furigana] (Keep the whitespace at the beginning!)
    In: WordReading
    Selected notes only Unchecked ()
    Ignore case Unchecked ()
    Treat input as a
    regular expression
    Checked ()

This is generated with the {reading} marker.

Example: なりたつ

This means that your old cards only have a kana reading. It would be ideal to have the WordReading as the kanji word with furigana. You likely want the kanji word with the furigana, so the kanjis actually show in the proper places. Some examples include the kanji hover tooltip as well as to the left of the picture field.

Instructions for converting kana readings into (plain) furigana (click here)

The solution provided below is imperfect, but passable. This will format all of the WordReading fields to be Word[WordReading], which means kana will repeated. For example, a card with Word as 成り立つ, and WordReading as なりたつ, will turn into: 成り立つなりたつ

To do this, you will have to run a Python script from the repository. For Windows users, see the first 3 steps for the Windows instructions here if you haven't use Python before.

Afterwards, create a backup and run the following:

:: assuming you are in jp-mining-note/tools
:: make sure you have Anki open and Anki-Connect installed!
python batch.py -f "quick_fix_convert_kana_only_reading_all_notes"
# assuming you are in jp-mining-note/tools
# make sure you have Anki open and Anki-Connect installed!
python3 batch.py -f "quick_fix_convert_kana_only_reading_all_notes"

The above will affect ALL notes. If you instead want to affect certain notes, add the kanaonlyreading tag to all affected notes, and then run:

python batch.py -f "quick_fix_convert_kana_only_reading_with_tag"
python3 batch.py -f "quick_fix_convert_kana_only_reading_with_tag"


(5) (Optional) Batch set WordReadingHiragana Field

New in version 0.11.0.0 (latest version: 0.11.0.4)

The following automatically fills out the WordReadingHiragana field.

Filling out the WordReadingHiragana field is optional but highly recommended. This will enable the usage of Word Indicators on existing cards.

To do this, you will have to run a Python script. Again, for Windows users, if you have not used Python before, see the first 3 steps for the "Windows" instructions here.

The following script assumes that Step 4 is done (which means your WordReading field is formatted as plain furigana). Do not run this script if you have not successfully completed Step 4.

:: assuming you are in jp-mining-note/tools
:: make sure you have Anki open and Anki-Connect installed!
python batch.py -f "fill_word_reading_hiragana_field"
# assuming you are in jp-mining-note/tools
# make sure you have Anki open and Anki-Connect installed!
python3 batch.py -f "fill_word_reading_hiragana_field"

(6) (Optional) Backfill the FrequencySort Field

As mentioned ealier, FrequencySort behaves exactly the same as Marv's Frequency field as documented in this page. That page also contains instructions on how to backfill the field if it is empty.

If you are following the command line instructions, use the following command:

python backfill.py "Word" --freq-field "FrequencySort" --query "FrequencySort: \"note:JP Mining Note\""

Conclusion

If everything went smoothly, then you have successfully transferred your notes to the JPMN template. Enjoy reviewing your old cards with a new template!


  1. FrequenciesStylized uses a custom set of handlebars to store the frequency info in a way that css styles can be easily applied without javascript. This differs heavily from the {frequencies} marker provided by Yomichan. Mapping an existing field that stores frequencies using {frequencies} to FrequenciesStylized will result in incorrect display of data.

    There is currently no convenience function to convert it to the proper format.

    Additionally, auto-generating frequency info (with the correct css, html, etc.) from arbitrary frequency lists does not seem trivial, and I currently provide no way of doing that (primarily because I'm not sure how to do it in the first place). If you know of a way or would like to help me out with doing this, please let me know! 

  2. The current implementation of colored pitch accent cannot detect the pitch accent position from the svg graph, nor from the automatically generated pitch accent from AJT Pitch Accent. If you do not have a pitch accent positions field, the only way to have colored pitch accent on old cards is by manually setting the position for all affected cards.

    Of course, any new cards should have automatically generated pitch accent positions, so long as you have a Yomichan pitch accent dictionary installed. 


Last update: April 1, 2023