You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
oh-my-fish/docs/nl-NL/Packages.md

131 lines
5.8 KiB
Markdown

4 years ago
<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="128px" height="128px"/>
<img align="left" width="0" height="128px"/>
4 years ago
# Pakketten
4 years ago
4 years ago
> Oh My Fish-documentatie&nbsp;&bull;&nbsp;Ook beschikbaar in het
> <a href="../en-US/Packages.md">🇺🇸</a>
> <a href="../es-ES/Packages.md">🇪🇸</a>
> <a href="../pt-BR/Packages.md">🇧🇷</a>
4 years ago
> <a href="../ru-RU/Packages.md">🇷🇺</a>
> <a href="../uk-UA/Packages.md">🇺🇦</a>
> <a href="../zh-CN/Packages.md">🇨🇳</a>
4 years ago
<br>
4 years ago
# Maken
4 years ago
4 years ago
Om pakketten te leren maken, gaat u een nieuw pakket volgens een sjabloon maken. Dit pakket bevat een `hello_world`-opdracht voor uw shell. Pakketnamen mogen alleen kleine letters en streepjes bevatten.
4 years ago
4 years ago
Oh My Fish kan een pakketstructuur voor u samenstellen. Gebruik hiervoor `omf new`:
4 years ago
```fish
$ omf new plugin hello_world
```
4 years ago
> Voer `omf new theme my_theme_name` uit om thema's te maken.
4 years ago
4 years ago
Er wordt overgeschakeld van de huidige map naar die van het pakket:
4 years ago
```
$ ls -l
README.md
init.fish
functions/hello_world.fish
completions/hello_world.fish
```
4 years ago
>Omschrijf altijd in `README.md` hoe uw pakket werkt.
4 years ago
4 years ago
>Lees meer over [automatisch aanvullen](http://fishshell.com/docs/current/commands.html#complete) en gebruik het zorgvuldig.
4 years ago
4 years ago
`functions/hello_world.fish` omvat een enkele functie:
4 years ago
```fish
4 years ago
function hello_world -d "Toont hallo wereld"
echo "Hallo wereld!"
4 years ago
end
```
4 years ago
Elke functie in uw pakket dient te worden verklaard in een bestand in elke `functions`-map. Fish vereist dit voor het automatisch laden, welke functies op afroep laadt, zodat ongebruikte functies niet worden geladen.
4 years ago
4 years ago
Let op: Fish bevat geen private scope, dus als u uw pakket moet splitsen in functies, voorkom dan dubbele namen door een aanduiding te gebruiken, zoals uw pakketnaam (bijv. `hello_world_print_help`). Om de opdrachtnamespace niet te bezaaien met onnodige functies, kunt u privéfuncties aanduiden met twee onderliggende streepjes (bijv. `__function_name_print_help`).
4 years ago
# Hooks
4 years ago
Oh My Fish bevat een 'hooks'-systeem waarmee u scripts kunt maken voor uw pakket die worden uitgevoerd als andere gebeurtenissen plaatsvinden. Pakketten kunnen deze hooks gebruiken om geavanceerde installatie te bieden, aangepaste bronnen, etc. Hooks zijn eigenlijk Fish-scripts die genoemd zijn naar de gebeurtenis die ze aanroepen. De meeste hooks staan in een `hooks`-map in de projectmap van het pakket.
4 years ago
4 years ago
>Hooks die worden aangeroepen tijdens het opstarten (`init.fish` en `key_bindings.fish`) kunnen het starten van de shell vertragen. Voorkom dus langzame code tijdens het starten! Als uw pakket geen hook nodig heeft, verwijder dan het bestand.
4 years ago
4 years ago
De werkmap in een hook is altijd ingesteld op de hoofdmap van het pakket. De momenteel door Oh My Fish ondersteunde hooks staan hieronder:
4 years ago
## `init`
4 years ago
De `init`-hook wordt uitgevoerd tijdens het starten van de shell. Scripts die deze hook aanroepen dienen te worden geplaatst in `init.fish` in de hoofdmap van het pakket.
4 years ago
4 years ago
Binnen deze hook heeft u toegang tot drie gerelateerde variabelen:
4 years ago
4 years ago
* `$package`: pakketnaam
* `$path`: pakketinstallatiepad
* `$dependencies`: pakketafhankelijkheden
4 years ago
4 years ago
Voorbeeld: met een `init.fish`-script die de code
4 years ago
```fish
echo "hello_world initialized"
```
4 years ago
bevat, ziet u de regel `hello_world is geïnitialiseerd` bovenaan het terminalvenster als de shell net is gestart.
4 years ago
4 years ago
Gebruik deze hook om de omgeving aan te passen, bronnen te laden, functies automatisch te laden, etc. Als uw pakket geen functie aanroept, kunt u hiermee functionaliteit toevoegen aan uw pakket of dynamische functies samenstellen.
4 years ago
## `key_bindings`
4 years ago
Als uw pakket of thema sneltoetsen gebruikt, stel deze dan in in de `key_bindings`-hook. Sneltoetsscripts dienen geplaatst te worden in `key_bindings.fish` in de hoofdmap van het pakket. Binnen deze hook kunt u de [`bind`][fish-bind]-opdracht vrij gebruiken om aangepaste sneltoetsen in te stellen.
4 years ago
4 years ago
>Thema's kunnen ook sneltoetsen bevatten! Oh My Fish herlaadt de sneltoetsen als u overschakelt naar een ander thema.
4 years ago
## `install`
4 years ago
De `install`-hook wordt aangeroepen als een pakket voor het eerst wordt geïnstalleerd. Scripts die deze hook gebruiken dienen te worden geplaatst in `hooks/install.fish`.
4 years ago
4 years ago
Binnen deze hook heeft u toegang tot twee gerelateerde variabelen:
4 years ago
4 years ago
* `$package`: pakketnaam
* `$path`: pakketinstallatiepad
4 years ago
4 years ago
Deze hook is handig voor het downloaden van aanvullende bronnen, instellen van Git-submodules of het installeren van externe afhankelijkheden, zoals Bash-scripts.
4 years ago
## `update`
4 years ago
Zoals de naam doet vermoeden wordt de `update`-hook aangeroepen nadat een pakket is bijgewerkt. Scripts die deze hook gebruiken dienen te worden geplaatst in `hooks/update.fish`.
4 years ago
4 years ago
Binnen deze hook heeft u toegang tot twee gerelateerde variabelen:
4 years ago
4 years ago
* `$package`: pakketnaam
* `$path`: pakketinstallatiepad
4 years ago
4 years ago
Deze hook is handig voor het bijwerken van Git-submodules of controleren op nieuwe versies van externe afhankelijkheden.
4 years ago
## `uninstall`
4 years ago
De `uninstall`-hook wordt aangeroepen vlak voordat een pakket wordt verwijderd middels `omf remove <pkg>`. Scripts die deze hook gebruiken dienen te worden geplaatst in `hooks/uninstall.fish`.
4 years ago
4 years ago
Binnen deze hook heeft u toegang tot twee gerelateerde variabelen:
4 years ago
4 years ago
* `$package`: pakketnaam
* `$path`: pakketinstallatiepad
4 years ago
4 years ago
Pakketten kunnen deze hook gebruiken om aangepaste bronnen te wissen of anderzijds op te schonen.
4 years ago
4 years ago
> Let op: omwille van achterwaartse compatibiliteit worden uninstall-hooks ook aangeroepen door `uninstall.fish` in de hoofdmap van het pakket.
4 years ago
4 years ago
# Delen
4 years ago
4 years ago
Het officiële register met openbare pakketten wordt beheerd in de [oh-my-fish/packages-main](https://github.com/oh-my-fish/packages-main)-pakketbron. Neem de README van die pakketbron door om te zien hoe u uw pakket kunt toevoegen.
4 years ago
[fish-bind]: http://fishshell.com/docs/current/commands.html#bind
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls