5. Usage

Start up gjiten.

Set the Preferences first, otherwise gjiten might not work correctly. Add the dictionary files to the list that you want to use with the word dictionary.

Please note that the kanjidic dictionary file should not be added to the list together with the other word dictionary files, it has a separate file entry box.

5.1. Word dictionary usage

You can set the search options with the toggle buttons. Experiment with them a little to see what they do. Select the dictionary file in the pulldown menu under general options that you want to search in.

The Auto Adjust Options can be quite a handy feature. Gjiten will search for matches setting the English Search Options in the following order if it doesn't find any match for your prior criteria: Whole Expressions -> Whole Words -> Any Matches. Similarly in the case of a Japanese search it will set the toggle buttons from top to bottom.

For Japanese input, you have to activate (shift-space for kinput2 in my case) the program on your system that can convert and pass Japanese text to GTK. Cut and paste works well also! ;)

5.2. Kanji dictionary usage

I'll refer to the kanji dictionary part of gjiten as KanjiDic.

If you know the stroke number of the kanji, enable the Search By Strokes option. Set the stroke number. If you are not exactly sure, use the +/- field also.

Enable the Search By Radical option if you know the radical(s) of the kanji. Either enter the radical directly through your XIM, or click on the Show Radical List for the radical window. Here you can click on the appropriate radical to pop it into the radical search entry. You can enter up to 10 radicals.

If you want to search by a keyword also, then enable the Search By Key option. A keyword can be anything that the Kanjidic file contains. Usually this will be a reading (in kana) or an english meaning of the kanji. But it can be a kanjidic code also. For example entering S8 here would give all the kanji with 8 strokes. Read Jim Breen's documentation about the kanjidic file if you want to know more about these.

KanjiDic has real-time kanji lookup. This means that while you are entering radicals it will look up and show the kanji matching your criteria without having to press the search every time you enter a radical. If only 1 kanji is found then an info window will pop up with the information about the kanji. If more than one is found then you have to click on the kanji to get the info about it. You can customize these info fields shown in the Preferences.

5.3. Command Line

Issue the command gjiten --help to get a list of all the command line arguments that gjiten understands. Here is the important part:

 gjiten options	      -k, --kanjidic              Start up Kanjidic instead of Word dictionary	      -w, --word-lookup=WORD      Look up WORD in first dictionary	      -l, --kanji-lookup=KANJI    Look up KANJI in kanji dictionary	      -c, --clip-kanji            Look up kanji from clipboard	      -v, --clip-word             Look up word from clipboard	    


As a useful utilization of these I assigned a shortcut ctrl-alt-w with my window manager to the command gjiten -v. In the Sawfish window manager you can add this command to your existing shortcuts as run-shell-command. So I just have to highlight the text then press ctrl-alt-w and gjiten gets fired up with the search results already looked up. You can add another shortcut for the kanji lookup.

5.4. KanjiPad

KanjiPad is a separate application written by Owen Taylor. It is a handwriting recognition program for kanji. Does a quite good job in many cases and might be faster to use then KanjiDic. Select the kanji that appears on the right side of KanjiPad after recognition, then you can paste this into KanjiDic or the into word dictionary for further lookups. Read it's README for more info.

The latest version of KanjiPad can be downloaded from http://www.gtk.org/~otaylor/kanjipad/