Fcitx - User contributions [en]

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:31:45Z

Matrikslee:

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

== 重新排序输入法 ==
在 Kirigami 2 版本中，用左侧的手柄拖放项目。
在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏中的上移或下移按钮。

== 更改输入法切换快捷键 ==
转到全局设置并检查那里的快捷键配置。

如果您想要更多自定义功能，您可能还需要检查“输入法选择器”插件。

== 更改候选窗口字体大小 ==
如果您使用 Kimpanel，则需要从 Kimpanel 自己的配置 UI 中找到字体选项，该选项无法从 fcitx5-configtool 访问。
如果您使用的是经典 UI，您可以转到插件选项卡或单击“配置插件...”，然后单击“经典用户界面”的配置按钮。

= Gallery =
== 基于 Kirigami 2 的 UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== 基于 Qt Widgets 的 UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/9/zh-cn

2024-03-18T03:31:45Z

Matrikslee:

= Gallery =
== 基于 Kirigami 2 的 UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:31:28Z

Matrikslee:

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

== 重新排序输入法 ==
在 Kirigami 2 版本中，用左侧的手柄拖放项目。
在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏中的上移或下移按钮。

== 更改输入法切换快捷键 ==
转到全局设置并检查那里的快捷键配置。

如果您想要更多自定义功能，您可能还需要检查“输入法选择器”插件。

== 更改候选窗口字体大小 ==
如果您使用 Kimpanel，则需要从 Kimpanel 自己的配置 UI 中找到字体选项，该选项无法从 fcitx5-configtool 访问。
如果您使用的是经典 UI，您可以转到插件选项卡或单击“配置插件...”，然后单击“经典用户界面”的配置按钮。

= Gallery =

== 基于 Kirigami 2 的 UI ==

[[File:Configtool Kirigami 2 UI.png|400px]]

== 基于 Qt Widgets 的 UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/9/zh-cn

2024-03-18T03:31:28Z

Matrikslee:

= Gallery =

== 基于 Kirigami 2 的 UI ==

[[File:Configtool Kirigami 2 UI.png|400px]]

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:30:38Z

Matrikslee: Created page with "== 基于 Qt Widgets 的 UI == 400px"

Translations:Configtool (Fcitx 5)/10/zh-cn

2024-03-18T03:30:38Z

Matrikslee: Created page with "== 基于 Qt Widgets 的 UI == 400px"

== 基于 Qt Widgets 的 UI ==
[[File:Configtool QWidgets UI.png|400px]]

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:30:29Z

Matrikslee: Created page with "= Gallery = == 基于 Kirigami 2 的 UI == 400px"

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

== 重新排序输入法 ==
在 Kirigami 2 版本中，用左侧的手柄拖放项目。
在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏中的上移或下移按钮。

== 更改输入法切换快捷键 ==
转到全局设置并检查那里的快捷键配置。

如果您想要更多自定义功能，您可能还需要检查“输入法选择器”插件。

== 更改候选窗口字体大小 ==
如果您使用 Kimpanel，则需要从 Kimpanel 自己的配置 UI 中找到字体选项，该选项无法从 fcitx5-configtool 访问。
如果您使用的是经典 UI，您可以转到插件选项卡或单击“配置插件...”，然后单击“经典用户界面”的配置按钮。

= Gallery =
== 基于 Kirigami 2 的 UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/9/zh-cn

2024-03-18T03:30:29Z

Matrikslee: Created page with "= Gallery = == 基于 Kirigami 2 的 UI == 400px"

= Gallery =
== 基于 Kirigami 2 的 UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:30:12Z

Matrikslee: Created page with "== 更改候选窗口字体大小 == 如果您使用 Kimpanel，则需要从 Kimpanel 自己的配置 UI 中找到字体选项，该选项无法从 fcitx5-configtool 访问。..."

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

== 重新排序输入法 ==
在 Kirigami 2 版本中，用左侧的手柄拖放项目。
在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏中的上移或下移按钮。

== 更改输入法切换快捷键 ==
转到全局设置并检查那里的快捷键配置。

如果您想要更多自定义功能，您可能还需要检查“输入法选择器”插件。

== 更改候选窗口字体大小 ==
如果您使用 Kimpanel，则需要从 Kimpanel 自己的配置 UI 中找到字体选项，该选项无法从 fcitx5-configtool 访问。
如果您使用的是经典 UI，您可以转到插件选项卡或单击“配置插件...”，然后单击“经典用户界面”的配置按钮。

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/8/zh-cn

2024-03-18T03:30:11Z

== 更改候选窗口字体大小 ==
如果您使用 Kimpanel，则需要从 Kimpanel 自己的配置 UI 中找到字体选项，该选项无法从 fcitx5-configtool 访问。
如果您使用的是经典 UI，您可以转到插件选项卡或单击“配置插件...”，然后单击“经典用户界面”的配置按钮。

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:29:59Z

Matrikslee: Created page with "如果您想要更多自定义功能，您可能还需要检查“输入法选择器”插件。"

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

== 重新排序输入法 ==
在 Kirigami 2 版本中，用左侧的手柄拖放项目。
在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏中的上移或下移按钮。

== 更改输入法切换快捷键 ==
转到全局设置并检查那里的快捷键配置。

如果您想要更多自定义功能，您可能还需要检查“输入法选择器”插件。

== Changing candidate window font size ==
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/7/zh-cn

2024-03-18T03:29:59Z

