Setup: Installing
Overview¶
A full sentence mining workflow requires two main parts:
- Text to make the cards from.
- The card exporter, to create cards from the text.
- And optionally, the image and sentence audio from the media (if the media has either).
These next few sections (Installing, Anki and Yomitan) are all dedicated to providing the minimal setup to setup the card exporter to create cards with this note type.
Getting the text (the first part) and getting the image and sentence audio (the optional part of part two) are not heavily focused on within this site, but can be found under Setup: Text & Media page.
Note
There's quite a few things to setup to use this note. If you ever get lost, remember that this site has a search bar!
Installing Anki¶
Download and install Anki from the official website if you haven't already. I recommend downloading the latest version, to avoid having to do extra steps during the setup.
Installing jp-mining-note¶
There are three ways of installing the note:
- Via JPMN Manager, a small Anki add-on that can install and update jp-mining-note, as well as notify you when updates are available. If you don't know which method to choose, choose this one.
- Via command line.
This method is recommended for people who are familiar with
git
andpython
, and don't want to download another Anki add-on. - Manually, using Anki. This tends to be more error-prone due to having many more potential points of failure. Therefore, I wouldn't recommend installing the note this way. It should only be used if the first two options didn't work.
Option 1: JPMN Manager (click here)
Note
If you have previously installed Aquafina's old version
of the JPMN add-on, then you must remove it before installing the new version below.
The old and new versions will conflict with each other if they are both
installed. In your list of Anki add-ons, you should only see
JPMN Manager with prereleases New Version
. If you see
JPMN Manager with prereleases
then please remove it and restart Anki
before proceeding.
-
To install any Anki add-on, navigate to:
(Main Window) →
Tools
→Add-ons
→Get Add-ons...
From here, you can install JPMN Manager and Anki-Connect by using the following add-on codes:
-
Restart Anki, to load the new add-ons.
-
Within Anki, navigate to the following:
(Main Window) →
Tools
→JPMN Manager
→Install jp-mining-note
This will install latest version of the note, as well as the fonts required for the note to work.
Note: Installing jp-mining-note might take a while, and Anki may appear frozen.
-->
Option 2: Command Line (click here)
git clone "https://github.com/arbyste/jp-mining-note.git"
:: TODO change this to master branch
cd jp-mining-note
git checkout dev
:: Ensure you have Anki open, and with Anki-Connect running
:: Also ensure that you have python 3.9+ installed.
:: It *MAY* work with lower versions of python, but I make no such guarantee. ;)
python tools\install.py
git clone "https://github.com/arbyste/jp-mining-note.git"
:: TODO change this to master branch
cd jp-mining-note
git checkout dev
# Ensure you have Anki open, and with Anki-Connect running
# Also ensure that you have python 3.9+ installed.
# It *MAY* work with lower versions of python, but I make no such guarantee. ;)
# You may have to use `python3` instead of `python`.
python tools/install.py
install.py
will install latest stable version of the note,
as well as the fonts required for the note to work.
Option 3: Manually (click here)
- Go to the
releases page
and download the cards from the latest release.
You should download the
{version}-jpmn_example_cards.apkg
file. -
After you download the cards, import them by navigating to Anki by doing the following:
File
(top left corner) →Import...
-
By default, the custom fonts do not come with the
.apkg
file. To install these fonts, head over to this repository's media folder and download the 4.otf
files. - Move the
.otf
files into the media folder of your profile (Anki2/PROFILENAME/collections.media
).
Verifying the Note Works¶
You should see a deck JPMN-Examples
in your collection.
View one of the cards and make sure the card looks similar to the one below:
Please check the following in particular:
-
The fonts should match with the above example.
If the fonts don't match, try restarting Anki and/or your computer. If the fonts still don't match, the note was likely installed manually. Please verify you manually installed the fonts and placed them in the correct folder (see steps 3 and 4).
-
Notice how at the top left corner, the info circle (the "i" encased within the circle) is the default grey color.
If this circle is red or orange, there may be something wrong with the template. Please see this section for basic troubleshooting.
-
Clicking on the image to zoom should work out of the box.
Kanji hover may not work yet. If it doesn't work, continue reading to the Anki-Connect setup instructions on the next page.
If the image suddenly appears without a zoom animation, then you must enable animations on Anki.
Anki Setup¶
This note requires some additional setup to Anki. In particular, some add-ons are required for the note to work.