ohmyzsh / ohmyzsh

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 eller wget 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 af owner/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 end master.

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 til oh-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.

Om Planet Argon

Skriv et svar

Din e-mailadresse vil ikke blive publiceret.