Matrikslee: Created page with "如果您想要更多自定义功能，您可能还需要检查“输入法选择器”插件。"

如果您想要更多自定义功能，您可能还需要检查“输入法选择器”插件。

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:29:43Z

Matrikslee: Created page with "== 更改输入法切换快捷键 == 转到全局设置并检查那里的快捷键配置。"

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

== 重新排序输入法 ==
在 Kirigami 2 版本中，用左侧的手柄拖放项目。
在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏中的上移或下移按钮。

== 更改输入法切换快捷键 ==
转到全局设置并检查那里的快捷键配置。

You may also want to check the '''Input method selector''' addon if you want more customization.

== Changing candidate window font size ==
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/6/zh-cn

2024-03-18T03:29:43Z

Matrikslee: Created page with "== 更改输入法切换快捷键 == 转到全局设置并检查那里的快捷键配置。"

== 更改输入法切换快捷键 ==
转到全局设置并检查那里的快捷键配置。

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:28:35Z

Matrikslee: Created page with "== 重新排序输入法 == 在 Kirigami 2 版本中，用左侧的手柄拖放项目。在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏..."

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

== 重新排序输入法 ==
在 Kirigami 2 版本中，用左侧的手柄拖放项目。
在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏中的上移或下移按钮。

== Change the key to switch input methods ==
Go to global options and check the hotkey configuration there.

You may also want to check the '''Input method selector''' addon if you want more customization.

== Changing candidate window font size ==
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/5/zh-cn

2024-03-18T03:28:35Z

== 重新排序输入法 ==
在 Kirigami 2 版本中，用左侧的手柄拖放项目。
在 Qt Widgets 版本中，单击左侧面板中的输入法，然后单击中间栏中的上移或下移按钮。

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:28:10Z

Matrikslee: Created page with "== 移除输入法 == 在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或..."

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

== Reordering input methods ==
In Kirigami 2 version, drag and drop the item with the handle on the left.
In Qt Widgets version, click on the input method from the panel on the left, then click move up or move down button in the middle column.

== Change the key to switch input methods ==
Go to global options and check the hotkey configuration there.

You may also want to check the '''Input method selector''' addon if you want more customization.

== Changing candidate window font size ==
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/4/zh-cn

2024-03-18T03:28:10Z

== 移除输入法 ==
在 Kirigami 2 版本中，单击输入法项末尾的删除按钮。
在 Qt Widgets 版本中，从左侧面板中单击输入法，然后双击，或单击中间列中的删除按钮（向右箭头）。

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:27:43Z

Matrikslee: Created page with "尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删..."

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

== Remove input methods ==
In Kirigami 2 version, click the remove button at the end of the input method item.
In Qt Widgets version, click input method from the panel on the left, then either double click, or click the remove button (right arrow) in the middle column.

== Reordering input methods ==
In Kirigami 2 version, drag and drop the item with the handle on the left.
In Qt Widgets version, click on the input method from the panel on the left, then click move up or move down button in the middle column.

== Change the key to switch input methods ==
Go to global options and check the hotkey configuration there.

You may also want to check the '''Input method selector''' addon if you want more customization.

== Changing candidate window font size ==
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/3/zh-cn

2024-03-18T03:27:43Z

尽管 Fcitx 5 会根据您的系统区域设置和键盘布局进行一些基本配置，但您可能仍然希望通过 <code>fcitx5-configtool</code> 检查并添加或删除输入法以满足您自己的需求。检查 [[Special:myLanguage/Input method engines|输入法引擎]] 可用于 Fcitx 5 的输入法引擎。

= 常见用法 =

==添加新的输入法==

在 Kirigami 2 版本中，点击右下角的“添加输入法...”按钮，选择要添加的输入法。
在 Qt Widgets 版本中，从右侧面板中单击输入法，然后双击，或单击中间栏中的添加按钮（向左箭头）。

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:26:55Z

Matrikslee: Created page with "Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。"

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

Although Fcitx 5 will do some basic configuration based on your system locale and keyboard layout, you may still want to check and add or remove input method via <code>fcitx5-configtool</code> to fit your own needs. Check [[Special:myLanguage/Input method engines|Input method engines]] for the input method engines that are available for Fcitx 5.
= Common usage =
== Adding new input method ==
In Kirigami 2 version, click "Add Input Method..." button at lower right corner, and select input method to add.
In Qt Widgets version, click input method from the panel on the right, then either double click, or click the add button (left arrow) in the middle column.

== Remove input methods ==
In Kirigami 2 version, click the remove button at the end of the input method item.
In Qt Widgets version, click input method from the panel on the left, then either double click, or click the remove button (right arrow) in the middle column.

== Reordering input methods ==
In Kirigami 2 version, drag and drop the item with the handle on the left.
In Qt Widgets version, click on the input method from the panel on the left, then click move up or move down button in the middle column.

== Change the key to switch input methods ==
Go to global options and check the hotkey configuration there.

You may also want to check the '''Input method selector''' addon if you want more customization.

== Changing candidate window font size ==
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/2/zh-cn

2024-03-18T03:26:55Z

Fcitx 5 附带的命令 <code>fcitx5-configtool</code> 实际上是一个脚本，它将自动检测您的桌面环境并启动 fcitx5-configtool 包中相应的实现。

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:26:44Z

Matrikslee: Created page with "[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实..."

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

