ohmyzsh / ohmyzsh

Oh My Zsh is een open source, community-gedreven raamwerk voor het beheren van uw zsh-configuratie.

Klinkt saai. Laten we het nog eens proberen.

Oh My Zsh zal u geen 10x ontwikkelaar maken…maar u kunt zich wel zo voelen.

Eenmaal geïnstalleerd, zal uw terminal shell het gesprek van de dag worden of uw geld terug! Met elke toetsaanslag in uw opdrachtprompt, zult u profiteren van de honderden krachtige plugins en prachtige thema’s. Vreemden zullen naar je toe komen in cafés en vragen, “dat is geweldig! ben je een soort genie?”

Eindelijk zul je het soort aandacht krijgen dat je altijd al vond dat je verdiende. …of misschien gebruik je de bespaarde tijd om vaker te flossen. 😬

Voor meer informatie gaat u naar ohmyz.sh, volgt u @ohmyzsh op Twitter en kunt u ons volgen op Discord.

Aan de slag

Vereisten

  • Een Unix-achtig besturingssysteem: macOS, Linux, BSD. Op Windows: WSL2 heeft de voorkeur, maar cygwin of msys werken meestal ook.
  • Zsh moet geïnstalleerd zijn (v4.3.9 of recenter is prima, maar we geven de voorkeur aan 5.0.8 en nieuwer). Indien niet voorgeïnstalleerd (voer zsh --version uit om te bevestigen), bekijk dan de volgende wiki instructies hier: Installeren van ZSH
  • curl of wget moet zijn geïnstalleerd
  • git moet zijn geïnstalleerd (aanbevolen v2.4.11 of hoger)

Basisinstallatie

Oh My Zsh wordt geïnstalleerd door het uitvoeren van een van de volgende commando’s in uw terminal. U kunt dit via de command-line installeren met curl, wget of een ander soortgelijk gereedschap.

Handmatige inspectie

Het is een goed idee om het installatiescript te inspecteren van projecten die u nog niet kent. U kunt dat doen door het installatiescript eerst te downloaden, het door te kijken zodat alles er normaal uitziet, en het dan uit te voeren:

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

Oh My Zsh gebruiken

Plugins

Oh My Zsh komt met een shitload aan plugins waar u uw voordeel mee kunt doen. U kunt een kijkje nemen in de plugins directory en/of de wiki om te zien wat er momenteel beschikbaar is.

Plugins inschakelen

Als u een plugin (of meerdere) hebt gevonden die u wilt gebruiken met Oh My Zsh, dan moet u ze inschakelen in het .zshrc bestand. Je vindt het zshrc bestand in je $HOME directory. Open het met je favoriete tekst editor en je zult een plek zien om een lijst te maken van alle plugins die je wilt laden.

vi ~/.zshrc

Voorbeeld, dit zou er zo uit kunnen zien:

plugins=( git bundler dotenv osx rake rbenv ruby)

Merk op dat de plugins gescheiden worden door witruimte (spaties, tabs, nieuwe regels…). Gebruik geen komma’s ertussen of het zal breken.

Plugins gebruiken

Elke plugin bevat een README, waarin het gedocumenteerd wordt. Deze README zou de aliassen moeten tonen (als de plugin er een toevoegt) en extra goodies die zijn inbegrepen in die specifieke plugin.

Thema’s

We zullen het toegeven. Vroeg in de Oh My Zsh wereld, zijn we misschien een beetje te thema gelukkig geworden. We hebben nu meer dan honderdvijftig thema’s gebundeld. Van de meeste staan screenshots op de wiki (We werken eraan om dit bij te werken!). Bekijk ze!

Een Thema Kiezen

Robby’s thema is het standaard thema. Het is niet het mooiste. Het is niet het eenvoudigste. Het is gewoon de juiste (voor hem).

