Oh My Zsh est un cadre open source, axé sur la communauté, pour gérer votre configuration zsh.

Sons ennuyeux. Essayons encore.

Oh My Zsh ne fera pas de vous un développeur 10x…mais vous pourrez vous sentir comme tel.

Une fois installé, votre terminal shell deviendra le sujet de conversation de la ville ou vous serez remboursé ! Avec chaque frappe dans votre invite de commande, vous profiterez des centaines de plugins puissants et de beaux thèmes. Les étrangers viendront vers vous dans les cafés et vous demanderont, « c’est incroyable ! êtes-vous une sorte de génie ? »

Finalement, vous commencerez à obtenir le genre d’attention que vous avez toujours pensé mériter. … ou peut-être que vous utiliserez le temps que vous gagnez pour commencer à utiliser le fil dentaire plus souvent. 😬

Pour en savoir plus, visitez ohmyz.sh, suivez @ohmyzsh sur Twitter, et rejoignez-nous sur Discord.

Mise en route

Prérequis

• Un système d’exploitation de type Unix : macOS, Linux, BSD. Sous Windows : WSL2 est préféré, mais cygwin ou msys fonctionnent aussi la plupart du temps.
• Zsh doit être installé (v4.3.9 ou plus récent est bien mais nous préférons 5.0.8 et plus récent). S’il n’est pas préinstallé (exécutez zsh --version pour confirmer), consultez les instructions suivantes du wiki ici : Installation de ZSH
• curl ou wget devrait être installé
• git devrait être installé (recommandé v2.4.11 ou supérieur)

Installation de base

Oh My Zsh est installé en exécutant l’une des commandes suivantes dans votre terminal. Vous pouvez l’installer via la ligne de commande avec soit curl, wget ou un autre outil similaire.

Inspection manuelle

C’est une bonne idée d’inspecter le script d’installation des projets que vous ne connaissez pas encore. Vous pouvez le faire en téléchargeant d’abord le script d’installation, en le parcourant pour que tout semble normal, puis en l’exécutant :

wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.shsh install.sh

Utilisation de Oh My Zsh

Plugins

Oh My Zsh est livré avec une chiée de plugins dont vous pouvez tirer parti. Vous pouvez jeter un coup d’œil dans le répertoire des plugins et/ou le wiki pour voir ce qui est actuellement disponible.

Activer les plugins

Une fois que vous avez repéré un plugin (ou plusieurs) que vous aimeriez utiliser avec Oh My Zsh, vous devrez les activer dans le fichier .zshrc. Vous trouverez le fichier zshrc dans votre répertoire $HOME. Ouvrez-le avec votre éditeur de texte préféré et vous verrez un endroit pour lister tous les plugins que vous voulez charger.

vi ~/.zshrc

Par exemple, cela pourrait commencer à ressembler à ceci:

plugins=( git bundler dotenv osx rake rbenv ruby)

Notez que les plugins sont séparés par des espaces (espaces, tabulations, nouvelles lignes…). N’utilisez pas de virgules entre eux ou cela se brisera.

Utilisation des plugins

Chaque plugin comprend un README, le documentant. Ce README devrait montrer les alias (si le plugin en ajoute) et les goodies supplémentaires qui sont inclus dans ce plugin particulier.

Thèmes

Nous l’admettons. Au début du monde Oh My Zsh, nous avons peut-être été un peu trop heureux avec les thèmes. Nous avons plus de cent cinquante thèmes maintenant regroupés. La plupart d’entre eux ont des captures d’écran sur le wiki (Nous travaillons à sa mise à jour !). Jetez-y un coup d’œil!

Sélectionner un thème

Le thème de Robby est celui par défaut. Ce n’est pas le plus fantaisiste. Ce n’est pas le plus simple. C’est juste le bon (pour lui).

Une fois que vous avez trouvé un thème que vous aimeriez utiliser, vous devrez modifier le fichier ~/.zshrc. Vous y verrez une variable d’environnement (tout en majuscules) qui ressemble à :