The command <code>fcitx5-configtool</code> that comes with Fcitx 5 is actually a script that will automatically detect your desktop environment and launch the corresponding implementation within fcitx5-configtool package.

Although Fcitx 5 will do some basic configuration based on your system locale and keyboard layout, you may still want to check and add or remove input method via <code>fcitx5-configtool</code> to fit your own needs. Check [[Special:myLanguage/Input method engines|Input method engines]] for the input method engines that are available for Fcitx 5.
= Common usage =
== Adding new input method ==
In Kirigami 2 version, click "Add Input Method..." button at lower right corner, and select input method to add.
In Qt Widgets version, click input method from the panel on the right, then either double click, or click the add button (left arrow) in the middle column.

== Remove input methods ==
In Kirigami 2 version, click the remove button at the end of the input method item.
In Qt Widgets version, click input method from the panel on the left, then either double click, or click the remove button (right arrow) in the middle column.

== Reordering input methods ==
In Kirigami 2 version, drag and drop the item with the handle on the left.
In Qt Widgets version, click on the input method from the panel on the left, then click move up or move down button in the middle column.

== Change the key to switch input methods ==
Go to global options and check the hotkey configuration there.

You may also want to check the '''Input method selector''' addon if you want more customization.

== Changing candidate window font size ==
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/1/zh-cn

2024-03-18T03:26:44Z

[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] 是一个基于 Qt 的 GUI 工具，为 Fcitx 5 提供用户友好的配置界面。它有两种不同的实现，一种是基于 QWidget 的，可以通过 fcitx5-config-qt 访问，或者基于KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2]的, 可以在 Plasma 系统设置中找到它。尽管它们具有不同的用户界面，但功能是相同的。

Configtool (Fcitx 5)/zh-cn

2024-03-18T03:25:27Z

Matrikslee: Created page with "配置工具(Fcitx 5)"

<languages />
[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] is a Qt-based GUI tool that provides user friendly configuration interface for Fcitx 5. It comes with two different implemenation, QWidget based one, which is accessible via fcitx5-config-qt, or KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2] based one, which can be found with in Plasma systemsettings. Though they have different user interface, the functionality is same.

The command <code>fcitx5-configtool</code> that comes with Fcitx 5 is actually a script that will automatically detect your desktop environment and launch the corresponding implementation within fcitx5-configtool package.

Although Fcitx 5 will do some basic configuration based on your system locale and keyboard layout, you may still want to check and add or remove input method via <code>fcitx5-configtool</code> to fit your own needs. Check [[Special:myLanguage/Input method engines|Input method engines]] for the input method engines that are available for Fcitx 5.
= Common usage =
== Adding new input method ==
In Kirigami 2 version, click "Add Input Method..." button at lower right corner, and select input method to add.
In Qt Widgets version, click input method from the panel on the right, then either double click, or click the add button (left arrow) in the middle column.

== Remove input methods ==
In Kirigami 2 version, click the remove button at the end of the input method item.
In Qt Widgets version, click input method from the panel on the left, then either double click, or click the remove button (right arrow) in the middle column.

== Reordering input methods ==
In Kirigami 2 version, drag and drop the item with the handle on the left.
In Qt Widgets version, click on the input method from the panel on the left, then click move up or move down button in the middle column.

== Change the key to switch input methods ==
Go to global options and check the hotkey configuration there.

You may also want to check the '''Input method selector''' addon if you want more customization.

== Changing candidate window font size ==
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery =
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI ==
[[File:Configtool QWidgets UI.png|400px]]

Translations:Configtool (Fcitx 5)/Page display title/zh-cn

2024-03-18T03:25:27Z

Matrikslee: Created page with "配置工具(Fcitx 5)"

配置工具(Fcitx 5)

Configtool (Fcitx 5)

2024-03-18T03:25:03Z

Matrikslee: Marked this version for translation

<languages />
<translate>

