Fcitx 输入法框架安装与使用教程

1. 项目目录结构及介绍

Fcitx 项目的目录结构如下：

fcitx/
├── AUTHORS
├── CMakeLists.txt
├── COPYING
├── COPYING.BSD
├── COPYING.LGPL
├── COPYING.LIBS
├── COPYING.MIT
├── ChangeLog
├── Doxyfile.in
├── INSTALL
├── README
├── THANKS
├── TODO
├── clang-format.sh
├── config.h.in
├── cmake/
├── data/
├── doc/
├── po/
├── skins/
├── src/
├── test/
└── tools/

目录介绍

• AUTHORS: 项目贡献者列表。
• CMakeLists.txt: CMake 构建脚本。
• COPYING: 许可证文件，包含 GPL-2.0、BSD-3-Clause、LGPL-2.1、MIT 等许可证。
• ChangeLog: 项目变更日志。
• Doxyfile.in: Doxygen 配置文件。
• INSTALL: 安装指南。
• README: 项目介绍和使用说明。
• THANKS: 感谢列表。
• TODO: 待办事项。
• clang-format.sh: 代码格式化脚本。
• config.h.in: 配置头文件模板。
• cmake/: CMake 相关文件和模块。
• data/: 数据文件，如输入法配置文件等。
• doc/: 文档目录，包含用户和开发者文档。
• po/: 多语言支持文件。
• skins/: 输入法皮肤文件。
• src/: 源代码目录，包含核心代码和输入法引擎。
• test/: 测试代码目录。
• tools/: 工具脚本和实用程序。

2. 项目启动文件介绍

Fcitx 的启动文件主要位于 src/ 目录下，核心启动文件包括：

• src/main.cpp: 主程序入口，负责初始化和启动 Fcitx 输入法框架。
• src/fcitx.h: 核心头文件，包含 Fcitx 的主要数据结构和函数声明。
• src/fcitx.cpp: 核心实现文件，包含 Fcitx 的主要功能实现。

启动流程

1. main.cpp: 程序入口，初始化 Fcitx 环境，加载配置文件，启动输入法框架。
2. fcitx.cpp: 实现输入法的核心功能，如输入法切换、候选词显示等。

3. 项目配置文件介绍

Fcitx 的配置文件主要位于 data/ 目录下，常见的配置文件包括：

• data/fcitx_config.conf: 主配置文件，包含输入法的全局配置，如输入法引擎、快捷键设置等。
• data/fcitx_theme.conf: 主题配置文件，定义输入法的外观和皮肤。
• data/fcitx_input_method.conf: 输入法引擎配置文件，定义支持的输入法和语言。

配置文件示例

# fcitx_config.conf
[General]
ActiveInputMethods=pinyin,wubi
DefaultInputMethod=pinyin

[Hotkey]
TriggerKey=CTRL_SPACE

# fcitx_theme.conf
[Theme]
Name=Default
Font=Sans,12

# fcitx_input_method.conf
[InputMethod]
pinyin=Pinyin
wubi=Wubi

配置文件说明

• fcitx_config.conf: 配置输入法的默认输入法、激活的输入法引擎和快捷键。
• fcitx_theme.conf: 配置输入法的主题名称和字体。
• fcitx_input_method.conf: 配置支持的输入法引擎及其名称。

通过以上配置文件，用户可以自定义 Fcitx 的行为和外观，以满足个人需求。