ansible weechat 角色

用于安装和配置 weechat 的 Ansible 角色。

WeeChat，扩展的聊天客户端。

该角色可以做什么：

• 在 Debian、Ubuntu、Archlinux 或 Fedora 上安装 weechat
• 从私人 git 仓库添加配置
• 通过 tmux 和 systemd 自动启动

设置

 weechat__install: true

• weechat__install: true：此角色将安装 weechat。在基于 Debian 的操作系统上，我们添加官方的 weechat apt 源，并安装一些插件支持和 weechat 文档。
• weechat__install: false：我们不安装 weechat。

weechat__autostart: false

• weechat__autostart: false：我们不安装任何自动启动机制。
• weechat__autostart: true：此角色安装 tmux 并创建一个 systemd 服务，以用户 {{ weechat__user }} 在 tmux 会话中启动 weechat。

weechat__install_plugins: false

• weechat__install_plugins: false：我们不安装任何 weechat 插件。
• weechat__install_plugins: true：我们安装 {{ weecat.plugins }} 字典中指定的所有官方插件。

weechat__use_custom_config: false

• weechat__use_custom_config: false：您未提供来自您自己 git 仓库的自定义配置。
• weechat__use_custom_config: true：您在自己的 git 仓库中有 weechat 配置，想要使用它。

weechat__install_plugins: false

• weechat__install_plugins: false：我们不安装任何官方 weechat 插件。
• weechat__install_plugins: true：我们安装在 {{ weechat__plugins: [] }} 目录中定义的官方 weechat 插件。

weechat__plugins:
 - go.py
 - iset.pl

• 示例 weechat__plugins: [] 列表。

weechat__user: "{{ ansible_user_id }}"

• 使用 weechat 的用户。此值用于 autostart 任务、custom_config 任务和 {{ weechat__home_directory }} 变量。

weechat__home_directory: "{{ ansible_env.HOME | default('/home/{{ weechat__user }}') }}"

• weechat 主目录所在的路径。如果变量 {{ ansible_env.HOME }} 未设置，则使用 "/home/{{ weechat__user }}" 作为后备。

weechat__gpg_id: '11E9DE8848F2B65222AA75B8D1820DB22A11534E'

• 这是来自 official weechat debian repo 的 gpg 指纹。

weechat__custom_private_repo: false

• 您的 git 仓库中包含您个人 weechat 配置的路径。
• 此角色将仓库克隆到 "{{ weechat__home_directory }}/.weechat" 目录下。*(也就是您本地的 .weechat 目录。)* 如果您本地 .weechat 目录中已有文件和/或文件夹，将会失败。
• 您需要手动添加、提交和推送您在本地 .weechat 文件夹中的更改。请注意，禁用日志或至少将 weechatlog 文件夹添加到您个人 weechat 配置中的 .gitignore 文件是个好主意。

weechat__custom_gen_ssh_key_pair: true

• weechat__custom_gen_ssh_key_pair: true：我们将生成一个椭圆曲线 ssh 密钥 (如果它尚未存在于 "{{ weechat__home_directory }}/.ssh/id_ed25519") 并将公钥打印到提示符。这将给您时间将此公钥添加到您的私人 git 仓库作为部署密钥。这样可以在没有用户名/密码的情况下下载您的私人仓库。您需要将 {{ weechat__custom_private_repo }} 设置为可以通过 ssh 访问的 git 仓库版本。
• weechat__custom_gen_ssh_key_pair: false：我们不管理访问您 weechat 配置的 git 仓库。

weechat__custom_version: main

• weechat__custom_version: main：设置此角色在使用自定义 git 仓库时应使用的 git 分支、标签、哈希或版本。

参考和灵感：

• 关于在 debian/ubuntu 上安装的信息可以在 weechat.org/download/debian 找到。
• Weechat 配置的某些部分灵感来自 github.com/irth/ansible-role-weechat，但以完全不同的方式编写。其他部分则完全不同。
• 自动启动和 systemd 灵感来自 ubuntu wiki 和 ansible docs。

要求

此 Ansible 角色的某些部分需要 community.general 和 community.crypto 集合。 您可以使用以下命令安装：

ansible-galaxy collection install -r requirements.yml --upgrade

贡献

如果您缺少某个功能、发现了错误或对该角色有疑问，请随时打开 git 问题。或者 - 更好的是 - 创建一个拉取请求。

许可证

版权 (c) 2019 L3D <l3d@c3woc.de>

完整的精彩贡献者列表可以在 这里 找到。