[https://pkgs.org/search/?q=fcitx5-configtool fcitx5-configtool] is a Qt-based GUI tool that provides user friendly configuration interface for Fcitx 5. It comes with two different implemenation, QWidget based one, which is accessible via fcitx5-config-qt, or KCM/[https://api.kde.org/frameworks/kirigami/html/index.html Kirigami2] based one, which can be found with in Plasma systemsettings. Though they have different user interface, the functionality is same.


The command <code>fcitx5-configtool</code> that comes with Fcitx 5 is actually a script that will automatically detect your desktop environment and launch the corresponding implementation within fcitx5-configtool package.

Although Fcitx 5 will do some basic configuration based on your system locale and keyboard layout, you may still want to check and add or remove input method via <code>fcitx5-configtool</code> to fit your own needs. Check [[Special:myLanguage/Input method engines|Input method engines]] for the input method engines that are available for Fcitx 5.
= Common usage = 
== Adding new input method ==
In Kirigami 2 version, click "Add Input Method..." button at lower right corner, and select input method to add.
In Qt Widgets version, click input method from the panel on the right, then either double click, or click the add button (left arrow) in the middle column.

== Remove input methods == 
In Kirigami 2 version, click the remove button at the end of the input method item.
In Qt Widgets version, click input method from the panel on the left, then either double click, or click the remove button (right arrow) in the middle column.

== Reordering input methods == 
In Kirigami 2 version, drag and drop the item with the handle on the left.
In Qt Widgets version, click on the input method from the panel on the left, then click move up or move down button in the middle column.

== Change the key to switch input methods == 
Go to global options and check the hotkey configuration there.


You may also want to check the '''Input method selector''' addon if you want more customization.

== Changing candidate window font size == 
If you are using Kimpanel, you need to find font option from Kimpanel's own configuration UI, such option is not accessible from fcitx5-configtool.
If you are using Classic UI, you may go to addons tab or click '''Configure addons...''', then click on the configure button for '''Classic User Interface'''.

= Gallery = 
== Kirigami 2 based UI ==
[[File:Configtool Kirigami 2 UI.png|400px]]

== Qt Widgets based UI == 
[[File:Configtool QWidgets UI.png|400px]]
</translate>

Setup Fcitx 5/zh-cn

2024-03-18T03:24:24Z

Matrikslee: Created page with "参考配置工具(Fcitx 5)."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

请'''注意'''，其语法与 shell 脚本不同。

== ~/.config/plasma-workspace/env/*.sh ==
仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im.sh</code> 并将代码片段与[[Special：myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]]。

== 其他不太常见的设置==
还有一些其他变量可能对某些应用程序有用。
=== SDL_IM_MODULE ===
将值设置为 fcitx。只有 SDL2 需要这个。SDL1 使用 XIM。
=== GLFW_IM_MODULE ===
这是仅由[https://github.com/kovidgoyal/kitty/kitty]使用的变量。您需要将其设置为“GLFW_IM_MODULE=ibus”。
=== Binary Qt application ===
由于 Qt 5 不支持 XIM，并且它仅捆绑 ibus im 模块，因此您可能需要为不使用系统 Qt 库的 Qt 应用程序设置“QT_IM_MODULE=ibus”。（它可能仍然无法工作，因为某些 Qt 应用程序甚至没有捆绑任何 IM 模块）。

= DBus =
在大多数附带 systemd 的发行版上，这应该不再是问题。但是如果您使用一些所谓的“systemd”free 的发行版，您可能需要自己启动DBus并设置相关的环境变量。通常，这可以通过在启动脚本中添加如下行来完成。例如，如果您使用的是 X11，则为 ~/.xprofile。此外，您还需要确保此语法适用于您的登录 shell。

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= 配置 Fcitx 5 =

参考 [[Special:myLanguage/Configtool (Fcitx 5)|配置工具(Fcitx 5)]].

Translations:Setup Fcitx 5/41/zh-cn

2024-03-18T03:24:24Z

Matrikslee: Created page with "参考配置工具(Fcitx 5)."

参考 [[Special:myLanguage/Configtool (Fcitx 5)|配置工具(Fcitx 5)]].

Setup Fcitx 5/zh-cn

2024-03-18T03:24:12Z

Matrikslee: Created page with "= 配置 Fcitx 5 ="

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

请'''注意'''，其语法与 shell 脚本不同。

== ~/.config/plasma-workspace/env/*.sh ==
仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im.sh</code> 并将代码片段与[[Special：myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]]。

== 其他不太常见的设置==
还有一些其他变量可能对某些应用程序有用。
=== SDL_IM_MODULE ===
将值设置为 fcitx。只有 SDL2 需要这个。SDL1 使用 XIM。
=== GLFW_IM_MODULE ===
这是仅由[https://github.com/kovidgoyal/kitty/kitty]使用的变量。您需要将其设置为“GLFW_IM_MODULE=ibus”。
=== Binary Qt application ===
由于 Qt 5 不支持 XIM，并且它仅捆绑 ibus im 模块，因此您可能需要为不使用系统 Qt 库的 Qt 应用程序设置“QT_IM_MODULE=ibus”。（它可能仍然无法工作，因为某些 Qt 应用程序甚至没有捆绑任何 IM 模块）。

= DBus =
在大多数附带 systemd 的发行版上，这应该不再是问题。但是如果您使用一些所谓的“systemd”free 的发行版，您可能需要自己启动DBus并设置相关的环境变量。通常，这可以通过在启动脚本中添加如下行来完成。例如，如果您使用的是 X11，则为 ~/.xprofile。此外，您还需要确保此语法适用于您的登录 shell。

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= 配置 Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/40/zh-cn

2024-03-18T03:24:12Z

Matrikslee: Created page with "= 配置 Fcitx 5 ="

= 配置 Fcitx 5 =

Setup Fcitx 5/zh-cn

2024-03-18T03:24:07Z

Matrikslee: Created page with "= DBus = 在大多数附带 systemd 的发行版上，这应该不再是问题。但是如果您使用一些所谓的“systemd”free 的发行版，您可能需要自己启..."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

请'''注意'''，其语法与 shell 脚本不同。

== ~/.config/plasma-workspace/env/*.sh ==
仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im.sh</code> 并将代码片段与[[Special：myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]]。

== 其他不太常见的设置==
还有一些其他变量可能对某些应用程序有用。
=== SDL_IM_MODULE ===
将值设置为 fcitx。只有 SDL2 需要这个。SDL1 使用 XIM。
=== GLFW_IM_MODULE ===
这是仅由[https://github.com/kovidgoyal/kitty/kitty]使用的变量。您需要将其设置为“GLFW_IM_MODULE=ibus”。
=== Binary Qt application ===
由于 Qt 5 不支持 XIM，并且它仅捆绑 ibus im 模块，因此您可能需要为不使用系统 Qt 库的 Qt 应用程序设置“QT_IM_MODULE=ibus”。（它可能仍然无法工作，因为某些 Qt 应用程序甚至没有捆绑任何 IM 模块）。

= DBus =
在大多数附带 systemd 的发行版上，这应该不再是问题。但是如果您使用一些所谓的“systemd”free 的发行版，您可能需要自己启动DBus并设置相关的环境变量。通常，这可以通过在启动脚本中添加如下行来完成。例如，如果您使用的是 X11，则为 ~/.xprofile。此外，您还需要确保此语法适用于您的登录 shell。

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/39/zh-cn

2024-03-18T03:24:07Z

= DBus =
在大多数附带 systemd 的发行版上，这应该不再是问题。但是如果您使用一些所谓的“systemd”free 的发行版，您可能需要自己启动DBus并设置相关的环境变量。通常，这可以通过在启动脚本中添加如下行来完成。例如，如果您使用的是 X11，则为 ~/.xprofile。此外，您还需要确保此语法适用于您的登录 shell。

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

Setup Fcitx 5/zh-cn

2024-03-18T03:23:22Z

Matrikslee: Created page with "== 其他不太常见的设置== 还有一些其他变量可能对某些应用程序有用。 === SDL_IM_MODULE === 将值设置为 fcitx。只有 SDL2 需要这个。SDL1 使..."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

请'''注意'''，其语法与 shell 脚本不同。

== ~/.config/plasma-workspace/env/*.sh ==
仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im.sh</code> 并将代码片段与[[Special：myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]]。

== 其他不太常见的设置==
还有一些其他变量可能对某些应用程序有用。
=== SDL_IM_MODULE ===
将值设置为 fcitx。只有 SDL2 需要这个。SDL1 使用 XIM。
=== GLFW_IM_MODULE ===
这是仅由[https://github.com/kovidgoyal/kitty/kitty]使用的变量。您需要将其设置为“GLFW_IM_MODULE=ibus”。
=== Binary Qt application ===
由于 Qt 5 不支持 XIM，并且它仅捆绑 ibus im 模块，因此您可能需要为不使用系统 Qt 库的 Qt 应用程序设置“QT_IM_MODULE=ibus”。（它可能仍然无法工作，因为某些 Qt 应用程序甚至没有捆绑任何 IM 模块）。

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/38/zh-cn

2024-03-18T03:23:22Z

== 其他不太常见的设置==
还有一些其他变量可能对某些应用程序有用。
=== SDL_IM_MODULE ===
将值设置为 fcitx。只有 SDL2 需要这个。SDL1 使用 XIM。
=== GLFW_IM_MODULE ===
这是仅由[https://github.com/kovidgoyal/kitty/kitty]使用的变量。您需要将其设置为“GLFW_IM_MODULE=ibus”。
=== Binary Qt application ===
由于 Qt 5 不支持 XIM，并且它仅捆绑 ibus im 模块，因此您可能需要为不使用系统 Qt 库的 Qt 应用程序设置“QT_IM_MODULE=ibus”。（它可能仍然无法工作，因为某些 Qt 应用程序甚至没有捆绑任何 IM 模块）。

Setup Fcitx 5/zh-cn

2024-03-18T03:22:21Z

Matrikslee:

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

请'''注意'''，其语法与 shell 脚本不同。

== ~/.config/plasma-workspace/env/*.sh ==
仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im.sh</code> 并将代码片段与[[Special：myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]]。

== Other less common setup ==
There are some other variable that might be useful certain applications.
=== SDL_IM_MODULE ===
Set the value to fcitx. Only SDL2 requires this. SDL1 uses XIM.
=== GLFW_IM_MODULE ===
This is a variable only used by [https://github.com/kovidgoyal/kitty/ kitty]. You need to set it to `GLFW_IM_MODULE=ibus`.
=== Binary Qt application ===
Due to Qt 5 does not support XIM, and it only bundles ibus im module, you may want to set `QT_IM_MODULE=ibus` for Qt application that does not use your system Qt library. (It may still not work because certain Qt application does not even bundle any im module).

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/37/zh-cn

2024-03-18T03:22:20Z

Matrikslee:

== ~/.config/plasma-workspace/env/*.sh ==
仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im.sh</code> 并将代码片段与[[Special：myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]]。

Setup Fcitx 5/zh-cn

2024-03-18T03:22:06Z

Matrikslee: Created page with "== ~/.config/plasma-workspace/env/*.sh == 仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im..."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

请'''注意'''，其语法与 shell 脚本不同。

== ~/.config/plasma-workspace/env/*.sh ==
仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im.sh</code> 并将代码片段与[[特别：myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]]。

== Other less common setup ==
There are some other variable that might be useful certain applications.
=== SDL_IM_MODULE ===
Set the value to fcitx. Only SDL2 requires this. SDL1 uses XIM.
=== GLFW_IM_MODULE ===
This is a variable only used by [https://github.com/kovidgoyal/kitty/ kitty]. You need to set it to `GLFW_IM_MODULE=ibus`.
=== Binary Qt application ===
Due to Qt 5 does not support XIM, and it only bundles ibus im module, you may want to set `QT_IM_MODULE=ibus` for Qt application that does not use your system Qt library. (It may still not work because certain Qt application does not even bundle any im module).

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/37/zh-cn

2024-03-18T03:22:06Z

== ~/.config/plasma-workspace/env/*.sh ==
仅适用于 Plasma 桌面的 env 脚本位置，您需要创建自己的 .sh 文件，例如 <code>~/.config/plasma-workspace/env/im.sh</code> 并将代码片段与[[特别：myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]]。

Setup Fcitx 5/zh-cn

2024-03-18T03:21:36Z

Matrikslee: Created page with "请'''注意'''，其语法与 shell 脚本不同。"

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

请'''注意'''，其语法与 shell 脚本不同。

== ~/.config/plasma-workspace/env/*.sh ==
A env script location that only works for Plasma desktop, you need to create your own .sh file, e.g. <code>~/.config/plasma-workspace/env/im.sh</code> and put the code snippet same as [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|login shell]].

== Other less common setup ==
There are some other variable that might be useful certain applications.
=== SDL_IM_MODULE ===
Set the value to fcitx. Only SDL2 requires this. SDL1 uses XIM.
=== GLFW_IM_MODULE ===
This is a variable only used by [https://github.com/kovidgoyal/kitty/ kitty]. You need to set it to `GLFW_IM_MODULE=ibus`.
=== Binary Qt application ===
Due to Qt 5 does not support XIM, and it only bundles ibus im module, you may want to set `QT_IM_MODULE=ibus` for Qt application that does not use your system Qt library. (It may still not work because certain Qt application does not even bundle any im module).

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/36/zh-cn

2024-03-18T03:21:36Z

Matrikslee: Created page with "请'''注意'''，其语法与 shell 脚本不同。"

请'''注意'''，其语法与 shell 脚本不同。

Setup Fcitx 5/zh-cn

2024-03-18T03:21:20Z

Matrikslee: Created page with "如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。 <nowiki>XMODIFIERS DEFAULT=\@im=fcitx GTK_IM_MO..."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

Please '''NOTE''' that the syntax is different from shell script.

== ~/.config/plasma-workspace/env/*.sh ==
A env script location that only works for Plasma desktop, you need to create your own .sh file, e.g. <code>~/.config/plasma-workspace/env/im.sh</code> and put the code snippet same as [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|login shell]].

== Other less common setup ==
There are some other variable that might be useful certain applications.
=== SDL_IM_MODULE ===
Set the value to fcitx. Only SDL2 requires this. SDL1 uses XIM.
=== GLFW_IM_MODULE ===
This is a variable only used by [https://github.com/kovidgoyal/kitty/ kitty]. You need to set it to `GLFW_IM_MODULE=ibus`.
=== Binary Qt application ===
Due to Qt 5 does not support XIM, and it only bundles ibus im module, you may want to set `QT_IM_MODULE=ibus` for Qt application that does not use your system Qt library. (It may still not work because certain Qt application does not even bundle any im module).

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/35/zh-cn

2024-03-18T03:21:20Z

如果您知道它适用于您的系统，您可以将以下代码片段添加到您的 <code>~/.pam_environment</code> 中。
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

Setup Fcitx 5/zh-cn

2024-03-18T03:21:05Z

Matrikslee: Created page with "== pam_env.so == 由于以下原因，这是一个过时的解决方案： * pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。 * 某些发行版..."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

If you know it works for your system, you can put following snippet to your <code>~/.pam_environment</code>.
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

Please '''NOTE''' that the syntax is different from shell script.

== ~/.config/plasma-workspace/env/*.sh ==
A env script location that only works for Plasma desktop, you need to create your own .sh file, e.g. <code>~/.config/plasma-workspace/env/im.sh</code> and put the code snippet same as [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|login shell]].

== Other less common setup ==
There are some other variable that might be useful certain applications.
=== SDL_IM_MODULE ===
Set the value to fcitx. Only SDL2 requires this. SDL1 uses XIM.
=== GLFW_IM_MODULE ===
This is a variable only used by [https://github.com/kovidgoyal/kitty/ kitty]. You need to set it to `GLFW_IM_MODULE=ibus`.
=== Binary Qt application ===
Due to Qt 5 does not support XIM, and it only bundles ibus im module, you may want to set `QT_IM_MODULE=ibus` for Qt application that does not use your system Qt library. (It may still not work because certain Qt application does not even bundle any im module).

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/34/zh-cn

2024-03-18T03:21:05Z

== pam_env.so ==
由于以下原因，这是一个过时的解决方案：
* pam 自 1.5.0 起弃用用户级别配置 <code>~/.pam_environment</code>。
* 某些发行版未在其 pam 配置中启用 pam_env。

Setup Fcitx 5/zh-cn

2024-03-18T03:20:48Z

Matrikslee: Created page with "语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>： <nowiki>..."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
This is an obsolete solution for following reasons:
* pam deprecate user level configuration <code>~/.pam_environment</code> since 1.5.0.
* Some distribution does not enable pam_env in their pam configuration.

If you know it works for your system, you can put following snippet to your <code>~/.pam_environment</code>.
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

Please '''NOTE''' that the syntax is different from shell script.

== ~/.config/plasma-workspace/env/*.sh ==
A env script location that only works for Plasma desktop, you need to create your own .sh file, e.g. <code>~/.config/plasma-workspace/env/im.sh</code> and put the code snippet same as [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|login shell]].

== Other less common setup ==
There are some other variable that might be useful certain applications.
=== SDL_IM_MODULE ===
Set the value to fcitx. Only SDL2 requires this. SDL1 uses XIM.
=== GLFW_IM_MODULE ===
This is a variable only used by [https://github.com/kovidgoyal/kitty/ kitty]. You need to set it to `GLFW_IM_MODULE=ibus`.
=== Binary Qt application ===
Due to Qt 5 does not support XIM, and it only bundles ibus im module, you may want to set `QT_IM_MODULE=ibus` for Qt application that does not use your system Qt library. (It may still not work because certain Qt application does not even bundle any im module).

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/33/zh-cn

2024-03-18T03:20:48Z

语法与 shell 类似，但不需要 <code>export</code>。例如，您可以创建一个包含以下内容的文件 <code>~/.config/environment.d/im.conf</code>：
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

Setup Fcitx 5/zh-cn

2024-03-18T03:20:25Z

Matrikslee: Created page with "此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单..."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

The syntax is similar to shell, but no <code>export</code> is required. For example, you can create a file <code>~/.config/environment.d/im.conf</code> with following content:
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
This is an obsolete solution for following reasons:
* pam deprecate user level configuration <code>~/.pam_environment</code> since 1.5.0.
* Some distribution does not enable pam_env in their pam configuration.

If you know it works for your system, you can put following snippet to your <code>~/.pam_environment</code>.
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

Please '''NOTE''' that the syntax is different from shell script.

== ~/.config/plasma-workspace/env/*.sh ==
A env script location that only works for Plasma desktop, you need to create your own .sh file, e.g. <code>~/.config/plasma-workspace/env/im.sh</code> and put the code snippet same as [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|login shell]].

== Other less common setup ==
There are some other variable that might be useful certain applications.
=== SDL_IM_MODULE ===
Set the value to fcitx. Only SDL2 requires this. SDL1 uses XIM.
=== GLFW_IM_MODULE ===
This is a variable only used by [https://github.com/kovidgoyal/kitty/ kitty]. You need to set it to `GLFW_IM_MODULE=ibus`.
=== Binary Qt application ===
Due to Qt 5 does not support XIM, and it only bundles ibus im module, you may want to set `QT_IM_MODULE=ibus` for Qt application that does not use your system Qt library. (It may still not work because certain Qt application does not even bundle any im module).

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].

Translations:Setup Fcitx 5/32/zh-cn

2024-03-18T03:20:25Z

此配置将在您首次用户会话登录时应用，并在之后持续存在，除非您手动停止 systemd 用户。因此，修改此配置后，使其生效的最简单方法是重新启动系统。

Setup Fcitx 5/zh-cn

2024-03-18T03:20:11Z

Matrikslee: Created page with "== environment.d == 这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配..."

<languages />
= 开机自启动 =

== 特定发行版中的工具 ==

特定的发行版可能会提供一些用于自动启动 Fcitx 的工具，并且这些工具通常也会设置环境变量。

=== im-config (Debian/Debian-based/Ubuntu) ===
这是一个用于 Debian 和 Debian-based 发行版的工具。在登录到 GUI 之后，从命令行执行 <code>im-config</code>，应该会弹出一个向导程序，在其中选择 fcitx5 即可。

=== imsettings (Fedora) ===
这是一个与 im-config 类似的程序，它也提供了 GUI 来选择要使用的输入法框架。imsettings 应该是被默认安装的，如果没有，你可以手动安装它。imsettings 可以设置环境变量并且启动相应的输入法，它还提供了一个图形化的前端用于修改配置。你需要做的就是简单地执行<code>im-chooser</code>，log-out 然后再次 log-in。

[https://www.youtube.com/watch?v=FwqTtGEN4vQ 针对 Fedora 36 KDE 的操作说明]。这个操作说明应该适用于除 GNOME 外的 XDG 兼容桌面。

=== fcitx5-autostart (Fedora) ===
这是一个 [fedora package]，打包了一个用于设置环境变量和 XDG autostart file 的 /etc/profile.d 脚本，可用于自启动。

== XDG Autostart ==

特定的发行版可能没有提供这个文件，如未提供，你可以直接复制 <code>/usr/share/applications/org.fcitx.Fcitx5.desktop</code> 到 <code>~/.config/autostart</code>

<nowiki>mkdir -p ~/.config/autostart && cp /usr/share/applications/org.fcitx.Fcitx5.desktop ~/.config/autostart</nowiki>

== KWin Wayland 5.24+ ==
如果你只使用 Gtk/Qt/Xwayland 应用，那么你不需要这里的操作。如果你希望使用支持 text-input-v3 的原生 wayland 应用，则需要让 KWin 将输入法作为一个特殊的客户端启动。

打开 systemsettings，转到 "Virtual Keyboard" 部分，将输入法从 "None" 改为 "Fcitx 5"

== 非 XDG 兼容的窗口管理器/Wayland Compoistor ==

在不支持 XDG Autostart 的场景中，请检查你的窗口管理器的手册中关于如何在系统启动时自动运行应用程序的方法。

=== Weston ===
Weston 是一个 wayland compositor 的参考实现，并不是普通用户的常规配置。

如果你希望使用 westons zwp_input_method_v1 实现，你需要确保以下内容存在 ~/.config/weston.ini 文件中（如果路径不是 /usr/bin/fcitx5 请做相应修改）。

<nowiki>[input-method]
path=/usr/bin/fcitx5</nowiki>

如果你已经在同一个会话中运行 fcitx5，当你为了调试和 fcitx5 尝试在 nested mode 中使用 weston 时，会存在特定的问题。

如果你出于调试目的只在 X11 中运行 weston，最简单的方法是在启动 weston 前退出 fcitx5.

另请注意，weston 有一个 bug，在首次运行时不会正确设置 DISPLAY 为输入法。您可能需要终止 fcitx5 一次才能使其正确设置 DISPLAY，或使用 OpenX11Connection dbus 调用来连接 fcitx。

= 环境变量 =

由于许多地方都处于过渡阶段，因此没有适合所有人的完美解决方案。请根据您的环境选择适合您的解决方案。基本上，您想要做的是为桌面会话设置以下环境变量。
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>
虽然它看起来像有效的 shell 脚本，但请 *注意* 上面的代码片段只是为了演示这些值是什么。请检查以下部分以了解不同方法的具体语法。

== 登录 shell 配置文件 ==
如果您正在使用Bash作为您的登录shell，<code>~/.bash_profile</code> 是您可以信赖的最好的用户级东西。它受到不同 DM 的广泛支持，如果您从 TTY 启动图形，它也可以工作。

* 支持主流显示管理器，包括GDM/SDDM/LightDM
* TTY 登录

如果您不使用 bash，您可能需要仔细检查您的 shell 配置文件是否可以用作设置环境变量的位置，尤其是当您正在使用一些不常见的登录 shell时。

您需要添加到 <code>~/.bash_profile</code> 的代码片段如下：
<nowiki>
export XMODIFIERS=@im=fcitx
export GTK_IM_MODULE=fcitx
export QT_IM_MODULE=fcitx</nowiki>

有些人可能会认为 <code>~/.profile</code> 是一个与 shell 无关的解决方案，这是错误的。虽然 GDM 始终获取此文件，但如果 <code>~/.bash_profile</code> 存在，SDDM/Bash 将不会获取此文件。这使得 <code>~/.bash_profile</code> 成为更好的解决方案，因为 bash 的使用相当广泛。但在继续之前请检查您的登录 shell，某些发行版可能不使用 bash 作为默认 shell。

此[https://youtu.be/8XDmLr6wb4M 视频]演示了如何在 Archlinux 上手动设置环境变量

== /etc/profile ==
如果您不关心使用 root 修改文件，这是最好的选择。所有发行版通常都支持此文件。您需要附加到 <code>/etc/profile</code> 末尾的代码片段与 [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== ~/.xprofile ==
如果您使用 X11 和显示管理器，这是一个古老的完美选择。但 Wayland 没有对应的环境变量，因此如果要为 Wayland 设置环境变量并不理想。您要添加的代码与[[Special:myLanguage/Setup Fcitx 5#Login in shell profile|登录shell配置文件]] 相同。

== environment.d ==
这是 system.d 引入的新配置，但并未得到桌面环境或显示管理器支持的广泛使用。它基本上是 systemd 用户单元的环境配置。目前，仅 GDM 或 Plasma 5.22+ 支持。作为 GDM，这意味着使用 GDM 登录的任何会话都可以工作。至于 Plasma，这意味着无论您使用什么 DM，它都适用于 Plasma。

This configuration is applied upon your first user session login and persist afterwards unless you manually stop the systemd user. So after you modifies this configuration, the easiest way to make it effective is to reboot your system.

The syntax is similar to shell, but no <code>export</code> is required. For example, you can create a file <code>~/.config/environment.d/im.conf</code> with following content:
<nowiki>
XMODIFIERS=@im=fcitx
GTK_IM_MODULE=fcitx
QT_IM_MODULE=fcitx</nowiki>

== pam_env.so ==
This is an obsolete solution for following reasons:
* pam deprecate user level configuration <code>~/.pam_environment</code> since 1.5.0.
* Some distribution does not enable pam_env in their pam configuration.

If you know it works for your system, you can put following snippet to your <code>~/.pam_environment</code>.
<nowiki>XMODIFIERS DEFAULT=\@im=fcitx
GTK_IM_MODULE DEFAULT=fcitx
QT_IM_MODULE DEFAULT=fcitx</nowiki>.

Please '''NOTE''' that the syntax is different from shell script.

== ~/.config/plasma-workspace/env/*.sh ==
A env script location that only works for Plasma desktop, you need to create your own .sh file, e.g. <code>~/.config/plasma-workspace/env/im.sh</code> and put the code snippet same as [[Special:myLanguage/Setup Fcitx 5#Login in shell profile|login shell]].

== Other less common setup ==
There are some other variable that might be useful certain applications.
=== SDL_IM_MODULE ===
Set the value to fcitx. Only SDL2 requires this. SDL1 uses XIM.
=== GLFW_IM_MODULE ===
This is a variable only used by [https://github.com/kovidgoyal/kitty/ kitty]. You need to set it to `GLFW_IM_MODULE=ibus`.
=== Binary Qt application ===
Due to Qt 5 does not support XIM, and it only bundles ibus im module, you may want to set `QT_IM_MODULE=ibus` for Qt application that does not use your system Qt library. (It may still not work because certain Qt application does not even bundle any im module).

= DBus =
On most distribution that ships with systemd, this should no longer be an issue. But if you are using some so called "systemd" free distribution, you may need to start DBus yourself and set the relevant environment variables. Usually, this can be done by adding a line in like this in your start up script. E.g. ~/.xprofile if you are using X11. Also you need to make sure this syntax works for your login shell.

<nowiki>eval `dbus-launch --sh-syntax --exit-with-session`</nowiki>

= Configure Fcitx 5 =

See [[Special:myLanguage/Configtool (Fcitx 5)|Configtool (Fcitx 5)]].