Als u een thema heeft gevonden dat u wilt gebruiken, moet u het ~/.zshrc bestand bewerken. U zult daar een omgevingsvariabele (allemaal hoofdletters) zien die er als volgt uitziet:

ZSH_THEME="robbyrussell"

Om een ander thema te gebruiken, verandert u gewoon de waarde zodat die overeenkomt met de naam van het gewenste thema. Bijvoorbeeld:

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

Merk op: veel thema’s vereisen de installatie van Powerline Fonts om goed te kunnen renderen.

Open een nieuw terminal venster en uw prompt zou er ongeveer zo uit moeten zien:

In het geval dat u geen geschikt thema heeft gevonden voor uw behoeften, kijk dan op de wiki voor meer van deze thema’s.

Als u een beetje stoer bent, kunt u de computer een willekeurig thema laten kiezen telkens wanneer u een nieuw terminalvenster opent.

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

En als u een willekeurig thema wilt kiezen uit een lijst van uw favoriete thema’s:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Als u alleen weet welke thema’s u niet leuk vindt, kunt u ze op dezelfde manier toevoegen aan een genegeerde lijst:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Als u nog meer vragen of problemen hebt, vindt u misschien een oplossing in onze FAQ.

Geavanceerde onderwerpen

Als u het type bent dat graag de handen vuil maakt, dan zijn deze secties misschien iets voor u.

Geavanceerde installatie

Sommige gebruikers willen misschien Oh My Zsh handmatig installeren, of het standaardpad of andere instellingen die het installatieprogramma accepteert, wijzigen (deze instellingen zijn ook gedocumenteerd bovenaan het installatiescript).

Aangepaste directory

De standaard locatie is ~/.oh-my-zsh (verborgen in uw home directory, u kunt het benaderen met cd ~/.oh-my-zsh)

Als u de installatie directory wilt veranderen met de ZSH omgevingsvariabele, hetzij doorexport ZSH=/your/path uit te voeren voor de installatie, of door het in te stellen voor het einde van de installatie pijplijn, zoals dit:

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

Onbeheerde installatie

Als u het Oh My Zsh installatiescript uitvoert als onderdeel van een geautomatiseerde installatie, kunt u de vlag --unattended doorgeven aan het install.sh script. Dit zal niet proberen om de standaard shell te veranderen, en zal ook zsh niet uitvoeren als de installatie klaar is.

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

Installeren vanuit een gevorkte repository

Het installatiescript accepteert ook deze variabelen om de installatie van een andere repository mogelijk te maken:

  • REPO (standaard: ohmyzsh/ohmyzsh): dit heeft de vorm van owner/repository. Als je deze variabele instelt, zal het installatieprogramma zoeken naar een repository op

  • REMOTE (standaard: ): dit is de volledige URL van de git repositoryclone. Je kunt deze instelling gebruiken als je wilt installeren vanaf een fork die niet op GitHub staat (GitLab, Bitbucket…) of als je wilt clonen met SSH in plaats van HTTPS ([email protected]:user/project.git).

    -NOOT: het is onverenigbaar met het instellen van de REPO variabele. Deze instelling heeft voorrang.

  • BRANCH (standaard: master): je kunt deze instelling gebruiken als je de standaard branch wilt wijzigen die wordt uitgecheckt bij het clonen van het repository. Dit kan handig zijn voor het testen van een Pull Request, of als u een andere branch dan master wilt gebruiken.

Voorbeeld:

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

Handmatige installatie

1. Kloon de repository
git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh
2. Maak eventueel een backup van uw bestaande ~/.zshrc bestand
cp ~/.zshrc ~/.zshrc.orig
3. Maak een nieuw zsh configuratiebestand

U kunt een nieuw zsh configuratiebestand maken door het sjabloon te kopiëren dat wij voor u hebben meegeleverd.

cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc
4. Wijzig uw standaard shell
chsh -s $(which zsh)

U moet uitloggen uit uw gebruikerssessie en weer inloggen om deze wijziging te zien.

5. Initialiseer uw nieuwe zsh configuratie

Als u een nieuw terminal venster opent, zou het zsh moeten laden met Oh My Zsh’s configuratie.

Installatie Problemen

Als u problemen ondervindt bij het installeren, zijn hier een paar veel voorkomende oplossingen.

  • U moet misschien uw PATH in ~/.zshrc aanpassen als u sommige commando’s niet kunt vinden na het overschakelen naar oh-my-zsh.
  • Als u handmatig installeerde of de installatielocatie veranderde, controleer dan de ZSH omgevingsvariabele in ~/.zshrc.

Aangepaste Plugins en Thema’s

Als u een van de standaard gedragingen wilt overschrijven, voeg dan gewoon een nieuw bestand toe (eindigend op .zsh) in de custom/ directory.

Als u veel functies heeft die goed samengaan, kunt u ze als een XYZ.plugin.zsh bestand in de custom/plugins/ directory zetten en dan deze plugin inschakelen.

Als u de functionaliteit van een plugin die met Oh My Zsh wordt gedistribueerd wilt overschrijven, maak dan een plugin met dezelfde naam in de custom/plugins/ directory en deze zal worden geladen in plaats van de plugin in plugins/.

Updates krijgen

Standaard wordt u om de paar weken gevraagd om te controleren of er upgrades zijn. Als u wilt dat oh-my-zsh zichzelf automatisch upgradet zonder u daarom te vragen, stelt u het volgende in uw ~/.zshrc:

DISABLE_UPDATE_PROMPT=true

Om automatische upgrades uit te schakelen, stelt u het volgende in uw ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Handmatige Updates

Als u op elk moment wilt upgraden (misschien heeft iemand net een nieuwe plugin uitgebracht en wilt u geen week wachten?) hoeft u alleen maar het volgende uit te voeren:

omz update

Magic! 🎉

Oh My Zsh verwijderen

Oh My Zsh is niet voor iedereen. We zullen je missen, maar we willen dit een makkelijke onderbreking maken.

Als je oh-my-zsh wilt verwijderen, draai dan uninstall_oh_my_zsh vanaf de command-line. Het zal zichzelf verwijderen en uw vorige bash of zsh configuratie terugzetten.

Hoe kan ik bijdragen aan Oh My Zsh?

Voordat u deelneemt aan onze geweldige gemeenschap, lees alstublieft de gedragscode.

Ik ben verre van een Zsh expert en vermoed dat er veel manieren zijn om te verbeteren – als je ideeën hebt over hoe de configuratie makkelijker te onderhouden (en sneller) kan worden, aarzel dan niet om pull-requests te forken en te sturen!

We hebben ook mensen nodig om pull-requests uit te testen. Dus kijk eens naar de open issues en help waar je kunt.

Zie Bijdragen voor meer details.

Stuur ons GEEN themes

We hebben (meer dan) genoeg themes voor het moment. Voeg uw thema toe aan de externe thema wiki pagina.

Bijdragers

Oh My Zsh heeft een levendige gemeenschap van gelukkige gebruikers en verrukkelijke bijdragers. Zonder alle tijd en hulp van onze medewerkers, zou het niet zo geweldig zijn.

Hartelijk dank!

Volg ons

We zijn op sociale media:

  • @ohmyzsh op Twitter. Je zou het moeten volgen.
  • FaceBook poke ons.
  • Instagram tag ons in je post waarin je Oh My Zsh laat zien.
  • Discord om met ons te chatten.

Merchandise

We hebben stickers, shirts en koffiemokken beschikbaar voor je om je liefde voor Oh My Zsh te laten zien. Nogmaals, u zult het gesprek van de dag worden!

Licentie

Oh My Zsh is uitgebracht onder de MIT-licentie.

Over Planet Argon

Geef een antwoord

Het e-mailadres wordt niet gepubliceerd.