ohmyzsh / ohmyzsh

Oh My Zsh är ett öppen källkod, gemenskapsdrivet ramverk för att hantera din zsh-konfiguration.

Låter tråkigt. Låt oss försöka igen.

Oh My Zsh kommer inte att göra dig till en 10x utvecklare… men du kan känna dig som en.

När du väl har installerat ditt terminalskal kommer ditt terminalskal att bli stans samtalsämne eller så får du pengarna tillbaka! Med varje tangenttryckning i din kommandoprompt kommer du att dra nytta av hundratals kraftfulla plugins och vackra teman. Främlingar kommer att komma fram till dig på kaféer och fråga dig: ”det är fantastiskt! är du något slags geni?”

Äntligen kommer du att börja få den typ av uppmärksamhet som du alltid har känt att du förtjänar. …Eller så kanske du använder tiden du sparar till att börja använda tandtråd oftare. 😬

Om du vill veta mer kan du besöka ohmyz.sh, följa @ohmyzsh på Twitter och ansluta dig till oss på Discord.

Komma igång

Förutsättningar

  • Ett Unix-liknande operativsystem: macOS, Linux, BSD. På Windows: WSL2 är att föredra, men cygwin eller msys fungerar också oftast.
  • Zsh bör vara installerat (v4.3.9 eller nyare är bra, men vi föredrar 5.0.8 eller nyare). Om det inte är förinstallerat (kör zsh --version för att bekräfta), se följande wiki-instruktioner här: Installation av Zsh
  • curl eller wget bör installeras
  • git bör installeras (rekommenderas v2.4.11 eller högre)

Grundläggande installation

Oh My Zsh installeras genom att du kör ett av följande kommandon i terminalen. Du kan installera detta via kommandoraden med antingen curl, wget eller ett annat liknande verktyg.

Manuell inspektion

Det är en bra idé att inspektera installationsskriptet från projekt som du ännu inte känner till. Du kan göra det genom att först ladda ner installationsskriptet, titta igenom det så att allt ser normalt ut och sedan köra det:

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

Användning av Oh My Zsh

Plugins

Oh My Zsh levereras med en hel del plugins som du kan dra nytta av. Du kan ta en titt i plugins-katalogen och/eller wikin för att se vad som för närvarande finns tillgängligt.

Aktivering av plugins

När du hittar ett plugin (eller flera) som du vill använda med Oh My Zsh måste du aktivera dem i .zshrc-filen. Du hittar zshrc-filen i din katalog $HOME. Öppna den med din favorittextredigerare och du kommer att se en plats för att lista alla plugins som du vill ladda.

vi ~/.zshrc

Det kan till exempel börja se ut så här:

plugins=( git bundler dotenv osx rake rbenv ruby)

Bemärk att plugins är åtskilda av vitrymder (mellanslag, tabulatorer, nya rader…). Använd inte kommatecken mellan dem, annars går det sönder.

Användning av insticksprogram

Varje insticksprogram innehåller en README, som dokumenterar det. Denna README bör visa alias (om insticksprogrammet lägger till några) och extra godbitar som ingår i just det insticksprogrammet.

Teman

Vi erkänner det. Tidigt i Oh My Zsh-världen kan vi ha blivit lite för tema-glada. Vi har över etthundrafemtio teman nu paketerade. De flesta av dem har skärmdumpar på wikin (Vi arbetar på att uppdatera denna!). Kolla in dem!

Välj ett tema

Robbys tema är standardtemat. Det är inte det tjusigaste. Det är inte det enklaste. Det är bara det rätta (för honom).

När du har hittat ett tema som du vill använda måste du redigera ~/.zshrc-filen. Du kommer att se en miljövariabel (alla versaler) där som ser ut så här:

ZSH_THEME="robbyrussell"

Om du vill använda ett annat tema ändrar du helt enkelt värdet så att det matchar namnet på ditt önskade tema. Till exempel:

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

Notera: många teman kräver att Powerline Fonts installeras för att kunna återges korrekt.

Öppna ett nytt terminalfönster och din prompt bör se ut ungefär så här:

Om du inte hittade något tema som passar dina behov kan du ta en titt på wikin för att hitta fler av dem.

Om du känner dig kaxig kan du låta datorn välja ett slumpmässigt åt dig varje gång du öppnar ett nytt terminalfönster.

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

Och om du vill välja ett slumpmässigt tema från en lista med dina favoritteman:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Om du bara vet vilka teman du inte tycker om kan du på samma sätt lägga till dem i en lista med ignorerade teman:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Om du har några fler frågor eller problem kan du kanske hitta en lösning i vår FAQ.

Avancerade ämnen

Om du är typen som gillar att få händerna smutsiga kan de här avsnitten vara intressanta.

Avancerad installation

Vissa användare kanske vill installera Oh My Zsh manuellt, eller ändra standardsökvägen eller andra inställningar som installationsprogrammet accepterar (de här inställningarna finns också dokumenterade högst upp i installationsskriptet).

Anpassad katalog

Standardplaceringen är ~/.oh-my-zsh (gömd i din hemkatalog, du kan komma åt den med cd ~/.oh-my-zsh)

Om du vill ändra installationskatalogen med miljövariabeln ZSH, antingen genom att köraexport ZSH=/your/path innan du installerar, eller genom att ställa in den före slutet av installationspipelinjen som här:

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

