Différences

Ci-dessous, les différences entre deux révisions de la page.

--- oh-my-zsh [Le 09/08/2023, 11:02]
sefran création de la doc Oh my Zsh
+++ oh-my-zsh [Le 06/12/2023, 18:06] (Version actuelle)
sefran correction lien
@@ Ligne 8: / Ligne 8: @@
 C'est là que **Oh My Zsh** entre en jeu.
-**Oh My Zsh** est un framework open source pour la gestion de la configuration [[zsh|Zsh]] et est piloté par la communauté. Il est livré avec des tonnes de fonctions utiles, des [[https://github.com/ohmyzsh/ohmyzsh/wiki/Plugins|plugins]], des assistants, des [[https://github.com/ohmyzsh/ohmyzsh/wiki/Themes|thèmes]] et quelques éléments qui vous rendront votre terminal plus ergonomique.
+**Oh My Zsh** est un framework open source pour la gestion de la configuration [[zsh|Zsh]] et est piloté par la communauté. Il est livré avec des tonnes de fonctions utiles au travers des [[https://github.com/ohmyzsh/ohmyzsh/wiki/Plugins|plugins]], des assistants, des [[https://github.com/ohmyzsh/ohmyzsh/wiki/Themes|thèmes]]. Ces fonctions que vous ajouterez à Zsh vous rendront votre terminal plus ergonomique et sexy.
 ====== Installation ======
@@ Ligne 14: / Ligne 14: @@
 ===== Prérequis =====
-[[zsh|Zsh]] doit être installé. La version 4.3.9 ferait l'affaire, mais de préférence utiliser la version 5.0.8 ou plus récent.
+[[zsh|Zsh]] doit être installé. La version 4.3.9 ferait l'affaire, mais de préférence utilisez la version 5.0.8 ou plus récente.
-[[curl|Curl]] ou [[wget|Wget]] doivent-être installés.
-[[git|Git]] doit aussi être installé (v2.4.11 ou supérieur recommandé).
-Pour se faire exécutez dans un [[terminal|terminal]]
+<note important>
+N'oubliez pas de définir votre shell par défaut à [[zsh|Zsh]].
+<code bash>
+chsh -s /bin/zsh
+</code>
+Puis déconnectez-vous, et reconnectez-vous pour avoir [[zsh|Zsh]] comme shell par défaut.
+Vous pouvez aussi lancer le shell manuellement dans bash
 <code bash>
+zsh
+</code>
+Et pour activer les modifications du fichier de configuration **~/.zhrc** dans le terminal actif avec une instance [[zsh|Zsh]]
+<code zsh>
+source ~/.zshrc
+</code>
+</note>
+[[curl|Curl]] ou [[wget|Wget]] et [[git|Git]] doivent-être installés.
+[[git|Git]] doit être en v2.4.11 ou supérieure.
+Pour [[tutoriel:comment_installer_un_paquet|l'installation de ces applications]] exécutez dans un [[terminal|terminal]]
+<code zsh>
 sudo apt install curl wget git
 </code>
@@ Ligne 28: / Ligne 48: @@
 Installez Oh My Zsh via une des lignes de commande avec curl ou wget comme indiqué.
-<code bash>
+<code zsh>
-sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
+sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
 </code>
 ou
-<code bash>
+<code zsh>
-sh -c "$(wget https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh -O -)"
+sh -c "$(wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh -O -)"
 </code>
@@ Ligne 48: / Ligne 68: @@
 Exemple avec git pour l'assistant zsh-autosuggestions
-<code bash>
+<code zsh>
-git clone https://github.com/zsh-users/zsh-autosuggestions ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
+git clone https://raw.githubusercontent.com/zsh-users/zsh-autosuggestions ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
 </code>
 Exemple avec le plugins
-<code bash>
+<code zsh>
-git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
+git clone https://raw.githubusercontent.com/zsh-users/zsh-syntax-highlighting.git ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
 </code>
+Vous pouvez aussi télécharger d'autres extensions sur **(en)** [[https://github.com/ohmyzsh/ohmyzsh/wiki|External plugins]]
 ====== Installation des thèmes ======
 Pour ajouter des thèmes il suffit de copier le thème dans le répertoire **~/.oh-my-zsh/custom/themes**.
+Vous pouvez aussi télécharger d'autres thèmes sur **(en)** [[https://github.com/ohmyzsh/ohmyzsh/wiki/External-themes|External themes]]
 ====== Configurations ======
-Toutes les paramètres de configuration sont placées sous le fichier **.zshrc**. C'est là que vous devez modifier les paramètres de **Oh My Zsh**, activer les nouveaux plugins ou modifier les thèmes en fonction des besoins.
+Tous les paramètres de configuration sont placés dans le fichier **.zshrc**. C'est là que vous devez modifier les paramètres de **Oh My Zsh** pour activer les nouveaux plugins ou modifier les thèmes en fonction des besoins.
+===== Configuration des paramètres Oh My Zsh =====
+===== Configuration des extensions Oh My Zsh =====
+Pour valider une extension, un plugin en anglais, il faut [[tutoriel:comment_modifier_un_fichier|éditer]] le fichier de configuration [[zsh|Zsh]] **.zhrc** de votre compte utilisateur en tapant la commande suivante par exemple
+<code zsh>
+nano ~/.zshrc
+</code>
+==== Activer une extension ====
+Modifier
+<code>
+# Which plugins would you like to load?
+# Standard plugins can be found in $ZSH/plugins/
+# Custom plugins may be added to $ZSH_CUSTOM/plugins/
+# Example format: plugins=(rails git textmate ruby lighthouse)
+# Add wisely, as too many plugins slow down shell startup.
+plugins=(
+    git
+    zsh-autosuggestions
+    zsh-syntax-highlighting
+    «votre plugin»
+)
+</code>
+==== Trouver les extensions ====
+Pour voir la liste des extensions disponibles
+<code zsh>
+ls ~/.oh-my-zsh/plugins
+</code>
+===== Configuration des thèmes Oh My Zsh =====
+Pour valider un thème il faut [[tutoriel:comment_modifier_un_fichier|éditer]] le fichier de configuration [[zsh|Zsh]] **.zhrc** de votre compte utilisateur en tapant la commande suivante par exemple
+<code zsh>
+nano ~/.zshrc
+</code>
+==== Activer un thème ====
+Modifier
+<code>
+ZSH_THEME="votre thème"
+</code>
+==== Trouver les thèmes ====
+Pour voir la liste des thèmes disponibles
+<code zsh>
+ls ~/.oh-my-zsh/themes
+</code>
+==== Thèmes aléatoires ====
+Vous pouvez aussi randomiser les thèmes à afficher à partir du répertoire **~/.oh-my-zsh/themes**. Pour cela vous devez modifier la variable *ZSH_THEME* du fichier **.zhrc** comme suit.
+<code>
+ZSH_THEME="random"
+</code>
+Pour tester ouvrez plusieurs terminaux avec par exemple le raccourcis clavier **CTRL + ALT + T**
+Vous pouvez limiter le choix des thèmes à une sélection. Pour cela il vous faudra modifier la variable **ZSH_THEME_RANDOM_CANDIDATES** du fichier **.zhrc**
+<code>
+ZSH_THEME_RANDOM_CANDIDATES=( "<nom premier thème>" "<nom second thème>" )
+</code>
+==== Créer son thème ====
+Vous pouvez créer votre thème. Pour cela il vous suffit de copier et modifier un thème existant.
+Par exemple avec le theme jonathan
+{{ :application:zsh:oh-my-zsh_jonathan-theme.png?800 | Terminal Zsh avec le thème Jonathan}}
+<code zsh>
+cp ~/.oh-my-zsh/themes/jonathan.zsh-theme ~/.oh-my-zsh/themes/montheme.zsh-theme
+</code>
+Modifier
+<code>
+# Finally, the prompt.
+PROMPT='${PR_SET_CHARSET}${PR_STITLE}${(e)PR_TITLEBAR}\
+${PR_CYAN}${PR_ULCORNER}${PR_HBAR}${PR_GREY}(\
+${PR_GREEN}%${PR_PWDLEN}<...<%~%<<\
+${PR_GREY})$(ruby_prompt_info)${PR_CYAN}${PR_HBAR}${PR_HBAR}${(e)PR_FILLBAR}${PR_HBAR}${PR_GREY}(\
+${PR_CYAN}%(!.%SROOT%s.%n)${PR_GREY}@${PR_GREEN}%m:%l\
+${PR_GREY})${PR_CYAN}${PR_HBAR}${PR_URCORNER}\
+${PR_CYAN}${PR_LLCORNER}${PR_BLUE}${PR_HBAR}(\
+${PR_YELLOW}%D{%H:%M:%S}\
+${PR_LIGHT_BLUE}%{$reset_color%}$(git_prompt_info)$(git_prompt_status)${PR_BLUE})${PR_CYAN}${PR_HBAR}\
+${PR_HBAR}\
+>${PR_NO_COLOUR} '
+# display exitcode on the right when > 0
+return_code="%(?..%{$fg[red]%}%? ↵ %{$reset_color%})"
+RPROMPT=' $return_code${PR_CYAN}${PR_HBAR}${PR_BLUE}${PR_HBAR}\
+(${PR_YELLOW}%D{%a,%b%d}${PR_BLUE})${PR_HBAR}${PR_CYAN}${PR_LRCORNER}${PR_NO_COLOUR}'
+</code>
+en
+<code>
+# Finally, the prompt.
+PROMPT='${PR_SET_CHARSET}${PR_STITLE}${(e)PR_TITLEBAR}\
+${PR_CYAN}${PR_ULCORNER}${PR_HBAR}${PR_BLUE}(${PR_NO_COLOUR}🌍\
+${PR_GREY}%${PR_PWDLEN}<...<%~%<<\
+${PR_BLUE})$(ruby_prompt_info)${PR_CYAN}${PR_HBAR}${PR_HBAR}${(e)PR_FILLBAR} \
+${PR_CYAN}%(!.%SROOT%s.%n)${PR_GREY}@${PR_GREEN}%m:%l\
+${PR_CYAN} ${PR_URCORNER}\
+${PR_CYAN}${PR_LLCORNER}${PR_HBAR}${PR_BLUE}(\
+${PR_YELLOW}%D{%H:%M:%S}\
+${PR_LIGHT_BLUE}%{$reset_color%}$(git_prompt_info)$(git_prompt_status)${PR_BLUE})${PR_CYAN}${PR_HBAR}\
+${PR_HBAR}\
+${PR_RED}❱${PR_NO_COLOUR} 👽 '
+# display exitcode on the right when > 0
+return_code="%(?..%{$fg[red]%}%? ↵ %{$reset_color%})"
+RPROMPT=' $return_code${PR_CYAN}${PR_HBAR}${PR_HBAR}\
+${PR_BLUE}(${PR_YELLOW}%D{%A %d %b}${PR_BLUE})${PR_CYAN}${PR_HBAR}${PR_LRCORNER}${PR_NO_COLOUR}'
+</code>
+Et vous obtenez un terminal plus francisé et sexy 8-)
+{{ :application:zsh:oh-my-zsh_personal-theme.png?800 |}}
+Vous pouvez aussi partir d'un fichier vide en suivant le tutoriel **(en)** [[https://blog.carbonfive.com/writing-zsh-themes-a-quickref/|Writing ZSH Themes: A Quickref]]
 ===== Voir aussi =====