Oh My Zsh er en open source, fællesskabsdrevet ramme til at administrere din zsh-konfiguration.
Lader kedeligt. Lad os prøve igen.
Oh My Zsh vil ikke gøre dig til en 10x udvikler … men du vil måske føle dig som en.
Når du har installeret din terminalskal, vil din terminalskal blive byens samtaleemne eller dine penge tilbage! Med hvert tastetryk i din kommandoprompt vil du drage fordel af de hundredvis af kraftfulde plugins og smukke temaer. Fremmede vil komme hen til dig på caféer og spørge dig: “det er fantastisk! er du et slags geni?”
Endeligt vil du begynde at få den slags opmærksomhed, som du altid har følt, at du fortjente. … eller måske vil du bruge den tid, du sparer, til at begynde at bruge tandtråd oftere. 😬
For at få mere at vide kan du besøge ohmyz.sh, følge @ohmyzsh på Twitter og slutte dig til os på Discord.
Kom godt i gang
Forudsætninger
- Et Unix-lignende styresystem: macOS, Linux, BSD. På Windows: WSL2 foretrækkes, men cygwin eller msys fungerer også for det meste.
- Zsh skal være installeret (v4.3.9 eller nyere er fint, men vi foretrækker 5.0.8 og nyere). Hvis det ikke er præinstalleret (kør
zsh --version
for at bekræfte det), kan du se følgende wiki-vejledning her: Installation af Zsh -
curl
ellerwget
skal være installeret -
git
skal være installeret (anbefales v2.4.11 eller nyere)
Grundlæggende installation
Oh My Zsh installeres ved at køre en af følgende kommandoer i din terminal:
Du kan installere dette via kommandolinjen med enten curl
, wget
eller et andet lignende værktøj.
Manuel inspektion
Det er en god idé at inspicere installationsskriften fra projekter, som du endnu ikke kender. Det kan du gøre ved først at downloade installationsskriften, kigge den igennem, så alt ser normalt ud, og derefter køre den:
wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.shsh install.sh
Brug af Oh My Zsh
Plugins
Oh My Zsh leveres med en helvedes masse plugins, som du kan drage fordel af. Du kan tage et kig i plugins-mappen og/eller wikien for at se, hvad der er tilgængeligt i øjeblikket.
Aktivering af plugins
Når du har fundet et plugin (eller flere), som du gerne vil bruge sammen med Oh My Zsh, skal du aktivere dem i .zshrc
-filen. Du finder zshrc-filen i din $HOME
-mappe. Åbn den med din foretrukne teksteditor, og du vil se et sted, hvor du kan liste alle de plugins, du vil indlæse.
vi ~/.zshrc
Det kan f.eks. begynde at se sådan ud:
plugins=( git bundler dotenv osx rake rbenv ruby)
Bemærk, at plugins er adskilt af mellemrum (mellemrum, tabulatorer, nye linjer…). Brug ikke kommaer mellem dem, ellers går det i stykker.
Brug af plugins
Hvert plugin indeholder en README, der dokumenterer det. Denne README bør vise de aliaser (hvis plugin’et tilføjer nogen) og ekstra godbidder, der er inkluderet i det pågældende plugin.
Temaer
Vi indrømmer det. Tidligt i Oh My Zsh-verdenen er vi måske blevet lidt for tema-glade. Vi har over hundrede og halvtreds temaer nu bundtet. De fleste af dem har skærmbilleder på wiki’en (Vi arbejder på at opdatere denne!). Tjek dem ud!
Valg af tema
Robby’s tema er standardtemaet. Det er ikke det flotteste. Det er ikke det enkleste. Det er bare det rigtige (for ham).
Når du har fundet et tema, som du gerne vil bruge, skal du redigere ~/.zshrc
-filen. Du vil se en miljøvariabel (alle versaler) derinde, der ser således ud:
ZSH_THEME="robbyrussell"
For at bruge et andet tema skal du blot ændre værdien, så den passer til navnet på det ønskede tema. For eksempel:
ZSH_THEME="agnoster" # (this is one of the fancy ones)# see https://github.com/ohmyzsh/ohmyzsh/wiki/Themes#agnoster
Bemærk: Mange temaer kræver installation af Powerline Fonts for at kunne gengives korrekt.
Åbn et nyt terminalvindue, og din prompt bør se nogenlunde sådan ud:
Hvis du ikke fandt et passende tema til dine behov, så tag et kig på wikien for at finde flere af dem.
Hvis du føler dig stridbar, kan du lade computeren vælge et tilfældigt for dig, hver gang du åbner et nyt terminalvindue.
ZSH_THEME="random" # (...please let it be pie... please be some pie..)
Og hvis du vil vælge et tilfældigt tema fra en liste over dine yndlingstemaer:
ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")
Hvis du kun ved, hvilke temaer du ikke kan lide, kan du på samme måde tilføje dem til en ignoreret liste:
ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)
FAQ
Hvis du har nogle flere spørgsmål eller problemer, kan du måske finde en løsning i vores FAQ.
Avancerede emner
Hvis du er typen, der kan lide at få beskidte hænder, vil disse afsnit måske give genlyd.
Avanceret installation
Nogle brugere vil måske manuelt installere Oh My Zsh, eller ændre standardstien eller andre indstillinger, som installationsprogrammet accepterer (disse indstillinger er også dokumenteret øverst i installationsscriptet).
Brugerdefineret mappe
Standardplaceringen er ~/.oh-my-zsh
(skjult i din hjemmemappe, du kan få adgang til den med cd ~/.oh-my-zsh
)
Hvis du ønsker at ændre installationsmappen med miljøvariablen ZSH
, enten ved at køreexport ZSH=/your/path
før installationen, eller ved at indstille den før slutningen af installationspipelinen som denne:
ZSH="$HOME/.dotfiles/oh-my-zsh" sh install.sh
Uovervåget installation
Hvis du kører Oh My Zsh-installationsscriptet som en del af en automatiseret installation, kan du sendeflag --unattended
til install.sh
-scriptet. Dette vil have den effekt, at du ikke forsøger at ændre standardskallen, og det vil heller ikke køre zsh
, når installationen er færdig.
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended
Installation fra et forked repository
Installationsscriptet accepterer også disse variabler for at tillade installation af et andet repository:
-
REPO
(standard:ohmyzsh/ohmyzsh
): Dette tager form afowner/repository
. Hvis du indstiller denne variabel, vil installationsprogrammet søge efter et repository på -
REMOTE
(standard:): Dette er den fulde URL-adresse for git repositoryclone. Du kan bruge denne indstilling, hvis du vil installere fra en fork, der ikke er på GitHub (GitLab,Bitbucket…), eller hvis du vil klone med SSH i stedet for HTTPS (
[email protected]:user/project.git
).BEMÆRK: den er inkompatibel med indstilling af variablen
REPO
. Denne indstilling har forrang. -
BRANCH
(standard:master
): Du kan bruge denne indstilling, hvis du vil ændre standardgrenen til at blive tjekket ud, når du kloner repositoriet. Dette kan være nyttigt til at teste en Pull Request, eller hvis duvil bruge en anden gren endmaster
.
For eksempel:
REPO=apjanke/oh-my-zsh BRANCH=edge sh install.sh
Manuel installation
1. Clone repository
git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh
2. Tag eventuelt en sikkerhedskopi af din eksisterende ~/.zshrc
fil
cp ~/.zshrc ~/.zshrc.orig
3. Opret en ny zsh-konfigurationsfil
Du kan oprette en ny zsh-konfigurationsfil ved at kopiere den skabelon, som vi har inkluderet til dig.
cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
4. Opret en ny zsh-konfigurationsfil
Du kan oprette en ny zsh-konfigurationsfil ved at kopiere den skabelon, som vi har inkluderet til dig. Ændre din standard shell
chsh -s $(which zsh)
Du skal logge ud af din brugersession og logge ind igen for at se denne ændring.
5. Initialiser din nye zsh-konfiguration
Når du åbner et nyt terminalvindue, bør det indlæse zsh med Oh My Zsh’s konfiguration.
Installationsproblemer
Hvis du har problemer med at installere, er her et par almindelige løsninger.
- Du skal muligvis ændre din
PATH
i~/.zshrc
, hvis du ikke kan finde nogle kommandoer efter at have skiftet tiloh-my-zsh
. - Hvis du installerede manuelt eller ændrede installationsplacering, skal du kontrollere
ZSH
-miljøvariablen i~/.zshrc
.
Brugerdefinerede plugins og temaer
Hvis du vil tilsidesætte en af standardadfærdsmulighederne, skal du blot tilføje en ny fil (der slutter med .zsh
) i mappen custom/
.
Hvis du har mange funktioner, der passer godt sammen, kan du lægge dem som en XYZ.plugin.zsh
-fil i mappen custom/plugins/
og derefter aktivere dette plugin.
Hvis du ønsker at tilsidesætte funktionaliteten af et plugin distribueret med Oh My Zsh, skal du oprette et plugin af samme navn i mappen custom/plugins/
, og det vil blive indlæst i stedet for det i plugins/
.
Få opdateringer
Som standard vil du blive bedt om at tjekke for opgraderinger med nogle få ugers mellemrum. Hvis du vil have oh-my-zsh
til automatisk at opgradere sig selv uden at spørge dig, skal du indstille følgende i din ~/.zshrc
:
DISABLE_UPDATE_PROMPT=true
For at deaktivere automatiske opgraderinger skal du indstille følgende i din ~/.zshrc
:
DISABLE_AUTO_UPDATE=true
Manuelle opdateringer
Hvis du gerne vil opgradere på et hvilket som helst tidspunkt (måske har nogen lige udgivet et nyt plugin, og du ønsker ikke at vente en uge?) skal du blot køre:
omz update
Magic! 🎉
Afinstallation af Oh My Zsh
Oh My Zsh er ikke for alle. Vi vil savne dig, men vi ønsker at gøre dette til en nem opløsning.
Hvis du vil afinstallere oh-my-zsh
, skal du blot køre uninstall_oh_my_zsh
fra kommandolinjen. Det vil fjerne sig selv og vende tilbage til din tidligere bash
eller zsh
konfiguration.
Hvordan bidrager jeg til Oh My Zsh?
Hvor du deltager i vores dejlige fællesskab, skal du læse adfærdskodeksen.
Jeg er langt fra Zsh-ekspert og formoder, at der er mange måder at forbedre det på – hvis du har ideer til, hvordan konfigurationen kan gøres nemmere at vedligeholde (og hurtigere), så tøv ikke med at gafle og sende pull-forespørgsler!
Vi har også brug for folk til at teste pull-forespørgsler. Så tag et kig på de åbne problemer og hjælp, hvor du kan.
Se Bidrag for flere detaljer.
Send os IKKE temaer
Vi har (mere end) nok temaer for tiden. Tilføj venligst dit tema til den eksterne tema-wikiside.
Bidragsydere
Oh My Zsh har et livligt fællesskab af glade brugere og dejlige bidragsydere. Uden al den tid og hjælp fra vores bidragydere ville det ikke være så fantastisk.
Tak så meget!
Følg os
Vi er på de sociale medier:
- @ohmyzsh på Twitter. Du bør følge den.
- FaceBook poke os.
- Instagram tag os i dit indlæg, der viser Oh My Zsh!
- Discord for at chatte med os!
Merchandise
Vi har klistermærker, trøjer og kaffekrus til rådighed, så du kan vise din kærlighed til Oh My Zsh. Igen vil du blive byens samtaleemne!
Licens
Oh My Zsh er udgivet under MIT-licensen.