Oh My Zsh è un framework open source e community-driven per gestire la tua configurazione di zsh.

Sembra noioso. Proviamo di nuovo.

Oh My Zsh non ti farà diventare uno sviluppatore 10x… ma potresti sentirti tale.

Una volta installato, la tua shell terminale diventerà la voce della città o i tuoi soldi indietro! Con ogni pressione di tasti nel vostro prompt dei comandi, approfitterete delle centinaia di potenti plugin e dei bellissimi temi. Gli estranei verranno da voi nei caffè e vi chiederanno: “È incredibile! Sei una specie di genio?”

Finalmente, inizierete a ricevere il tipo di attenzione che avete sempre sentito di meritare. …o forse userai il tempo che stai risparmiando per iniziare a usare più spesso il filo interdentale. 😬

Per saperne di più, visita ohmyz.sh, segui @ohmyzsh su Twitter, e unisciti a noi su Discord.

Per iniziare

Prerequisiti

• Un sistema operativo Unix-like: macOS, Linux, BSD. Su Windows: WSL2 è preferito, ma anche cygwin o msys per lo più funzionano.
• Zsh dovrebbe essere installato (v4.3.9 o più recente va bene, ma noi preferiamo 5.0.8 e più recente). Se non è preinstallato (esegui zsh --version per confermare), controlla le seguenti istruzioni wiki qui: Installazione di Zsh
• curl o wget dovrebbe essere installato
• git dovrebbe essere installato (raccomandato v2.4.11 o superiore)

Installazione di base

Oh My Zsh è installato eseguendo uno dei seguenti comandi nel tuo terminale. Puoi installarlo tramite la linea di comando con curl, wget o un altro strumento simile.

Ispezione manuale

È una buona idea ispezionare lo script di installazione da progetti che non conosci ancora. Puoi farlo scaricando prima lo script di installazione, esaminandolo in modo che tutto sembri normale, poi eseguendolo:

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

Usando Oh My Zsh

Plugin

Oh My Zsh viene fornito con un casino di plugin di cui puoi usufruire. Puoi dare un’occhiata alla directory dei plugin e/o al wiki per vedere cosa è attualmente disponibile.

Abilitare i plugin

Una volta individuato un plugin (o diversi) che vorresti usare con Oh My Zsh, dovrai abilitarlo nel file .zshrc. Troverai il file zshrc nella tua directory $HOME. Aprilo con il tuo editor di testo preferito e vedrai un punto in cui elencare tutti i plugin che vuoi caricare.

vi ~/.zshrc

Per esempio, questo potrebbe iniziare a sembrare così:

plugins=( git bundler dotenv osx rake rbenv ruby)

Nota che i plugin sono separati da spazi bianchi (spazi, tabulazioni, nuove linee…). Non usare virgole tra loro o si romperà.

Usare i plugin

Ogni plugin include un README, che lo documenta. Questo README dovrebbe mostrare gli alias (se il plugin ne aggiunge) e le chicche extra che sono incluse in quel particolare plugin.

Temi

Lo ammettiamo. All’inizio del mondo di Oh My Zsh, potremmo essere diventati un po’ troppo felici per i temi. Ora abbiamo più di centocinquanta temi in bundle. La maggior parte di loro ha degli screenshot sul wiki (stiamo lavorando per aggiornarlo!). Controllali!

Selezionare un tema

Il tema di Robby è quello predefinito. Non è il più elegante. Non è il più semplice. È solo quello giusto (per lui).

Una volta trovato un tema che ti piacerebbe usare, dovrai modificare il file ~/.zshrc. Vedrai una variabile d’ambiente (tutto maiuscolo) che assomiglia a:

ZSH_THEME="robbyrussell"

Per usare un tema diverso, cambia semplicemente il valore per abbinare il nome del tema desiderato. Per esempio:

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

Nota: molti temi richiedono l’installazione dei Powerline Fonts per rendere correttamente.

Apri una nuova finestra di terminale e il tuo prompt dovrebbe assomigliare a questo:

Nel caso tu non abbia trovato un tema adatto alle tue esigenze, dai un’occhiata al wiki per altri temi.

Se ti senti grintoso, puoi lasciare che il computer ne selezioni uno a caso per te ogni volta che apri una nuova finestra del terminale.

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

E se vuoi scegliere un tema a caso da una lista dei tuoi temi preferiti:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Se sai solo quali temi non ti piacciono, puoi aggiungerli allo stesso modo a una lista ignorata:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Se hai altre domande o problemi, potresti trovare una soluzione nelle nostre FAQ.

Argomenti avanzati

Se sei il tipo a cui piace sporcarsi le mani, queste sezioni potrebbero interessarti.

Installazione avanzata

Alcuni utenti potrebbero voler installare manualmente Oh My Zsh, o cambiare il percorso di default o altre impostazioni che il programma di installazione accetta (queste impostazioni sono anche documentate in cima allo script di installazione).

Directory personalizzata

La posizione predefinita è ~/.oh-my-zsh (nascosta nella tua home directory, puoi accedervi con cd ~/.oh-my-zsh)

Se vuoi cambiare la directory di installazione con la variabile d’ambiente ZSH, o eseguendoexport ZSH=/your/path prima dell’installazione, o impostandola prima della fine del pipeline di installazione come questo:

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

