ansible-role-oh-my-zsh

Rôle Ansible pour installer et configurer zsh et oh-my-zsh.

Exigences

Testé uniquement avec Ansible version 2.5 ou supérieure.

Variables du rôle

Les variables disponibles sont listées ci-dessous, avec leurs valeurs par défaut (voir defaults/main.yml):

Personnaliser le thème

# Thème par défaut à charger (inclus avec oh-my-zsh)
# Tous les thèmes inclus ici : https://github.com/robbyrussell/oh-my-zsh/tree/master/themes
oh_my_zsh_default_theme: robbyrussell

# Pour un thème personnalisé non présent dans $HOME/.oh-my-zsh/themes ou dans $HOME/.oh-my-zsh/custom/themes/ :
# 1. Remplissez oh_my_zsh_custom_theme_info
#    - Ce thème sera téléchargé dans le répertoire $HOME/.oh-my-zsh/custom/custom-themes/
# oh_my_zsh_custom_theme_info: { url: "url_git_theme_personnalisé", dir_dest_name: "nom_répertoire_git_theme_personnalisé" }
# exemple :
oh_my_zsh_custom_theme_info: { url: "https://github.com/ptavares/zsh-themes.git", dir_dest_name: zsh-themes }

# 2. Choisissez le nom du thème zsh personnalisé à charger
#    - Un lien symbolique sera créé de $HOME/.oh-my-zsh/custom/custom-themes/nom_répertoire_git_theme_personnalisé/nom_theme_personnalisé à $HOME/.oh-my-zsh/custom/themes/
# oh_my_zsh_custom_theme: nom_theme_personnalisé
# exemple :
oh_my_zsh_custom_theme: ptavares

# 3. Ajouter une configuration supplémentaire pour le thème
# oh_my_zsh_custom_theme_config:
#  - MY_CUSTOM_THEME_VAR1=value
#  - MY_CUSTOM_THEME_VAR2=value2

Personnaliser les plugins

# Plugins par défaut à charger (inclus avec l'installation d'oh-my-zsh)
# Tous les plugins inclus ici : https://github.com/robbyrussell/oh-my-zsh/tree/master/plugins
oh_my_zsh_default_plugins:
  - git

# Pour des plugins personnalisés non présents dans $HOME/.oh-my-zsh/plugins ou dans $HOME/.oh-my-zsh/custom/plugins/ :
# 1. Remplissez oh_my_zsh_custom_plugins_info
#    - Les plugins seront téléchargés dans le répertoire $HOME/.oh-my-zsh/custom/custom-plugins/
#    - Un lien symbolique sera créé de $HOME/.oh-my-zsh/custom/custom-plugins/nom_répertoire_plugin_personnalisé à $HOME/.oh-my-zsh/custom/plugins/
# oh_my_zsh_custom_plugins_info: { url: "url_git_plugin_personnalisé", dir_dest_name: "nom_répertoire_plugin_git_personnalisé" }
# exemple :
oh_my_zsh_custom_plugins_info:
  - { url: "https://github.com/junegunn/fzf.git", dir_dest_name : fzf }
  - { url: "https://github.com/Treri/fzf-zsh.git", dir_dest_name: fzf-zsh }
  - { url: "https://github.com/zsh-users/zsh-autosuggestions.git", dir_dest_name: zsh-autosuggestions }
  - { url: "https://github.com/zdharma/fast-syntax-highlighting.git", dir_dest_name: fast-syntax-highlighting }
  - { url: "https://github.com/chrissicool/zsh-bash.git", dir_dest_name: zsh-bash }

# 2. Listez tous vos plugins personnalisés à charger au démarrage de zsh
# oh_my_zsh_custom_plugins:
#	 - nom_plugin_personnalisé_1
#	 - nom_plugin_personnalisé_2
# exemple :
oh_my_zsh_custom_plugins:
  - fzf-zsh
  - zsh-autosuggestions
  - fast-syntax-highlighting
  - zsh-bash

# 3. Commande de plugin supplémentaire
# Certains plugins ont besoin d'une commande supplémentaire pour fonctionner correctement
# oh_my_zsh_custom_plugins_command :
#	 - "commande_plugin_personnalisé_1"
#  - "commande_plugin_personnalisé_2"
# exemple :
oh_my_zsh_custom_plugins_command :
  - "$HOME/.oh-my-zsh/custom/plugins/fzf/install --all"
  - "fast-theme safari"

Personnaliser .zhrc avec vos propres entrées

# Ajoutez ici toutes les entrées que vous devez mettre dans le fichier zhrc, comme des alias par exemple
# oh_my_zsh_custom_zsh_entries:
#	 - "oh_my_zsh_custom_zsh_entries_1"
#	 - "oh_my_zsh_custom_zsh_entries_2"
# exemple:
oh_my_zsh_custom_zsh_entries:
  - "# Alias pour lister uniquement les répertoires"
  - "alias lsd='ls -l | grep \"^d\"'"

Dépendances

Aucune dépendance.

Exemple de Playbook

- hosts: all
  roles:
    - role: ptavares.ansible_role_oh_my_zsh

À l'intérieur de vars/main.yml :

• Copiez le contenu de defaults/main.yml dans le fichier vars de votre playbook.
• Personnalisez-le comme vous le souhaitez (en remplissant les variables du rôle).

Licence

MIT