====== Fcitx5のセットアップ - Ubuntu 25.10 ======

Ubuntu 25.10 (Questing Quokka)に日本語入力の環境をセットアップする手順を紹介します。

Ubuntuのインストール時に日本語を言語として選択した場合、デフォルトでも日本語が入力可能な状態になっていますが、あまり使い勝手がよくありません。
ここでは、もっと使いやすくて、おそらく最もよく使われているFcitx5とMozcの組み合わせを使えるようにします。


===== STEP 1: fcitx5-mozcパッケージのインストール =====

ターミナルで以下のコマンドを実行します。

<cli>
$ sudo apt update
$ sudo apt install fcitx5-mozc
</cli>

これだけでほとんどすべてのFcitx5とMozcを利用するために必要なパッケージがインストールされます。
しかし、この状態ではGTK2を利用するアプリケーションに対応していません。
追加でパッケージ__fcitx5-frontend-gtk2__をインストールしておきます。

<cli>
$ sudo apt install fcitx5-frontend-gtk2
</cli>

<note>
現在ではGTK2を利用するアプリケーションはそう多くはないので、fcitx5-frontend-gtk2が必須であるとまでは言えないかもしれません。
しかし、インストールしておかないと、いずれ何かしらのGTK2を利用する古風なアプリケーションを利用することになったとき、まともにキーボード入力ができなかったりしてとても不愉快な思いをすることになりますので、あらかじめインストールしておくことをおすすめします。((Lazarusというアプリケーションでこの問題に遭遇しました。なかなか原因が特定できずにかなりの精神と時間を浪費した経験があります。))
</note>


===== STEP 2: im-configの実行 =====

この時点ではまだ利用可能な状態になっていません。
''im-config''というコマンドを実行する必要があります。

<cli>
$ im-config
</cli>

設定のためのダイアログが表示されます。
基本的にすべてOKを選択していくだけですが、インプットメソッドのリストが表示されるところで「fcitx5」を選択します。

次のビデオは実際に操作しているところです。

{{ :mikanbox:linux:im-config_dialog_steps.webm?700 |im-configのやり方。}}

im-configを完了したら、この時点で一度システムを再起動します。

<note>
ログインし直すだけでも良い可能性があります。
もし試してだめだったらシステムの再起動をしてください。
</note>

再ログイン後、テキストエディタなどで日本語が入力が可能になっていることを確認してください。
''Ctrl + Space''で入力モードを切り替えられます。


===== STEP 3: キーボードの設定 =====

Fcitx5の初期設定では、英語キーボードが最初の状態になっています。

<figure>
<caption>**Fcitx設定ダイアログの初期設定** 英語キーボードが最初の状態になっている</caption>
{{:mikanbox:linux:fcitx5_setup_fcitx_configure_keyboard_default.png?500|初期状態のFcitx5の設定ダイアログ}}
</figure>

これを日本語キーボードが最初の状態になるように設定を変更します。

<note>
英語キーボードを使用している場合はこのセクションはスキップしてSTEP 4へ進んでください。
</note>

  - 画面右上のトレイからキーボードの形を下アイコンをクリックして、設定を選択します。
  - 設定ダイアログが表示されたら、「入力メソッド」タブで以下のように修正します。
    - 左側のリストから「キーボード - 英語 (US)」を取り除きます。
    - 右側のリストから「キーボード - 日本語」を選択して、左側のリストに追加します。
    - 左側のリストで、追加した「キーボード - 日本語」が「Mozc」より上に来るようにします。

<figure>
<caption>**設定を終えた状態のFcitx設定ダイアログ** 日本語キーボードが最初の状態になっている</caption>
{{:mikanbox:linux:fcitx5_setup_fcitx_configure_keyboard_done.png?500|設定後のFcitx5の設定ダイアログ}}
</figure>

次のビデオは実際に操作しているところです。

{{ :mikanbox:linux:fcitx5_setup_configure_fcitx5_steps.webm?700 |Fcitx5の設定ダイアログでキーボードの設定の変更する}}

また、Fcitx設定ダイアログの「グローバルオプション」タブで、好みによって日本語入力モードの切り替えに使用するキーを変更することもできます。

<figure>
<caption>**初期状態のFcitx設定ダイアログのグローバオプション** Control+スペースなどが切り替えに割り当てられています。</caption>
{{:mikanbox:linux:fcitx5_setup_fcitx_configure_global_options_default.png?500|}}
</figure>

