Skip to content

Commit

Permalink
Merge pull request #2 from Shugyousha/documentation
Browse files Browse the repository at this point in the history
Documentation
  • Loading branch information
ueno committed Aug 11, 2016
2 parents c530c0a + 6b60800 commit 9dfb757
Show file tree
Hide file tree
Showing 3 changed files with 31 additions and 1 deletion.
27 changes: 27 additions & 0 deletions README
Original file line number Diff line number Diff line change
@@ -1 +1,28 @@
ibus-kkc -- a Japanese Kana Kanji input engine for IBus
=======================================================

ibus-kkc makes the Kana Kanji conversion library (libkkc[0]) usable
through IBus.


Custom dictionaries
-------------------

ibus-kkc will look for a "dictionaries.json" file in a path consisting
of the user's config directory concatenated with the package name (the
default template for this file is at src/ibus-kkc-dictionaries.json[1]). By
default the file will be searched in "$HOME/.config/ibus-kkc/".

The "dictionaries.json" file is in JSON format and contains a list of
JSON objects describing dictionaries that can be downloaded from here[2]
(this site is in Japanese). All custom dictionary files mentioned in
"dictionaries.json" will be searched in "/usr/local/share/skk/".

The assumed default encoding of the dictionaries is "EUC-JP". If your
dictionary uses a different encoding you can add an "encoding" field
to the JSON object describing your dictionary. The value of that field
should be the name of the encoding used in your custom dictionary file.

[0] https://github.com/ueno/libkkc
[1] https://github.com/ueno/ibus-kkc/blob/master/src/ibus-kkc-dictionaries.json
[2] http://openlab.ring.gr.jp/skk/wiki/wiki.cgi?page=SKK%BC%AD%BD%F1
3 changes: 3 additions & 0 deletions src/dictionary.vala
Original file line number Diff line number Diff line change
Expand Up @@ -125,6 +125,9 @@ public class DictionaryRegistry : Object {
file.get_path (),
e.message);
}
} else {
warning ("Dictionary file at %s could not be found. We will run without any custom dictionaries.",
file.get_path ());
}
}
}
2 changes: 1 addition & 1 deletion src/engine.vala
Original file line number Diff line number Diff line change
Expand Up @@ -688,7 +688,7 @@ class KkcEngine : IBus.Engine {
"org.freedesktop.IBus.KKC",
N_("Kana Kanji"), Config.PACKAGE_VERSION, "GPL",
"Daiki Ueno <ueno@gnu.org>",
"http://code.google.com/p/ibus/",
"https://github.com/ueno/ibus-kkc",
"",
"ibus-kkc");
var engine = new IBus.EngineDesc (
Expand Down

0 comments on commit 9dfb757

Please sign in to comment.