Difference between revisions of "Mozc"

From ArchWiki
Jump to: navigation, search
m (Removed unsupported aur helper note. Format. Reworked to be more linear.)
m (Various Tweaks: Alignment with Help:Style, formatting, wording etc.)
 
(15 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
[[Category:Internationalization]]
 
[[Category:Internationalization]]
 
[[ja:Mozc]]
 
[[ja:Mozc]]
From the project [http://code.google.com/p/mozc/ home page]:
+
From the project [https://github.com/google/mozc home page]:
: ''Mozc is a Japanese Input Method Editor (IME) designed for multi-platform such as Chromium OS, Windows, Mac and Linux. This open-source project originates from [http://www.google.com/intl/ja/ime/ Google Japanese Input]. Detailed differences between Mozc and Google Japanese Input are described in [http://code.google.com/p/mozc/wiki/AboutMozc About Mozc]'' (In short, Mozc does not have equivalent conversion quality to Google Japanese Input).
+
: ''Mozc is a Japanese Input Method Editor (IME) designed for multi-platform such as Android OS, Apple OS X, Chromium OS, GNU/Linux and Microsoft Windows. This OpenSource project originates from [http://www.google.com/intl/ja/ime/ Google Japanese Input]. […] Detailed differences between Google Japanese Input and Mozc are described in [https://github.com/google/mozc/blob/master/docs/about_branding.md About Branding].''
 +
(In short, Mozc does not have equivalent conversion quality to Google Japanese Input).
  
 
== Installation ==
 
== Installation ==
  
You can install {{AUR|mozc}} (vanilla) using [[#Unofficial user repository|unofficial user repository]] or build yourself from [[AUR]].
+
Depending on your target setup, there are several available Mozc packages to choose from. Firstly, you will likely need to install both the Mozc core package and an integration for the Input Method Framework of your choice (such as [[Fcitx]], [[IBus]], or [[UIM|uim]]), though some Fcitx packages come bundled with the core. Secondly, there exist some unofficial dictionaries: The UT (discontinued) and UT2 dictionaries, which are combined from several sources with hit numbers coming from Google/Yahoo and Wikipedia, respectively, and the NEologd UT dictionary based on the mecab-ipadic-NEologd Neologism dictionary.
  
{{Note|Mozc works with {{Pkg|ibus}}. Please see also [[IBus]] for installation and configuration.}}
+
The following table shows the packages corresponding to certain combinations of the components and dictionaries; merged cells with multiple package names indicate split packages. Some of the packages are also available from the [[Unofficial user repository#pnsft-pur|pnsft-pur]] repository.
This package consists as follows:
 
{| class="wikitable" style="text-align:center;margin:0 2em auto"
 
!Package !! mozc !! description
 
|-
 
!Group
 
| mozc-im ||
 
|-
 
!rowspan="3" | Component
 
| mozc || Server part of the Mozc
 
|-
 
| ibus-mozc || IBus engine module
 
|-
 
| emacs-mozc || Mozc for Emacs (optional)
 
|}
 
 
 
{{Tip|[[#Variants on AUR|Unofficial plugins for the other IM frameworks are available]]}}
 
 
 
=== Unofficial user repository ===
 
 
 
There is an unofficial user repository of Mozc. Add the following into your {{ic|/etc/pacman.conf}}:
 
{{bc|<nowiki>
 
[pnsft-pur]
 
SigLevel = Optional TrustAll
 
Server = http://downloads.sourceforge.net/project/pnsft-aur/pur/$arch
 
</nowiki>}}
 
{{Note|This repo provides x86_64 packages only now.}}
 
And refresh package database.
 
You can choose to install packages specifying group name as follows:
 
# pacman -S mozc-im
 
Or, specify package names directly. For example:
 
# pacman -S mozc ibus-mozc emacs-mozc
 
 
 
=== Using PKGBUILD ===
 
 
 
You can install from AUR as follows.
 
 
 
First, get {{AUR|mozc}} tarball from AUR and edit the PKGBUILD if necessary.
 
$ wget https://aur.archlinux.org/packages/mo/mozc/mozc.tar.gz
 
$ tar xvf mozc.tar.gz
 
$ cd mozc
 
 
 
If you will be using mozc.el on Emacs, uncomment {{ic|_emacs_mozc}} line.
 
## If you will be using mozc.el on Emacs, uncomment below.
 
_emacs_mozc="yes"
 
 
 
=== Make available Mozc  ===
 
 
 
Restart X or IBus to enable use of Mozc.
 
 
 
=== Variants on AUR ===
 
  
Each packages consist as follows:
+
{| class="wikitable"
{| class="wikitable" style="text-align:center;margin:0 2em auto"
+
! !! Vanilla !! UT !! UT2 !! NEologd UT
!Package !! mozc !! mozc-svn !! mozc-ut !! mozc-fcitx !! description
 
|-
 
!Group
 
| mozc-im || mozc-im-svn || mozc-im || mozc-im ||
 
 
|-
 
|-
!rowspan="6" | Component
+
! Fcitx integration
| mozc || mozc-svn || mozc-ut || -- ||Server part of the Mozc
+
| rowspan="2" | {{Pkg|fcitx-mozc}}
 +
| rowspan="3" | {{AUR|fcitx-mozc-ut}}
 +
| rowspan="2" | {{AUR|fcitx-mozc-ut2}}
 +
| rowspan="3" | {{AUR|fcitx-mozc-neologd-ut}}<br />{{AUR|mozc-neologd-ut}}
 
|-
 
|-
| ibus-mozc || ibus-mozc-svn || ibus-mozc-ut || -- || IBus engine module (optional)
+
! rowspan="2" | Mozc core
 
|-
 
|-
| (uim-mozc) || uim-mozc-svn || uim-mozc-ut || -- || uim plugin module (optional)
+
| rowspan="3" | {{AUR|mozc}}<br />{{AUR|ibus-mozc}}<br />{{AUR|emacs-mozc}}
 +
| rowspan="4" | {{AUR|mozc-ut2}}<br />{{AUR|ibus-mozc-ut2}}<br />{{AUR|emacs-mozc-ut2}}<br />{{AUR|uim-mozc-ut2}}
 
|-
 
|-
| <small>''N/A''</small> || fcitx-mozc-svn || <small>''N/A''</small> || -- || Fcitx module (optional)
+
! IBus integration
 +
| ||
 
|-
 
|-
| emacs-mozc || emacs-mozc-svn || emacs-mozc-ut || -- || Mozc for Emacs (optional)
+
! Emacs integration
 +
| ||
 
|-
 
|-
| -- || -- || -- || mozc-fcitx || mozc-fcitx package (all in one)
+
! uim integration
 +
| {{AUR|uim-mozc}} || ||
 
|}
 
|}
  
==== uim-mozc ====
+
Some of the above packages also contain definitions at the top of their respective PKGBUILDs that can be altered to (de)activate certain features. Most notably, to build the emacs packages you need to uncomment the {{ic|_emacs_mozc}} line:
 +
## If you will be using mozc.el on Emacs, uncomment below.
 +
_emacs_mozc="yes"
 +
Likewise, you must also enable uim-mozc-ut2 manually to build it.
  
Though {{AUR|mozc}} adapts to only IBus input method framework, [http://code.google.com/p/macuim/ macuim] provides ''uim-mozc'' plugin. {{AUR|uim-mozc}} is for vanilla ''mozc'' and {{AUR|mozc-ut}}, {{AUR|mozc-svn}} can build ''uim-mozc'' itself (see [[Input Japanese using uim]]). You can install ''uim-mozc'' from [[#Unofficial user repository|unofficial user repository]] as well as vanilla ''mozc''.
+
Once Mozc is installed, you might need to restart X or your Input Method Framework before you can use it.
  
==== mozc-ut ====
+
== Configuration ==
  
{{AUR|mozc-ut}} comes with [http://www.geocities.jp/ep3797/mozc_01.html Mozc UT dictionary] and can build ''uim-mozc''. The dictionary adds over 350,000 words into original.
+
=== IBus ===
{{Note|
+
''See also [[IBus]] for IBus configuration.''
* Building ''mozc-ut'' requires long time to generate dictionary seed.
 
* ''mozc-ut'' can work with ''ibus-mozc'', ''emacs-mozc'' and ''uim-mozc'' of vanilla ''mozc''. That is, you don't have to build such as modules of ''mozc-ut'' by the use of [[#Unofficial user repository|unofficial user repository]].
 
}}
 
  
==== mozc-svn ====
+
If you use Mozc by default, set it via ''ibus-setup'':
 +
$ ibus-setup
 +
Choose ''Input Method'' tab and move ''Mozc'' to top of the list.
  
{{AUR|mozc-svn}} builds using the published svn repository instead of source tarball and can build ''uim-mozc'' and ''fcitx-mozc'' plugin. You should use vanilla ''mozc'' or ''mozc-ut'' unless you have any reason. This is exactly similar to ''mozc'' (published svn repository is not actually trunk) and run-time of makepkg of ''mozc-svn'' will be longer than ''mozc''.
+
You can switch input method by {{ic|Alt+Shift_L}} (by IBus default).
  
==== mozc-fcitx ====
+
=== uim ===
 +
''See also [[UIM]] for uim configuration.''
  
{{AUR|mozc-fcitx}} is all in one Mozc package dedicated to [[Fcitx]].
+
Configure uim preferences by running:
 +
$ uim-pref-gtk (Or, uim-pref-gtk3/uim-pref-qt4)
 +
which brings forth a GUI.
  
== Configuration ==
+
Choose your preferring input method as ''Default input method''.
 +
{{Note|Mozc will be not listed in ''Default input method'' at first time so you will need to add it into ''Enabled input methods'' to use.}}
  
''See also [[IBus]] for IBus configuration.''
+
{{Warning|You '''must''' run the following command whenever you upgrade or (re-)install '''uim'''.<br/>
 +
# uim-module-manager --register mozc}}
  
If you use Mozc by default, set it via ''ibus-setup'':
+
=== Fcitx ===
$ ibus-setup
+
''See also [[Fcitx]] for Fcitx configuration.''
Choose ''Input Method'' tab and move ''Mozc'' to top of the list.
 
  
You can switch input method by {{ic|Alt+Shift_L}} (by IBus default).
+
Open the configuration dialog of Fcitx by running:
 +
$ fcitx-configtool
 +
In the ''Input Method'' tab, click on the plus sign and choose Mozc from the list in the dialog. Depending on your configuration, you might need to disable the ''Only Show Current Language'' option for Mozc to be available. After confirming the dialog, you can activate Mozc as input method using the usual keyboard shortcuts.
  
 
=== Mozc for Emacs ===
 
=== Mozc for Emacs ===
Line 126: Line 88:
 
  Emacs*UseXIM: false
 
  Emacs*UseXIM: false
  
== Tips ==
+
== Tips and tricks ==
  
 
=== Confirming Mozc version which you are using now ===
 
=== Confirming Mozc version which you are using now ===
Line 140: Line 102:
 
=== Launching Mozc tools from command line ===
 
=== Launching Mozc tools from command line ===
  
The followings are commands to launch mozc tools.
+
The followings are commands to launch Mozc tools.
* Mozc property: {{ic|1=$ /usr/lib/mozc/mozc_tool --mode=config_dialog}}
+
* Mozc Settings: {{ic|1=$ /usr/lib/mozc/mozc_tool --mode=config_dialog}}
 
* Mozc Dictionary Tool: {{ic|1=$ /usr/lib/mozc/mozc_tool --mode=dictionary_tool}}
 
* Mozc Dictionary Tool: {{ic|1=$ /usr/lib/mozc/mozc_tool --mode=dictionary_tool}}
 
* Mozc Word Register: {{ic|1=$ /usr/lib/mozc/mozc_tool --mode=word_register_dialog}}
 
* Mozc Word Register: {{ic|1=$ /usr/lib/mozc/mozc_tool --mode=word_register_dialog}}
Line 149: Line 111:
 
=== Use CapsLock as Eisu_toggle key on ASCII layout keyboard ===
 
=== Use CapsLock as Eisu_toggle key on ASCII layout keyboard ===
  
All of the preset keymap styles of Mozc, command ''ToggleAlphanumericMode'' on ''Composition'' mode is assigned to {{ic|Eisu}} (Eisu_toggle), {{ic|Hiragana}}/{{ic|Katakana}} or {{ic|Muhenkan}} key, but the ASCII keyboard has none of them.
+
In all of the preset keymap styles of Mozc, the command ''Toggle alphanumeric mode'' on ''Composition'' mode is assigned to the {{ic|Eisu}} (Eisu_toggle), {{ic|Hiragana/Katakana}} or {{ic|Muhenkan}} key, but the ASCII keyboard has none of them.
  
One of the solution for it is to use CapsLock key as Eisu_toggle (Mozc does not recognize CapsLock key as of r124). The following is way to assign the Eisu_toggle to {{ic|CapsLock}} (without any modifier keys) and the Caps_Lock to {{ic|Shift+CapsLock}}, like OADG keyboard layout.
+
One solution for it is to use Caps Lock key as Eisu_toggle (Mozc does not recognize the Caps Lock key as of r124). The following is a way to assign Eisu_toggle to {{ic|Caps Lock}} (without any modifier keys) and Caps_Lock to {{ic|Shift+CapsLock}}, as on the OADG keyboard layout.
{{Warning|This way affects to desktop wide.}}
+
{{Warning|This will affect all applications.}}
  
Edit the {{ic|~/.Xmodmap}} as follows:
+
Edit {{ic|~/.Xmodmap}} as follows:
 
  keycode 66 = Eisu_toggle Caps_Lock
 
  keycode 66 = Eisu_toggle Caps_Lock
 
  clear Lock
 
  clear Lock
  
Then, restart X or run xmodmap to apply immediately:
+
Then, restart X or run ''xmodmap'' to apply the changes immediately:
 
  $ xmodmap ~/.Xmodmap
 
  $ xmodmap ~/.Xmodmap
  
Line 165: Line 127:
 
=== Building Mozc fails (process is killed) ===
 
=== Building Mozc fails (process is killed) ===
  
If build process is failed with like the following messages:
+
If the build process fails with an error message like the following:
 
  ...
 
  ...
 
  /bin/sh: line 1:  xxxx killed
 
  /bin/sh: line 1:  xxxx killed
Line 171: Line 133:
 
  make: *** [xxx/xxx...] error 137
 
  make: *** [xxx/xxx...] error 137
 
  ...
 
  ...
Make sure whether you have run out of memory.
+
Make sure you have not run out of memory.
  
=== New version of Mozc does not appear though I upgraded Mozc and restarted X or IBus (not rebooted) ===
+
=== New version of Mozc does not appear though I upgraded Mozc and restarted X or Input Method Framework (not rebooted) ===
  
Old version of Mozc may be still on your memory. Try to kill existing ''mozc_server'' process:
+
The old version of Mozc may be still on your memory. Try to kill the existing ''mozc_server'' process:
 
  $ killall mozc_server
 
  $ killall mozc_server

Latest revision as of 11:51, 25 April 2017

From the project home page:

Mozc is a Japanese Input Method Editor (IME) designed for multi-platform such as Android OS, Apple OS X, Chromium OS, GNU/Linux and Microsoft Windows. This OpenSource project originates from Google Japanese Input. […] Detailed differences between Google Japanese Input and Mozc are described in About Branding.

(In short, Mozc does not have equivalent conversion quality to Google Japanese Input).

Installation

Depending on your target setup, there are several available Mozc packages to choose from. Firstly, you will likely need to install both the Mozc core package and an integration for the Input Method Framework of your choice (such as Fcitx, IBus, or uim), though some Fcitx packages come bundled with the core. Secondly, there exist some unofficial dictionaries: The UT (discontinued) and UT2 dictionaries, which are combined from several sources with hit numbers coming from Google/Yahoo and Wikipedia, respectively, and the NEologd UT dictionary based on the mecab-ipadic-NEologd Neologism dictionary.

The following table shows the packages corresponding to certain combinations of the components and dictionaries; merged cells with multiple package names indicate split packages. Some of the packages are also available from the pnsft-pur repository.

Vanilla UT UT2 NEologd UT
Fcitx integration fcitx-mozc fcitx-mozc-utAUR fcitx-mozc-ut2AUR fcitx-mozc-neologd-utAUR
mozc-neologd-utAUR
Mozc core
mozcAUR
ibus-mozcAUR
emacs-mozcAUR
mozc-ut2AUR
ibus-mozc-ut2AUR
emacs-mozc-ut2AUR
uim-mozc-ut2AUR
IBus integration
Emacs integration
uim integration uim-mozcAUR

Some of the above packages also contain definitions at the top of their respective PKGBUILDs that can be altered to (de)activate certain features. Most notably, to build the emacs packages you need to uncomment the _emacs_mozc line:

## If you will be using mozc.el on Emacs, uncomment below.
_emacs_mozc="yes"

Likewise, you must also enable uim-mozc-ut2 manually to build it.

Once Mozc is installed, you might need to restart X or your Input Method Framework before you can use it.

Configuration

IBus

See also IBus for IBus configuration.

If you use Mozc by default, set it via ibus-setup:

$ ibus-setup

Choose Input Method tab and move Mozc to top of the list.

You can switch input method by Alt+Shift_L (by IBus default).

uim

See also UIM for uim configuration.

Configure uim preferences by running:

$ uim-pref-gtk (Or, uim-pref-gtk3/uim-pref-qt4)

which brings forth a GUI.

Choose your preferring input method as Default input method.

Note: Mozc will be not listed in Default input method at first time so you will need to add it into Enabled input methods to use.
Warning: You must run the following command whenever you upgrade or (re-)install uim.
# uim-module-manager --register mozc

Fcitx

See also Fcitx for Fcitx configuration.

Open the configuration dialog of Fcitx by running:

$ fcitx-configtool

In the Input Method tab, click on the plus sign and choose Mozc from the list in the dialog. Depending on your configuration, you might need to disable the Only Show Current Language option for Mozc to be available. After confirming the dialog, you can activate Mozc as input method using the usual keyboard shortcuts.

Mozc for Emacs

You can use mozc.el (mozc-mode) to input Japanese via LEIM (Library of Emacs Input Method). To use mozc-mode, write the following into your .emacs.d/init.el or some other file for Emacs customizing:

(require 'mozc)  ; or (load-file "/path/to/mozc.el")
(setq default-input-method "japanese-mozc")

mozc.el provides "overlay" mode in the styles of showing candidates (from mozc r77) which shows a candidate window in box style close to the point. If you want to use it by default, add the following:

(setq mozc-candidate-style 'overlay)

C-\ (toggle-input-method) enables and disables use of mozc-mode.

Disabling XIM on Emacs

When you are using input method on your desktop and assigning activation/deactivation of input method to C-SPC, you will be not able to use C-SPC/C-@ as set-mark-command on Emacs. To avoid this problem, add the following into your ~/.Xresources or ~/.Xdefaults. xim will be disabled on Emacs.

Emacs*UseXIM: false

Tips and tricks

Confirming Mozc version which you are using now

Type "ばーじょん" ("version") and convert it while activating Mozc. The version number of Mozc will be shown in the candidate list like follows:

ばーじょん
バージョン
ヴァージョン
ばーじょん
Mozc-1.6.1187.102  ⇐ Current version of Mozc
...

Launching Mozc tools from command line

The followings are commands to launch Mozc tools.

  • Mozc Settings: $ /usr/lib/mozc/mozc_tool --mode=config_dialog
  • Mozc Dictionary Tool: $ /usr/lib/mozc/mozc_tool --mode=dictionary_tool
  • Mozc Word Register: $ /usr/lib/mozc/mozc_tool --mode=word_register_dialog
  • Mozc Hand Writing: $ /usr/lib/mozc/mozc_tool --mode=hand_writing
  • Mozc Character Palette: $ /usr/lib/mozc/mozc_tool --mode=character_palette

Use CapsLock as Eisu_toggle key on ASCII layout keyboard

In all of the preset keymap styles of Mozc, the command Toggle alphanumeric mode on Composition mode is assigned to the Eisu (Eisu_toggle), Hiragana/Katakana or Muhenkan key, but the ASCII keyboard has none of them.

One solution for it is to use Caps Lock key as Eisu_toggle (Mozc does not recognize the Caps Lock key as of r124). The following is a way to assign Eisu_toggle to Caps Lock (without any modifier keys) and Caps_Lock to Shift+CapsLock, as on the OADG keyboard layout.

Warning: This will affect all applications.

Edit ~/.Xmodmap as follows:

keycode 66 = Eisu_toggle Caps_Lock
clear Lock

Then, restart X or run xmodmap to apply the changes immediately:

$ xmodmap ~/.Xmodmap

Troubleshooting

Building Mozc fails (process is killed)

If the build process fails with an error message like the following:

...
/bin/sh: line 1:  xxxx killed
...
make: *** [xxx/xxx...] error 137
...

Make sure you have not run out of memory.

New version of Mozc does not appear though I upgraded Mozc and restarted X or Input Method Framework (not rebooted)

The old version of Mozc may be still on your memory. Try to kill the existing mozc_server process:

$ killall mozc_server