Unattended install

Se stai eseguendo lo script di installazione Oh My Zsh come parte di un’installazione automatica, puoi passare il flag --unattended allo script install.sh. Questo avrà l’effetto di non provare a cambiare la shell di default, e inoltre non eseguirà zsh quando l’installazione è finita.

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

Installare da un repository biforcato

Lo script di installazione accetta anche queste variabili per permettere l’installazione di un repository diverso:

• REPO (default: ohmyzsh/ohmyzsh): questo prende la forma di owner/repository. Se si imposta questa variabile, l’installatore cercherà un repository a

• REMOTE (predefinito: ): questo è l’URL completo del repositoryclone git. Puoi usare questa impostazione se vuoi installare da un fork che non è su GitHub (GitLab,Bitbucket…) o se vuoi clonare con SSH invece di HTTPS ([email protected]:user/project.git).

  NOTA: è incompatibile con l’impostazione della variabile REPO. Questa impostazione avrà la precedenza.

• BRANCH (default: master): si può usare questa impostazione se si vuole cambiare il ramo predefinito per essere controllato quando si clona il repository. Questo potrebbe essere utile per testare una Pull Request, o se vuoi usare un ramo diverso da master.

Per esempio:

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

Installazione manuale

1. Clonare il repository Clonare il repository

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

2. Opzionalmente, fai un backup del tuo file ~/.zshrc esistente

cp ~/.zshrc ~/.zshrc.orig

3. Crea un nuovo file di configurazione zsh

Puoi creare un nuovo file di configurazione zsh copiando il modello che abbiamo incluso per te. Cambia la tua shell di default

chsh -s $(which zsh)

Devi uscire dalla tua sessione utente e rientrare per vedere questo cambiamento.

5. Inizializza la tua nuova configurazione di zsh

Una volta aperta una nuova finestra di terminale, dovrebbe caricare zsh con la configurazione di Oh My Zsh.

Problemi di installazione

Se hai qualche intoppo nell’installazione, ecco alcune soluzioni comuni.

• Potresti aver bisogno di modificare il tuo PATH in ~/.zshrc se non sei in grado di trovare alcuni comandi dopo essere passato a oh-my-zsh.
• Se hai installato manualmente o hai cambiato il percorso di installazione, controlla la variabile d’ambiente ZSH in ~/.zshrc.

Plugin e temi personalizzati

Se vuoi sovrascrivere uno qualsiasi dei comportamenti predefiniti, basta aggiungere un nuovo file (che termina con .zsh) nella directory custom/.

Se hai molte funzioni che vanno bene insieme, puoi metterle come un file XYZ.plugin.zsh nella directory custom/plugins/ e poi abilitare questo plugin.

Se vuoi sovrascrivere la funzionalità di un plugin distribuito con Oh My Zsh, crea un plugin con lo stesso nome nella directory custom/plugins/ e sarà caricato al posto di quello in plugins/.

Ottenere aggiornamenti

Di default, ti verrà richiesto di controllare gli aggiornamenti ogni poche settimane. Se vuoi che oh-my-zsh si aggiorni automaticamente senza che ti venga richiesto, imposta quanto segue nel tuo ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Per disabilitare gli aggiornamenti automatici, imposta quanto segue nel tuo ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Aggiornamenti manuali

Se vuoi aggiornare in qualsiasi momento (forse qualcuno ha appena rilasciato un nuovo plugin e non vuoi aspettare una settimana?) devi solo eseguire:

omz update

Magia! 🎉

Disinstallare Oh My Zsh

Oh My Zsh non è per tutti. Ci mancherai, ma vogliamo che questa sia una rottura facile.

Se vuoi disinstallare oh-my-zsh, basta eseguire uninstall_oh_my_zsh dalla riga di comando. Si rimuoverà da solo e ripristinerà la tua precedente configurazione bash o zsh.

Come posso contribuire a Oh My Zsh?

Prima di partecipare alla nostra deliziosa comunità, leggi il codice di condotta.

Sono lontano dall’essere un esperto di Zsh e sospetto che ci siano molti modi per migliorare – se hai idee su come rendere la configurazione più facile da mantenere (e più veloce), non esitare a fare un fork e inviare richieste di pull!

Abbiamo anche bisogno di persone che testino le richieste di pull. Quindi dai un’occhiata ai problemi aperti e aiuta dove puoi.

Vedi Contribuire per maggiori dettagli.

NON mandarci temi

Abbiamo (più che) abbastanza temi per il momento. Per favore aggiungi il tuo tema alla pagina wiki dei temi esterni.

Contributori

Oh My Zsh ha una vibrante comunità di felici utenti e deliziosi collaboratori. Senza tutto il tempo e l’aiuto dei nostri collaboratori, non sarebbe così fantastico.

Grazie mille!

Seguiteci

Siamo sui social media:

• @ohmyzsh su Twitter. Dovresti seguirlo.
• FaceBook poke us.
• Instagram taggaci nei tuoi post mostrando Oh My Zsh!
• Discord per chattare con noi!

Merchandise

Abbiamo adesivi, magliette e tazze di caffè disponibili per te per mostrare il tuo amore per Oh My Zsh. Ancora una volta, diventerai la voce della città!

Licenza

Oh My Zsh è rilasciato sotto la licenza MIT.

Su Planet Argon