ZSH_THEME="robbyrussell"

Pour utiliser un thème différent, il suffit de changer la valeur pour qu’elle corresponde au nom de votre thème souhaité. Par exemple:

ZSH_THEME="agnoster" # (this is one of the fancy ones)# see https://github.com/ohmyzsh/ohmyzsh/wiki/Themes#agnoster

Note : de nombreux thèmes nécessitent l’installation des polices Powerline afin d’obtenir un rendu correct.

Ouvrez une nouvelle fenêtre de terminal et votre invite devrait ressembler à quelque chose comme ceci:

Au cas où vous n’auriez pas trouvé un thème adapté à vos besoins, veuillez jeter un coup d’œil au wiki pour en trouver d’autres.

Si vous vous sentez fougueux, vous pouvez laisser l’ordinateur en choisir un au hasard pour vous chaque fois que vous ouvrez une nouvelle fenêtre de terminal.

ZSH_THEME="random" # (...please let it be pie... please be some pie..)

Et si vous voulez choisir un thème au hasard dans une liste de vos thèmes préférés:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Si vous savez seulement quels thèmes vous n’aimez pas, vous pouvez les ajouter de la même façon à une liste ignorée:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Si vous avez d’autres questions ou problèmes, vous pourriez trouver une solution dans notre FAQ.

Sujets avancés

Si vous êtes du genre à aimer vous salir les mains, ces sections pourraient résonner.

Installation avancée

Certains utilisateurs peuvent vouloir installer manuellement Oh My Zsh, ou changer le chemin par défaut ou d’autres paramètres que l’installateur accepte (ces paramètres sont également documentés en haut du script d’installation).

Répertoire personnalisé

L’emplacement par défaut est ~/.oh-my-zsh (caché dans votre répertoire personnel, vous pouvez y accéder avec cd ~/.oh-my-zsh)

Si vous souhaitez changer le répertoire d’installation avec la variable d’environnement ZSH, soit en exécutantexport ZSH=/your/path avant l’installation, soit en la définissant avant la fin du pipeline d’installation comme ceci :

ZSH="$HOME/.dotfiles/oh-my-zsh" sh install.sh

Installation sans surveillance

Si vous exécutez le script d’installation Oh My Zsh dans le cadre d’une installation automatisée, vous pouvez passer leflag --unattended au script install.sh. Cela aura pour effet de ne pas essayer de changer le shell par défaut, et ne lancera pas non plus zsh lorsque l’installation sera terminée.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended

Installation à partir d’un dépôt bifurqué

Le script d’installation accepte également ces variables pour permettre l’installation d’un dépôt différent :

• REPO (par défaut : ohmyzsh/ohmyzsh) : cela prend la forme de owner/repository. Si vous définissez cette variable, l’installateur recherchera un dépôt à

• REMOTE (par défaut : ) : il s’agit de l’URL complète du clone du dépôt git. Vous pouvez utiliser ce paramètre si vous voulez installer à partir d’un fork qui n’est pas sur GitHub (GitLab,Bitbucket…) ou si vous voulez cloner avec SSH au lieu de HTTPS ([email protected]:user/project.git).

  NOTE : c’est incompatible avec la définition de la variable REPO. Ce paramètre aura la priorité.

• BRANCH (par défaut : master) : vous pouvez utiliser ce paramètre si vous voulez changer la branche par défaut pour être vérifiée lors du clonage du dépôt. Cela peut être utile pour tester une Pull Request, ou si vous voulez utiliser une branche autre que master.

Par exemple:

REPO=apjanke/oh-my-zsh BRANCH=edge sh install.sh

Installation manuelle

1. Clonez le référentiel

git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh

2. Optionnellement, sauvegarder votre fichier ~/.zshrc existant

cp ~/.zshrc ~/.zshrc.orig

3. Créer un nouveau fichier de configuration zsh

Vous pouvez créer un nouveau fichier de configuration zsh en copiant le modèle que nous avons inclus pour vous.

cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc

4. Changez votre shell par défaut

chsh -s $(which zsh)

Vous devez vous déconnecter de votre session utilisateur et vous reconnecter pour voir ce changement.

5. Initialisez votre nouvelle configuration zsh

Une fois que vous ouvrez une nouvelle fenêtre de terminal, elle devrait charger zsh avec la configuration de Oh My Zsh.

Problèmes d’installation

Si vous avez des hoquets d’installation, voici quelques correctifs courants.

• Vous pourriez avoir besoin de modifier votre PATH dans ~/.zshrc si vous n’êtes pas en mesure de trouver certaines commandes après le passage à oh-my-zsh.
• Si vous avez installé manuellement ou changé l’emplacement d’installation, vérifiez la variable d’environnement ZSH dans~/.zshrc.

Plugins et thèmes personnalisés

Si vous voulez remplacer l’un des comportements par défaut, il suffit d’ajouter un nouveau fichier (se terminant par .zsh) dans le répertoire custom/.

Si vous avez de nombreuses fonctions qui vont bien ensemble, vous pouvez les mettre sous forme de fichier XYZ.plugin.zsh dans le répertoire custom/plugins/ puis activer ce plugin.

Si vous souhaitez remplacer la fonctionnalité d’un plugin distribué avec Oh My Zsh, créez un plugin du même nom dans le répertoire custom/plugins/ et il sera chargé à la place de celui dans plugins/.

Obtenir des mises à jour

Par défaut, vous serez invité à vérifier les mises à jour toutes les quelques semaines. Si vous souhaitez que oh-my-zsh se mette automatiquement à jour sans vous le demander, définissez ce qui suit dans votre ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Pour désactiver les mises à jour automatiques, définissez ce qui suit dans votre ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Mises à jour manuelles

Si vous souhaitez mettre à jour à tout moment (peut-être que quelqu’un vient de publier un nouveau plugin et que vous ne voulez pas attendre une semaine ?), il vous suffit d’exécuter :

omz update

Magie ! 🎉

Désinstallation de Oh My Zsh

Oh My Zsh n’est pas pour tout le monde. Vous nous manquerez, mais nous voulons que cette rupture soit facile.

Si vous voulez désinstaller oh-my-zsh, exécutez simplement uninstall_oh_my_zsh depuis la ligne de commande. Il se supprimera lui-même et rétablira votre précédente configuration bash ou zsh.

Comment puis-je contribuer à Oh My Zsh?

Avant de participer à notre délicieuse communauté, veuillez lire le code de conduite.

Je suis loin d’être un expert de Zsh et je soupçonne qu’il y a de nombreuses façons d’améliorer – si vous avez des idées sur la façon de rendre la configuration plus facile à maintenir (et plus rapide), n’hésitez pas à forker et à envoyer des pull requests !

Nous avons également besoin de personnes pour tester les pull-requests. Alors jetez un œil aux problèmes ouverts et aidez où vous pouvez.

Voir Contribuer pour plus de détails.

Ne nous envoyez PAS de thèmes

Nous avons (plus que) suffisamment de thèmes pour le moment. Veuillez ajouter votre thème à la page wiki des thèmes externes.

Contributeurs

Oh My Zsh possède une communauté dynamique d’utilisateurs heureux et de contributeurs délicieux. Sans tout le temps et l’aide de nos contributeurs, il ne serait pas si génial.

Merci beaucoup !

Suivez-nous

Nous sommes sur les médias sociaux :

• @ohmyzsh sur Twitter. Vous devriez le suivre.
• FaceBook poke us.
• Instagram tag nous dans votre post montrant Oh My Zsh!
• Discord pour discuter avec nous!

Merchandise

Nous avons des autocollants, des t-shirts et des tasses à café disponibles pour que vous puissiez montrer votre amour de Oh My Zsh. Encore une fois, vous deviendrez le sujet de conversation de la ville !

Licence

Oh My Zsh est publié sous la licence MIT.

À propos de Planet Argon

.