x11-emoji-picker 项目使用教程

x11-emoji-picker 项目使用教程

x11-emoji-picker Linux XServer emoji picker 项目地址: https://gitcode.com/gh_mirrors/x1/x11-emoji-picker

1. 项目目录结构及介绍

x11-emoji-picker 是一个为 Linux 系统上的 XServer 设计的对话框/表情选择器，其灵感来源于 Windows 10 的表情选择器。以下是项目的目录结构及其简要说明：

x11-emoji-picker/
├── .github/           # GitHub 工作流和相关文件
├── .scripts/          # 生成表情映射和别名的脚本
├── doc/              # 文档和截图
├── src/              # 源代码
├── CMakeLists.txt     # CMake 构建配置文件
├── LICENSE           # MIT 许可证文件
├── README.md         # 项目说明文件
├── install.sh         # 安装脚本
└── ...               # 其他文件和目录

• .github/：包含项目的 GitHub 工作流，如构建和发布流程。
• .scripts/：包含生成表情映射和别名的 JavaScript 脚本。
• doc/：存放项目文档和相关截图。
• src/：包含项目的源代码，包括表情映射、界面设计和功能实现。
• CMakeLists.txt：CMake 的构建配置文件，用于构建项目。
• LICENSE：项目的 MIT 许可证文件。
• README.md：项目的说明文件，介绍项目的功能和使用方法。
• install.sh：安装脚本，用于简化项目的安装过程。

2. 项目的启动文件介绍

项目的启动主要是通过执行 install.sh 脚本，该脚本会根据不同的操作系统下载并安装相应的依赖和文件。

以下是 install.sh 脚本的主要功能和用法：

• 下载并安装项目所需的依赖。
• 根据系统类型（如 Ubuntu、Debian、openSUSE、Fedora 等）选择适当的安装包。
• 提供选项安装夜间构建版本。

使用方法：

wget -q https://raw.githubusercontent.com/GaZaTu/x11-emoji-picker/master/install.sh && sh install.sh

对于不同的操作系统，安装方法可能有所不同，例如：

• Arch 用户可以使用 AUR 仓库中的包进行安装。
• Debian 用户可以从 releases 页面下载 .deb 包进行安装。
• Ubuntu 用户同理，可以从 releases 页面下载 .deb 包进行安装。
• openSUSE 用户可以从 releases 页面下载 .rpm 包进行安装。
• Fedora 用户也可以从 releases 页面下载 .rpm 包进行安装。

3. 项目的配置文件介绍

项目的配置文件位于 $XDG_CONFIG_HOME/gazatu.xyz/emoji-picker.ini，通常在 ~/.config/ 目录下。该配置文件包含了多个可配置的选项，以下是一些主要配置项的说明：

• [General]：包含通用设置，如是否默认激活窗口、是否在失去焦点后关闭窗口、自定义样式文件的路径、是否禁用性别特定表情等。
• activateWindowBeforeWritingByDefault：是否默认在写入表情前激活窗口。
• closeOnFocusLost：是否在失去焦点后关闭表情选择器窗口。
• customQssFilePath：自定义样式表文件的路径。
• gendersDisabled：是否禁用性别特定表情。
• localeKey：选择表情翻译的语言。
• maxEmojiVersion：设置表情版本的最大值，以排除在此之后发布的表情。
• openAtMouseLocation：是否在当前鼠标位置打开表情选择器对话框。
• saveKaomojiInMRU：是否将颜文字包含在最近使用表情的列表中。
• scaleFactor：调整表情选择器的大小。
• skinTonesDisabled：是否禁用皮肤色调特定的表情。
• swapEnterAndShiftEnter：是否交换 Enter 和 Shift+Enter 键的功能。
• useClipboardHackByDefault：是否默认使用剪贴板方法写入表情。
• useSystemEmojiFont：是否使用系统表情字体。
• useSystemEmojiFontWidthHeuristics：是否使用系统表情字体的宽度启发式。
• useSystemQtTheme：是否使用系统 Qt 主题。
• windowOpacity：设置表情选择器窗口的透明度。

通过编辑这些配置项，用户可以根据自己的喜好和需求自定义表情选择器的行为和外观。

x11-emoji-picker Linux XServer emoji picker 项目地址: https://gitcode.com/gh_mirrors/x1/x11-emoji-picker