Obevakad installation

Om du kör Oh My Zsh-installationsskriptet som en del av en automatiserad installation kan du skicka flaggan --unattended till install.sh-skriptet. Detta kommer att leda till att du inte försöker ändra standardskalet, och du kommer inte heller att köra zsh när installationen är klar.

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

Installera från ett förgrenat arkiv

Installationsskriptet accepterar också dessa variabler för att möjliggöra installation från ett annat arkiv:

  • REPO (standard: ohmyzsh/ohmyzsh): detta tar formen av owner/repository. Om du ställer in denna variabel kommer installationsprogrammet att leta efter ett arkiv på

  • REMOTE (standard: ): detta är den fullständiga URL:en för git repositoryclone. Du kan använda den här inställningen om du vill installera från en gaffel som inte finns på GitHub (GitLab,Bitbucket…) eller om du vill klona med SSH istället för HTTPS ([email protected]:user/project.git).

    OBS: den är inkompatibel med att ställa in variabeln REPO. Denna inställning har företräde.

  • BRANCH (standard: master): Du kan använda den här inställningen om du vill ändra standardgrenen till att vara utcheckad när du klonar arkivet. Detta kan vara användbart för att testa en Pull Request, eller om du vill använda en annan gren än master.

Till exempel:

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

Manuell installation

1. Klona förrådet
git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh
2. Säkerhetskopiera eventuellt din befintliga ~/.zshrc-fil
cp ~/.zshrc ~/.zshrc.orig
3. Skapa en ny zsh-konfigurationsfil

Du kan skapa en ny zsh-konfigurationsfil genom att kopiera mallen som vi har inkluderat åt dig.

cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
4. Ändra ditt standardskal
chsh -s $(which zsh)

Du måste logga ut från din användarsession och logga in igen för att se den här ändringen.

5. Initialisera din nya zsh-konfiguration

När du öppnar ett nytt terminalfönster bör det ladda zsh med Oh My Zshs konfiguration.

Installationsproblem

Om du har några problem vid installationen finns här några vanliga lösningar.

  • Du kan behöva ändra din PATH i ~/.zshrc om du inte kan hitta vissa kommandon efter att ha bytt till oh-my-zsh.
  • Om du har installerat manuellt eller ändrat installationsplatsen ska du kontrollera miljövariabeln ZSH i ~/.zshrc.

Anpassade insticksprogram och teman

Om du vill åsidosätta något av standardbeteendena lägger du bara till en ny fil (som slutar med .zsh) i custom/-katalogen.

Om du har många funktioner som går bra ihop kan du lägga dem som en XYZ.plugin.zsh-fil i custom/plugins/-katalogen och sedan aktivera detta insticksprogram.

Om du vill åsidosätta funktionaliteten hos ett insticksprogram som distribueras med Oh My Zsh skapar du ett insticksprogram med samma namn i katalogen custom/plugins/ och det kommer att laddas istället för det i plugins/.

Hämta uppdateringar

Som standard kommer du att uppmanas att kontrollera om det finns uppdateringar med några veckors mellanrum. Om du vill att oh-my-zsh ska uppgradera sig själv automatiskt utan att fråga dig ställer du in följande i din ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

För att inaktivera automatiska uppgraderingar ställer du in följande i din ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Manuella uppdateringar

Om du vill uppgradera när som helst (kanske har någon precis släppt ett nytt insticksmodul och du vill inte vänta en vecka?) behöver du bara köra:

omz update

Magic! 🎉

Avinstallera Oh My Zsh

Oh My Zsh är inte för alla. Vi kommer att sakna dig, men vi vill göra detta till ett enkelt uppbrott.

Om du vill avinstallera oh-my-zsh, kör bara uninstall_oh_my_zsh från kommandoraden. Det kommer att ta bort sig självt och återställa din tidigare bash eller zsh konfiguration.

Hur bidrar jag till Oh My Zsh?

Innan du deltar i vår förtjusande gemenskap, vänligen läs uppförandekoden.

Jag är långt ifrån Zsh-expert och misstänker att det finns många sätt att förbättra – om du har idéer om hur konfigurationen kan göras lättare att underhålla (och snabbare), tveka inte att gaffla och skicka pull-requests!

Vi behöver också folk som kan testa pull-requests. Så ta en titt på de öppna frågorna och hjälp till där du kan.

Se Bidrag för mer information.

Skicka INTE teman till oss

Vi har (mer än) tillräckligt med teman för tillfället. Lägg till ditt tema på wikisidan för externa teman.

Bidragsgivare

Oh My Zsh har en livlig gemenskap av glada användare och förtjusande bidragsgivare. Utan all tid och hjälp från våra bidragsgivare skulle det inte vara så fantastiskt.

Tack så mycket!

Följ oss

Vi finns på sociala medier:

  • @ohmyzsh på Twitter. Du borde följa den.
  • FaceBook poke oss.
  • Instagram tagga oss i ditt inlägg som visar Oh My Zsh!
  • Discord för att chatta med oss!

Merchandise

Vi har klistermärken, tröjor och kaffemuggar tillgängliga för dig som vill visa upp din kärlek till Oh My Zsh. Återigen kommer du att bli stans samtalsämne!

Licens

Oh My Zsh är släppt under MIT-licensen.

Om Planet Argon

Lämna ett svar

Din e-postadress kommer inte publiceras.