2020-08-23 20:29:47 +08:00
< img src = "https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align = "left" width = "192px" height = "192px" / >
< img align = "left" width = "0" height = "192px" hspace = "10" / >
2020-08-24 02:10:47 +08:00
> Het <a href="http://fishshell.com">Fish-shell</a>framework
2020-08-23 20:29:47 +08:00
[![MIT License ](https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square )](/LICENSE) [![Fish Shell Version ](https://img.shields.io/badge/fish-≥v2.2.0-007EC7.svg?style=flat-square )](http://fishshell.com) [![Travis Build Status ](http://img.shields.io/travis/oh-my-fish/oh-my-fish.svg?style=flat-square )](https://travis-ci.org/oh-my-fish/oh-my-fish) [![Slack Status ](https://oh-my-fish-slack.herokuapp.com/badge.svg )](https://oh-my-fish-slack.herokuapp.com)
2020-08-24 02:10:47 +08:00
Oh My Fish biedt kerninfrastructuur zodat u pakketten kunt installeren om uw shell uit te breiden of aan te passen. Het is snel, uitbreidbaar en eenvoudig te gebruiken.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
> Ook beschikbaar in het
2020-12-01 02:34:00 +08:00
> <a href="../../README.md">🇺🇸</a>
> <a href="../es-ES/README.md">🇪🇸</a>
> <a href="../pt-BR/README.md">🇧🇷</a>
> <a href="../ru-RU/README.md">🇷🇺</a>
> <a href="../uk-UA/README.md">🇺🇦</a>
> <a href="../zh-CN/README.md">🇨🇳</a>
2020-08-23 20:29:47 +08:00
< br >
2020-08-24 02:10:47 +08:00
## Inhoudsopgave
* [Installatie ](#installation )
* [Aan de slag (uitleg omtrent opdrachten) ](#getting-started )
* [Geavanceerd ](#advanced )
* [Opstarten ](#startup )
* [Puntbestanden ](#dotfiles )
* [Pakketten maken ](#creating-packages )
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
## Installatie
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
U kunt direct aan de slag door deze opdracht uit te voeren in een terminalvenster:
2020-08-23 20:29:47 +08:00
```fish
curl -L https://get.oh-my.fish | fish
```
2020-08-24 02:10:47 +08:00
Hiermee downloadt u het installatiescript en voert u de standaardinstallatie uit. Indien gewenst kunt u het installatiescript downloaden en aanvullende opties opgeven:
2020-08-23 20:29:47 +08:00
```fish
curl -L https://get.oh-my.fish > install
fish install --path=~/.local/share/omf --config=~/.config/omf
```
2020-08-24 02:10:47 +08:00
U kunt de integriteit van het installatiescript verifiëren met [deze controlesom ](bin/install.sha256 ):
2020-08-23 20:29:47 +08:00
```
bb1f4025934600ea6feef2ec11660e17e2b6449c5a23c033860aed712ad328c9 install
```
2020-08-24 02:10:47 +08:00
Ook kunt u Oh My Fish installeren middels Git of een offline-brontarball van de [uitgavenpagina][releases]:
2020-08-23 20:29:47 +08:00
```fish
2020-08-24 02:10:47 +08:00
# middels git
2020-08-23 20:29:47 +08:00
$ git clone https://github.com/oh-my-fish/oh-my-fish
$ cd oh-my-fish
$ bin/install --offline
2020-08-24 02:10:47 +08:00
# middels een tarball
2020-08-23 20:29:47 +08:00
$ curl -L https://get.oh-my.fish > install
$ fish install --offline=omf.tar.gz
```
2020-08-24 02:10:47 +08:00
Voer `install --help` uit om een volledige lijst met installatieopties te bekijken.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
#### Vereisten
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
- **fish**-shell, versie 2.2 of hoger
- **git**, versie 1.9.5 of hoger
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
#### Gemelde problemen
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
- Door een bug in Fish 2.6 in sommige terminalemulators zijn opdrachtregels aan de rechterkant momenteel onbruikbaar.
OMF's `standaard` thema maakt hier gebruik van, dus raden wij aan een alternatief thema te gebruiken tot het probleem is opgelost.
(zie [#541 ](https://github.com/oh-my-fish/oh-my-fish/issues/541 ))
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
## Aan de slag
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Oh My Fish bevat het hulpprogramma `omf` om pakketten en thema's op te halen en te installeren.
2020-08-23 20:29:47 +08:00
#### `omf update` _`[omf]`_ _`[<package>...]`_
2020-08-24 02:10:47 +08:00
Werk Oh My Fish, alle pakketbronnen en geïnstalleerde pakketten bij.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
- Zonder opdrachtregelopties worden de kern en alle geïnstalleerde pakketten bijgewerkt.
- Voer `omf update omf` uit om alleen de kern bij te werken.
- Geef pakketnamen op om alleen specifieke pakketten bij te werken. U kunt hieraan desgewenst "omf" toevoegen om ook de kern bij te werken.
2020-08-23 20:29:47 +08:00
#### `omf install` _`[<name>|<url>]`_
2020-08-24 02:10:47 +08:00
Installeer één _of meerdere_ pakketten.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
- U kunt pakketten installeren door een url op te geven met `omf install url`
- Zonder opdrachtregelopties worden alleen ontbrekende pakketten geïnstalleerd uit de [bundel ](#dotfiles ).
2020-08-23 20:29:47 +08:00
#### `omf repositories` _`[list|add|remove]`_
2020-08-24 02:10:47 +08:00
Beheer eigen toegevoegde pakketbronnen. Pakketbronnen bevatten de pakketten die kunnen worden geïnstalleerd met `omf install` . Standaard is alleen de [officiële pakketbron ](https://github.com/oh-my-fish/packages-main ) beschikbaar.
2020-08-23 20:29:47 +08:00
#### `omf list`
2020-08-24 02:10:47 +08:00
Toon alle geïnstalleerde pakketten.
2020-08-23 20:29:47 +08:00
#### `omf theme` _`<theme>`_
2020-08-24 02:10:47 +08:00
Pas een thema toe. Bekijk alle beschikbare thema's met `omf theme` . U kunt ze ook [voorvertonen ](./docs/Themes.md ).
2020-08-23 20:29:47 +08:00
#### `omf remove` _`<name>`_
2020-08-24 02:10:47 +08:00
Verwijder een thema of pakket.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
> Pakketten kunnen deïnstallatieopties bevatten zodat er aangepaste opschoning kan plaatsvinden. Lees voor meer informatie [Deïnstalleren](/docs/nl-NL/Packages.md#uninstall).
2020-08-23 20:29:47 +08:00
#### `omf reload`
2020-08-24 02:10:47 +08:00
Herlaad Oh My Fish en alle plug-ins door `exec` uit te voeren om alle huidige shellprocessen te vervangen door een nieuw proces.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
> Deze opdracht probeert zo veilig mogelijk te werk te gaan en bijwerkingen van `exec` te voorkomen.
2020-08-23 20:29:47 +08:00
#### `omf new plugin | theme` _`<name>`_
2020-08-24 02:10:47 +08:00
Maak een nieuwe plug-in of nieuw thema.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
> Hiermee maakt u een nieuwe map `$OMF_CONFIG/{pkg | themes}/` aan met een sjabloon.
2020-08-23 20:29:47 +08:00
#### `omf search` _`-t|--theme / -p|--package`_ _`<name>`_
2020-08-24 02:10:47 +08:00
Zoek een specifiek pakket, thema of beide in Oh My Fish's databank. Als u de naam niet kent, is eenvoudig zoeken mogelijk met `omf search simple` .
2020-08-23 20:29:47 +08:00
#### `omf channel`
2020-08-24 02:10:47 +08:00
Toon of wijzig het updatekanaal.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Standaard zijn er twee kanalen beschikbaar: `stable` , welke stabiele updates aanbiedt op basis van de nieuwste tag en `dev` , welke updates aanbiedt met de allernieuwste code die vaak nog in ontwikkeling is. Het ingestelde updatekanaal bepaalt welke versie `omf update` installeert.
2020-08-23 20:29:47 +08:00
#### `omf doctor`
2020-08-24 02:10:47 +08:00
Voer dit uit om foutopsporingsinformatie vast te leggen voor [een 'issue'][omf-issues-new].
2020-08-23 20:29:47 +08:00
#### `omf destroy`
2020-08-24 02:10:47 +08:00
Deïnstalleer Oh My Fish.
2020-08-23 20:29:47 +08:00
2020-08-24 02:11:28 +08:00
## Geavanceerd
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Het Oh My Fish-installatiescript voegt een knipsel toe aan de Fish-configuratiebestanden (`~/.config/fish/conf.d/`) dat OMF's opstartcode aanroept.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Let op: de scripts in bovenstaande map worden uitgevoerd op basis van de volgorde die het bestandssysteem aanhoudt,
dus kan het nuttig zijn scriptbestanden aan te duiden met een getal.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Voorbeeld: `a_script.fish` geniet de voorkeur boven het `omf.fish` -knipsel.
Dus als `a_script.fish` afhankelijk is van door OMF beheerde plug-ins, is het raadzaam om de naam van het scriptbestand te wijzigen in `xx_a_script.fish` .
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Als een script moet worden uitgevoerd voordat `omf.fish` wordt aangeroepen, kunt u het aanduiden met `00_` .
Ook kunt u `~/.config/omf/before.init.fish` hiervoor gebruiken.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
### Opstarten
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Telkens als u een nieuwe shell opent, initialiseert de opstartcode het Oh My Fish-installatie- en _config_ -pad (standaard: `~/.config/omf` ),
waardoor het [`init.fish` ](init.fish )-script naderhand wordt aangeroepen. Dit script bevat een lijst met geïnstalleerde pakketten, thema's en aangepaste init-bestanden.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Lees voor meer informatie de [veelgestelde vragen ](docs/nl-NL/FAQ.md#what-does-oh-my-fish-do-exactly ).
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
### Puntbestanden
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
De `$OMF_CONFIG` -map duidt de gebruikersstatus van Oh My Fish aan. Dit is dé perfecte map om toe te voegen aan uw puntbestanden en/of versiebeheersysteem. De map bevat drie belangrijke bestanden:
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
- __`theme`__ - het huidige thema
- __`bundle`__ - de lijst met geïnstalleerde pakketten en thema's
- __`channel`__ - het OMF-updatekanaal (stable of dev)
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Verder kunt u deze speciale bestanden aanmaken of aanpassen:
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
- __`init.fish`__ - aangepast script dat wordt uitgevoerd na het starten van de shell
- __`before.init.fish`__ - aangepast script dat wordt uitgevoerd vóór het starten van de shell
- __`key_bindings.fish`__ - aangepaste sneltoetsen die kunnen worden toegewezen met de opdracht `bind`
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
#### Variabelen instellen in `init.fish`
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Eén van de meestgebruikte opstartopdrachten in `init.fish` is de variabelendefinitie. Zulke variabelen dienen beschikbaar te zijn in elke shellsessie. Dit kan bijvoorbeeld middels het volgende:
2020-08-23 20:29:47 +08:00
```fish
2020-08-24 02:10:47 +08:00
# Voor Golang-ontwikkelaars
2020-08-23 20:29:47 +08:00
set -xg GOPATH $HOME/gocode
2020-08-24 02:10:47 +08:00
# Voor Python-ontwikkelaars
2020-08-23 20:29:47 +08:00
set -xg PYTHONDONTWRITEBYTECODE 1
```
2020-08-24 02:10:47 +08:00
#### Over de bundel
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Telkens als een pakket of thema geïnstalleerd of verwijderd wordt, wordt het `bundle` -bestand bijgewerkt. U kunt dit bestand tevens handmatig aanpassen en nadien `omf install` uitvoeren om de wijzigingen toe te passen. Let op: als pakketten of thema's automatisch geïnstalleerd zijn, leidt verwijderen uit de bundel niet tot deïnstallatie.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
#### Oudere Fish-versies
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Fish 2.2 bevat geen `conf.d` -map, dus dient de opstartcode toegevoegd te worden aan het Fish-configuratiebestand (`~/.config/fish/config.fish`).
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Het is raadzaam om uw aangepaste opstartopdracht toe te voegen aan `init.fish` in plaats van `~/.config/fish/config.fish` , zodat de gehele `$OMF_CONFIG` -map beschikbaar blijft voor versiebeheer.
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Als opstartopdrachten uitgevoerd dienen te worden *vóór* Oh My Fish start, voeg ze dan toe aan `before.init.fish` . Voeg bij twijfel alles toe aan `init.fish` .
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
## Pakketten maken
2020-08-23 20:29:47 +08:00
2020-08-24 02:10:47 +08:00
Oh My Fish gebruikt een geavanceerde, goedgedocumenteerde plug-inarchitectuur om het maken van plug-ins te vereenvoudigen, inclusief init- en uninstall-opties, functies en automatische aanvulling. Lees voor meer informatie [de pakketdocumentatie ](docs/nl-NL/Packages.md ).
2020-08-23 20:29:47 +08:00
[fishshell]: http://fishshell.com
[contributors]: https://github.com/oh-my-fish/oh-my-fish/graphs/contributors
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls
[omf-issues-new]: https://github.com/oh-my-fish/oh-my-fish/issues/new
[releases]: https://github.com/oh-my-fish/oh-my-fish/releases