例えば次のように変更することもできます。

<figure>
<caption>**変更後のFcitx設定ダイアログのグローバオプション** 全角/半角キーのみを使用するようにしてみました。</caption>
{{:mikanbox:linux:fcitx5_setup_fcitx_configure_global_options_done.png?500|}}
</figure>





===== STEP 4: kimpanelのインストール =====

Fcitx5の設定はSTEP 3までで完了していますが、GNOME環境ではまだ完全ではありません。
**__kimpanel__**というGNOMEの拡張をインストールする必要があります。
kimpanelが有効でないと、ログイン時にポップアップ通知が表示されます。

<figure>
<caption>ログイン時にkimpanelがインストールされていないと表示される通知メッセージ</caption>
{{:mikanbox:linux:gnome_kimpanel_missing_notification.png?800|ログイン時にkimpanelがインストールされていないと表示される通知メッセージ}}
</figure>

kimpanelをインストールする手順は少し複雑です。

まず、Firefoxに**__GNOME Shell integration__**という拡張機能をインストールする必要があります。
さらに、その拡張機能を有効にするためには**__gnome-browser-connector__**というパッケージがインストールされている必要があります。

必要な手順は以下のとおりです。

  - aptでパッケージ**__gnome-browser-connector__**をインストールする
  - Firefoxの拡張機能**__GNOME Shell integration__**をインストールする
  - GNOME Shell拡張機能のWebサイトで**__kimpanel__**をインストールする
  

==== gnome-browser-connectorのインストール ====

ターミナルで次のコマンドを実行します。

<cli>
$ sudo apt install gnome-browser-connector
</cli>


==== GNOME Shell integrationのインストール ====

  - Firefoxを起動して、メニュー**☰**から「拡張機能とテーマ」を選択します。
  - 「アドンオンを検索」のテキストボックスに「gnome shell integration」と入力します。
  - 検索結果から、作成者「Yuri Konotopov」の「GNOME Shell integration」を選択します。
  - 「インストール」をクリックします。

<figure>
<caption>「アドンオンを検索」のテキストボックスに「gnome shell integration」と入力した結果</caption>
{{:mikanbox:linux:firefox_extension_gnome_shell_integration_search_results_marker.png?800|「gnome shell integration」の検索結果}}
</figure>

<figure>
<caption>作成者「Yuri Konotopov」の「GNOME Shell integration」のページ</caption>
{{:mikanbox:linux:firefox_extension_gnome_shell_integration_marker.png?800|「GNOME Shell integration」のページ}}
</figure>


==== kimpanelのインストール ====

kimpanelのインストール手順は次のとおりです。

  - Firefoxのツールバーにある拡張機能のボタンから「GNOME Shell integration」を選択する。
  - [[https://extensions.gnome.org|GNOME Shell 拡張機能のWebサイト]]に移動するので、「拡張機能を選択...」のテキストボックスに「kimpanel」と入力する。
  - 検索結果から「Input Method Panel <sub>by csslayer</sub>」を選択する。
  - 右側の「॥|OFF」をクリックする。
  - 「インストールしますか？」と表示されたら、「インストール」を選択する。

テキストエディタなどで日本語が入力できることを確認します。

このとき、日本語入力状態になっているとき、画面右上のトレイのアイコンが次のようになっているならば、kimpanelが正しく機能しています。

{{:mikanbox:linux:fcitx5_setup_kimpanel_enabled.png?|kimpanelが有効}}

次のようになっていたら、kimpanelが機能していません。

{{:mikanbox:linux:fcitx5_setup_kimpanel_disabled.png?|kimpanelが無効}}


==== kimpanelのインストールのまとめ ====

次のビデオはkimpanelをインストールを最初から通してやっている様子です。

{{ :mikanbox:linux:fcitx5_setup_install_kimpanel_through.webm?800 |kimpanelのインストールを最初から通してやっている様子}}


===== 未解決の問題 =====
kimpanelが有効であるにもかかわらずログイン時にポップアップ通知が表示される場合があります。

<del>その場合、im-configで一度 none にしてから、再度 fcitx5 としたりすることで解決することがあります。</del>
->これは誤りで、こんなことをしても意味がないしやらないほうが良いです。

どのような状況で発生するのかも、確実な対処方法もまだわかっていません。