== Japanese dictionary & flashcards like software for jailbroken
   == iphone/ipad/ipod touch, android, *nix (including macos), windows.

This software only works on plateforms with ruby, i.e. jailbroken igadgets,
& pretty much every decent computer around.

It's based on the KANJIDIC and KRADFILE projects, more
specifically on their xml versions and includes a sql version of these
projects, feel free to reuse them.
See Kradfile and Kanjidic.

It creates a web server on 127.0.0.1:8185 that you can access with
safari and query for skip codes, radicals, kanjis, prononciations
or translations of english words --or a mix thereof-- it also
features jlpt's lists, and your own if you spend some time building them.

I provide sqlite3 ruby bindings binaries for iphone, if you don't have
the gcc toolchain, as a gzipped tarball of the build tree.
See http://sourceforge.net/projects/kemuri/.
It's a not so old, not so recent version, by all means
please use the lastest one you may find at sqlite-ruby's
project page (http://rubyforge.org/projects/sqlite-ruby)).

AGPLv3, as mentionned in the source files :

#    Copyright 2008, 2009, 2010 Boris ARZUR
#
#    This file is part of Kemuri.
#
#    Kemuri is free software: you can redistribute it and/or modify
#    it under the terms of the GNU Affero General Public License as
#    published by the Free Software Foundation, either version 3 of
#    the License, or (at your option) any later version.
#
#    Kemuri is distributed in the hope that it will be useful,
#    but WITHOUT ANY WARRANTY; without even the implied warranty of
#    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
#    GNU Affero General Public License for more details.
#
#    You should have received a copy of the GNU Affero General Public
#    License along with Kemuri. If not, see http://www.gnu.org/licenses.

 
The dictionary files (iphone.db and its source iphone.sql) are on a
different Copyright regime :

 
KANJIDIC, KANJD212 and KANJIDIC2 can be freely used provided
satisfactory acknowledgement is made in any software product,
server, etc. that uses them. There are a few other conditions
relating to distributing copies of the files with or without
modification. Copyright is vested in the EDRG (Electronic Dictionary
Research Group, see http://www.edrdg.org/). You can see the specific
licence statement at the Group's site :
http://www.edrdg.org/edrdg/licence.html.

The files are available from the Monash University ftp site
http://ftp.monash.edu.au/pub/nihongo/kanjidic.gz and
http://ftp.monash.edu.au/pub/nihongo/kanjd212.gz.
 
The RADKFILE and KRADFILE files are copright and available under the
EDRDG Licence. The copyright of the RADKFILE2 and KRADFILE2 files is
held by Jim Rose.

Upload all directory 'as-is' to your igadget & run 'ruby kemuri.rb' in
it, it will need to stay running so it might be more convenient to
execute 'ruby kemuri.rb & disown' or 'exec ruby kemuri.rb' in a 'screen' instance.

<edit date='2010/10/07'>
You don't have to do that for versions >= 1.2, there is an .app folder
you can push in your /Applications, creating a SpringBoard icon, that
does the work for you.

In your (or your friend's :)) idevice's safari, go to
http://127.0.0.1:8185/{amodule}/{whatever}?{options&}capture
(e.g. /yad/start?capture ) and touch '+', 'add on home screen', to
create a web-app.

This is still a BETA feature...
</edit>


Direct your browser to one of the sub-module :

• http://127.0.0.1:8185/yad for the dictionary;
• http://127.0.0.1:8185/yav for the flashcards;
• http://127.0.0.1:8185/kan for Kanji info;
• http://127.0.0.1:8185/sk for skip codes, stroke count based searches;
• http://127.0.0.1:8185/rad for radical based search.

These modules are as RESTful as possible :

• /yad/start looks for start in the dictionary;
• /kan/漢 looks for 漢 in the database;
• /sk/1-2-3 tries to match the skip 1-2-3.

Basically each .sv.rb induced servlet is available through
http://127.0.0.1:8185/`basename ${file} .sv.rb`.

On most modules, you will find a 'smart' input box, you can push
text (we call it $1 in what follows) in it, it will try to redirect you :

• 'rad' and 'his' go to the modules /rad & /his;
• *-*-* (more specifically /^\d-\d+-\d+$/ ) and /^\d+$/ to /sk/$1;
• /^\d-\d+-\d++\d-\d+-\d+$/ to /biskip/$1 (bruteforce a pair of
  skip-codes, a bit slow);
• /^\d-\d+-\d+-\d-\d+-\d+$/ to /sk/$1;
• numbers and hyphen separated pairs of numbers go to /sk/$1;
• single kanjis to /kan/$1 or /yad/$1 (you have to choose);
• multiple kanjis or kana to /yad/$1;
• expression containing & or + to /slook/$1, then to
  /look/a_random_string, see the **Search** section.

This is the prefered way of interacting with Kemuri.

In some modules, you will find a blue button, try to drag it, it can be used
to navigate and will show in its center where it is going to send you.
For example, in /yav, it is used to answer : 'y' is 'yes, I know the kanji',
'n' is 'no', 'h' is 'hibernate' and 'yy' is 'double yes'. Different answers have
different effects on the learning algorithm, please refer to the code.

Please note this software uses ruby, sqlite3 and sqlite3-ruby, you
might need to get that installed before you can use Kemuri.

This program features a new way of searching for kanjis : combine radicals
from whatever kanji you know, with vague skip codes (such as "it's a two part
vertical kanji" or "there's 4 strokes on the top part") and stroke counts, glue
these descriptions together with '&', add the possibility to look for more than
one kanji at a time with '+' and you have the ultimate kanji searching application.

Examples :

• typing 帯&1-3-_+在 in voyage, when you are looking for 滞在;
• 特+残&1-_-_+医+病&小+研+究 for 特殊医療研究...

  Brought to you by boris |dοτ| arzur |ατ| our_google_overlords_operated_mail_service.