nekeal.zsh

Ansible 角色: Zsh

CI

这个 Ansible 角色用于配置 zsh、zinit 和一些命令行工具。

要求

官方支持的操作系统:

  • Debian 11
  • Debian 10
  • Debian 9
  • Ubuntu 18
  • Ubuntu 20

角色变量

名称 默认值 描述
zsh_version 5.8 要安装的 zsh 版本
zsh_reinstall_from_source false 是否强制重新安装 zsh,即使版本与当前安装相同
zsh_install_bin_prefix /bin zsh 二进制文件存放的地方
zsh_user_config_dir .zsh zsh 配置文件的存放和加载目录(相对于用户的主目录)
zsh_install_zinit true 是否安装 zinit 插件管理器
zsh_install_templates true 是否安装 .zshrc 等 zsh 模板
zsh_zshrc_template zshrc-default.zsh.j2 用于 .zshrc 文件的默认模板
zsh_aliases_template aliases-default.zsh.j2 用于包含别名定义文件的默认模板
zsh_zinit_plugins_template zinit-plugins-default.zsh.j2 包含 zinit 插件的默认模板,默认包含一些有用的插件以及来自 ohmyzsh 的一些配置
zshenv_template zshenv-default.j2 ~/.zshenv 文件的默认模板
users [] 要配置 zsh 的用户列表
  • 用户配置示例:

    users:
      - username: admin
        shell: /bin/zsh
        aliases:
          aliases:
            l: ls -lart
        zshrc:
          template: zshrc-default.zsh.j2
        env_vars:
          PATH: "$PATH=~/.local/bin:$PATH"
        zsh_config_templates:
          - src: extra-config-template.zsh.j2
            dest: .zsh/config.zsh
    

默认的 zshrc 模板会引用 ~~/.zsh 文件夹中的一些常见文件以及每个额外模板。它还默认支持 zinitfzfpowerlevel10k

依赖

角色:

  • nekeal.users - 使用与此角色相同的 users 列表。 shell 键应该设置为 /bin/zsh

示例:

users:
  - username: admin
    shell: /bin/zsh

示例剧本

- hosts: servers
  roles:
     - { role: nekeal.zsh }

许可证

MIT

作者信息

Nekeal

关于项目

Ansible role which configures zsh, zinit and some shell tools

安装
ansible-galaxy install nekeal.zsh
许可证
mit
下载
143
拥有者