Compare commits
No commits in common. 'master' and 'v7' have entirely different histories.
@ -1,56 +0,0 @@
|
||||
name: Build
|
||||
on:
|
||||
push:
|
||||
paths-ignore:
|
||||
- '**.md'
|
||||
pull_request:
|
||||
paths-ignore:
|
||||
- '**.md'
|
||||
jobs:
|
||||
build:
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
os:
|
||||
- ubuntu-18.04
|
||||
- ubuntu-20.04
|
||||
- ubuntu-latest
|
||||
fish:
|
||||
- stock
|
||||
- 2
|
||||
- 3
|
||||
- brew
|
||||
exclude:
|
||||
- os: ubuntu-20.04
|
||||
fish: 2
|
||||
- os: ubuntu-latest
|
||||
fish: 2
|
||||
include:
|
||||
- os: macos-latest
|
||||
fish: brew
|
||||
- os: macos-11
|
||||
fish: brew
|
||||
- os: macos-12
|
||||
fish: brew
|
||||
runs-on: ${{ matrix.os }}
|
||||
steps:
|
||||
- name: Checkout the repository
|
||||
uses: actions/checkout@v3
|
||||
|
||||
- name: Add brew to path for Ubuntu
|
||||
if: startsWith(matrix.os, 'ubuntu') && matrix.fish == 'brew'
|
||||
run: |
|
||||
echo "/home/linuxbrew/.linuxbrew/bin" >> $GITHUB_PATH
|
||||
echo "/home/linuxbrew/.linuxbrew/sbin" >> $GITHUB_PATH
|
||||
|
||||
- name: Install Fish
|
||||
run: FISH_RELEASE=${{ matrix.fish }} tools/ci-install-fish.sh
|
||||
|
||||
- name: Install Oh My Fish!
|
||||
run: fish bin/install --verbose --offline --noninteractive --yes
|
||||
|
||||
- name: Run tests
|
||||
run: |
|
||||
tests/run.fish
|
||||
pushd pkg/fish-spec; fish -c 'fish-spec'; popd
|
||||
pushd pkg/omf; fish -c 'fish-spec'; popd
|
||||
@ -0,0 +1,43 @@
|
||||
language: c
|
||||
dist: trusty
|
||||
|
||||
os:
|
||||
- linux
|
||||
- osx
|
||||
|
||||
addons:
|
||||
apt:
|
||||
packages:
|
||||
- bc
|
||||
- doxygen
|
||||
- expect
|
||||
- gettext
|
||||
- libncurses5-dev
|
||||
- tree
|
||||
|
||||
before_install:
|
||||
- tools/travis-install-git.sh
|
||||
- source tools/travis-github-pr-integration.sh
|
||||
- tools/travis-install-fish.sh
|
||||
|
||||
before_script:
|
||||
- tree -h
|
||||
- export
|
||||
- pushd bin; sha256sum -c install.sha256; popd
|
||||
- fish $TRAVIS_BUILD_DIR/bin/install --verbose --offline --noninteractive --yes
|
||||
|
||||
script:
|
||||
- tests/run.fish
|
||||
- pushd pkg/fish-spec; fish -c 'fish-spec'; popd
|
||||
- pushd pkg/omf; fish -c 'fish-spec'; popd
|
||||
|
||||
after_failure:
|
||||
- pwd
|
||||
- cd ~/.config/fish; tree -h; find . -type f | xargs cat
|
||||
|
||||
notifications:
|
||||
email:
|
||||
on_success: never
|
||||
on_failure: change
|
||||
slack:
|
||||
secure: fHR34H901zaBpUdm9BECQfocnPki8HdigH9CQxopvJ6Rm0WCLzCst4zPESAlO/Jb1t6OYtU6Goqmdq3yqzo8+moCrygrpMUtzIel/TDhkLzC2SIlmMdnw2/Xdwzisd/8QBVwu9ns8xJ2C4eegolNazNsc1Ow/wULaLwA7vUJrfcSmvYBepfe3MPSX/KLU3BBRhiTr3RhuzV+D1qQcSrAiWGVr4zWUiRAar6WD1D4athZO9OX33upBYpraGEa3sRWrUJjVv7KWMH566Y2MSAtd0NBgsF9dn3S5nKTXtfyGXt2gkykZ9Ag1B7B9AR9BHpn5UcvDdn7FZpEREfrllkDU8iG67RD7owyRl/T5jyWQecU2Q9Rlco5esEpbkY7sXmzwj2RVBGzsaVjxajZ+C7Ns2ogMcP8o+xqfcUASXjlJM2kJQRSenwx82Vq6uQ0vbhgKWBTQE1qsEkLDCthUxQ9eJ0/exoBp95wrZinilmEyps00oqmS40HEhB+JmuN2sGVWhpSczVDvVmdV+XSewLqfRnWtr2yhL8dR1sfVm2lJh3Dzik4BFUASByeBJnViU4dDilLlb4S3Dwk0XZh9HGwLs9ujNA3PT23uoRu4VRBQkIwXZE8v/qvf4/7w8IowofzezYcjwxkaqu1hNgTKNOkbgopV9RdwrUxy4f53S0l2jY=
|
||||
@ -1,23 +0,0 @@
|
||||
# Security Policy
|
||||
|
||||
<!-- ## Supported Versions
|
||||
|
||||
Use this section to tell people about which versions of your project are
|
||||
currently being supported with security updates.
|
||||
|
||||
| Version | Supported |
|
||||
| ------- | ------------------ |
|
||||
| 5.1.x | :white_check_mark: |
|
||||
| 5.0.x | :x: |
|
||||
| 4.0.x | :white_check_mark: |
|
||||
| < 4.0 | :x: | -->
|
||||
|
||||
## Reporting a Vulnerability
|
||||
|
||||
To report a vulnerability, please contact the current maintainer:
|
||||
|
||||
https://github.com/scorphus (keybase: https://keybase.io/pablito)
|
||||
|
||||
<!-- Tell them where to go, how often they can expect to get an update on a
|
||||
reported vulnerability, what to expect if the vulnerability is accepted or
|
||||
declined, etc. -->
|
||||
@ -1 +1 @@
|
||||
429a76e5b5e692c921aa03456a41258b614374426f959535167222a28b676201 install
|
||||
bb1f4025934600ea6feef2ec11660e17e2b6449c5a23c033860aed712ad328c9 install
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,92 +0,0 @@
|
||||
<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"/>
|
||||
|
||||
# Veelgestelde vragen
|
||||
|
||||
> Oh My Fish-documentatie • Ook beschikbaar in het
|
||||
> <a href="../en-US/FAQ.md">🇺🇸</a>
|
||||
> <a href="../es-ES/FAQ.md">🇪🇸</a>
|
||||
> <a href="../pt-BR/FAQ.md">🇧🇷</a>
|
||||
> <a href="../ru-RU/FAQ.md">🇷🇺</a>
|
||||
> <a href="../uk-UA/FAQ.md">🇺🇦</a>
|
||||
> <a href="../zh-CN/FAQ.md">🇨🇳</a>
|
||||
|
||||
<br>
|
||||
|
||||
Fijn dat u even de tijd neemt om de veelgestelde vragen door te nemen. Als uw vraag hierna nog niet beantwoord is, open dan een 'issue'.
|
||||
|
||||
|
||||
## Wat is Oh My Fish en waarom zou ik het willen gebruiken?
|
||||
|
||||
Oh My Fish (OMF) is een _framework_ voor de [Fish-shell](http://fishshell.com/). OMF helpt u de configuratie te beheren en thema's en pakketten te installeren.
|
||||
|
||||
|
||||
## Wat moet ik kennen om Oh My Fish te kunnen gebruiken?
|
||||
|
||||
_Niks_. Installeer Oh My Fish en gebruik Fish zoals gebruikelijk. Typ `omf help` als u iets nieuws wilt leren.
|
||||
|
||||
|
||||
## Wat zijn Oh My Fish-pakketten?
|
||||
|
||||
Oh My Fish-pakketten zijn thema's of plug-ins, geschreven in fish, die de kernfunctionaliteit uitbreiden, code uitvoeren tijdens het opstarten, automatische aanvullingen van veelgebruikte programma's toevoegen, etc.
|
||||
|
||||
|
||||
## Wat voor Oh My Fish-pakketten zijn er zoal beschikbaar?
|
||||
|
||||
Er zijn 3 soorten pakketgroepen:
|
||||
|
||||
1. Configuratiehulpmiddelen. Een voorbeeld hiervan is [`pkg-pyenv`](https://github.com/oh-my-fish/pkg-pyenv), dat controleert of `pyenv` aanwezig is op uw systeem en `(pyenv init - | psub)` uitvoert tijdens het opstarten.
|
||||
|
||||
2. Thema's. Bekijk de [themagalerij](https://github.com/oh-my-fish).
|
||||
|
||||
3. Traditionele shell-hulpmiddelen. Een voorbeeld hiervan is [`pkg-copy`](https://github.com/oh-my-fish/pkg-copy), een klembordbeheerder die op zowel Linux als macOS werkt.
|
||||
|
||||
|
||||
## Wat doet Oh My Fish precies?
|
||||
|
||||
+ Voert `$OMF_CONFIG/before.init.fish` uit (indien beschikbaar).
|
||||
|
||||
+ Laadt automatisch pakketten en thema's uit `$OMF_PATH/`.
|
||||
|
||||
+ Laadt automatisch uw configuratiepad. Standaard is dit `~/.config/omf`, maar dit is instelbaar middels `$OMF_CONFIG`.
|
||||
|
||||
+ Laadt automatisch de `functions`-map uit `$OMF_PATH` en `$OMF_CONFIG`
|
||||
|
||||
+ Voert `$OMF_CONFIG/init.fish` uit (indien beschikbaar).
|
||||
|
||||
|
||||
## Hoe kan ik een reeds aanwezige Oh My Fish-installatie bijwerken?
|
||||
|
||||
> :warning: Maak een back-up van uw verborgen bestanden en andere belangrijke gegevens.
|
||||
|
||||
```
|
||||
curl -L github.com/oh-my-fish/oh-my-fish/raw/master/bin/install | sh
|
||||
```
|
||||
|
||||
U kunt `$fish_path` nu veilig verwijderen.
|
||||
|
||||
```fish
|
||||
rm -rf "$fish_path"
|
||||
```
|
||||
|
||||
|
||||
## Hoe stel ik Fish in als mijn standaardshell?
|
||||
|
||||
Voeg Fish toe aan `/etc/shells`:
|
||||
|
||||
```sh
|
||||
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
|
||||
```
|
||||
|
||||
en schakel over:
|
||||
|
||||
```sh
|
||||
chsh -s /usr/local/bin/fish
|
||||
```
|
||||
|
||||
Indien gewenst kunt u altijd terug naar de vorige standaardshell:
|
||||
> Vervang, indien nodig, `/bin/bash` door `/bin/tcsh` of `/bin/zsh`.
|
||||
|
||||
```sh
|
||||
chsh -s /bin/bash
|
||||
```
|
||||
@ -1,130 +0,0 @@
|
||||
<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"/>
|
||||
|
||||
# Pakketten
|
||||
|
||||
> Oh My Fish-documentatie • 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>
|
||||
> <a href="../ru-RU/Packages.md">🇷🇺</a>
|
||||
> <a href="../uk-UA/Packages.md">🇺🇦</a>
|
||||
> <a href="../zh-CN/Packages.md">🇨🇳</a>
|
||||
|
||||
<br>
|
||||
|
||||
# Maken
|
||||
|
||||
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.
|
||||
|
||||
Oh My Fish kan een pakketstructuur voor u samenstellen. Gebruik hiervoor `omf new`:
|
||||
|
||||
```fish
|
||||
$ omf new plugin hello_world
|
||||
```
|
||||
|
||||
> Voer `omf new theme my_theme_name` uit om thema's te maken.
|
||||
|
||||
Er wordt overgeschakeld van de huidige map naar die van het pakket:
|
||||
|
||||
```
|
||||
$ ls -l
|
||||
README.md
|
||||
init.fish
|
||||
functions/hello_world.fish
|
||||
completions/hello_world.fish
|
||||
```
|
||||
|
||||
>Omschrijf altijd in `README.md` hoe uw pakket werkt.
|
||||
|
||||
|
||||
>Lees meer over [automatisch aanvullen](http://fishshell.com/docs/current/commands.html#complete) en gebruik het zorgvuldig.
|
||||
|
||||
`functions/hello_world.fish` omvat een enkele functie:
|
||||
|
||||
```fish
|
||||
function hello_world -d "Toont hallo wereld"
|
||||
echo "Hallo wereld!"
|
||||
end
|
||||
```
|
||||
|
||||
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.
|
||||
|
||||
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`).
|
||||
|
||||
# Hooks
|
||||
|
||||
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.
|
||||
|
||||
>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.
|
||||
|
||||
De werkmap in een hook is altijd ingesteld op de hoofdmap van het pakket. De momenteel door Oh My Fish ondersteunde hooks staan hieronder:
|
||||
|
||||
## `init`
|
||||
|
||||
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.
|
||||
|
||||
Binnen deze hook heeft u toegang tot drie gerelateerde variabelen:
|
||||
|
||||
* `$package`: pakketnaam
|
||||
* `$path`: pakketinstallatiepad
|
||||
* `$dependencies`: pakketafhankelijkheden
|
||||
|
||||
Voorbeeld: met een `init.fish`-script die de code
|
||||
|
||||
```fish
|
||||
echo "hello_world initialized"
|
||||
```
|
||||
|
||||
bevat, ziet u de regel `hello_world is geïnitialiseerd` bovenaan het terminalvenster als de shell net is gestart.
|
||||
|
||||
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.
|
||||
|
||||
## `key_bindings`
|
||||
|
||||
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.
|
||||
|
||||
>Thema's kunnen ook sneltoetsen bevatten! Oh My Fish herlaadt de sneltoetsen als u overschakelt naar een ander thema.
|
||||
|
||||
## `install`
|
||||
|
||||
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`.
|
||||
|
||||
Binnen deze hook heeft u toegang tot twee gerelateerde variabelen:
|
||||
|
||||
* `$package`: pakketnaam
|
||||
* `$path`: pakketinstallatiepad
|
||||
|
||||
Deze hook is handig voor het downloaden van aanvullende bronnen, instellen van Git-submodules of het installeren van externe afhankelijkheden, zoals Bash-scripts.
|
||||
|
||||
## `update`
|
||||
|
||||
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`.
|
||||
|
||||
Binnen deze hook heeft u toegang tot twee gerelateerde variabelen:
|
||||
|
||||
* `$package`: pakketnaam
|
||||
* `$path`: pakketinstallatiepad
|
||||
|
||||
Deze hook is handig voor het bijwerken van Git-submodules of controleren op nieuwe versies van externe afhankelijkheden.
|
||||
|
||||
## `uninstall`
|
||||
|
||||
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`.
|
||||
|
||||
Binnen deze hook heeft u toegang tot twee gerelateerde variabelen:
|
||||
|
||||
* `$package`: pakketnaam
|
||||
* `$path`: pakketinstallatiepad
|
||||
|
||||
Pakketten kunnen deze hook gebruiken om aangepaste bronnen te wissen of anderzijds op te schonen.
|
||||
|
||||
> Let op: omwille van achterwaartse compatibiliteit worden uninstall-hooks ook aangeroepen door `uninstall.fish` in de hoofdmap van het pakket.
|
||||
|
||||
# Delen
|
||||
|
||||
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.
|
||||
|
||||
|
||||
[fish-bind]: http://fishshell.com/docs/current/commands.html#bind
|
||||
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls
|
||||
@ -1,210 +0,0 @@
|
||||
<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"/>
|
||||
|
||||
> Het <a href="http://fishshell.com">Fish-shell</a> framework
|
||||
|
||||
[](/LICENSE) [](http://fishshell.com) [](https://travis-ci.org/oh-my-fish/oh-my-fish) [](https://oh-my-fish-slack.herokuapp.com)
|
||||
|
||||
|
||||
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.
|
||||
|
||||
> Ook beschikbaar in het
|
||||
> <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>
|
||||
|
||||
<br>
|
||||
|
||||
## Inhoudsopgave
|
||||
* [Installatie](#installatie)
|
||||
* [Aan de slag (uitleg omtrent opdrachten)](#aan-de-slag)
|
||||
* [Geavanceerd](#geavanceerd)
|
||||
* [Opstarten](#opstarten)
|
||||
* [Puntbestanden](#puntbestanden)
|
||||
* [Pakketten maken](#pakketten-maken)
|
||||
|
||||
## Installatie
|
||||
|
||||
U kunt direct aan de slag door deze opdracht uit te voeren in een terminalvenster:
|
||||
|
||||
```fish
|
||||
curl -L https://get.oh-my.fish | fish
|
||||
```
|
||||
|
||||
Hiermee downloadt u het installatiescript en voert u de standaardinstallatie uit. Indien gewenst kunt u het installatiescript downloaden en aanvullende opties opgeven:
|
||||
|
||||
```fish
|
||||
curl -L https://get.oh-my.fish > install
|
||||
fish install --path=~/.local/share/omf --config=~/.config/omf
|
||||
```
|
||||
|
||||
U kunt de integriteit van het installatiescript verifiëren met [deze controlesom](/bin/install.sha256):
|
||||
|
||||
```
|
||||
bb1f4025934600ea6feef2ec11660e17e2b6449c5a23c033860aed712ad328c9 install
|
||||
```
|
||||
|
||||
Ook kunt u Oh My Fish installeren middels Git of een offline-brontarball van de [uitgavenpagina][releases]:
|
||||
|
||||
```fish
|
||||
# middels git
|
||||
$ git clone https://github.com/oh-my-fish/oh-my-fish
|
||||
$ cd oh-my-fish
|
||||
$ bin/install --offline
|
||||
# middels een tarball
|
||||
$ curl -L https://get.oh-my.fish > install
|
||||
$ fish install --offline=omf.tar.gz
|
||||
```
|
||||
|
||||
Voer `install --help` uit om een volledige lijst met installatieopties te bekijken.
|
||||
|
||||
#### Vereisten
|
||||
|
||||
- **fish**-shell, versie 2.2 of hoger
|
||||
- **git**, versie 1.9.5 of hoger
|
||||
|
||||
#### Gemelde problemen
|
||||
|
||||
- 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))
|
||||
|
||||
|
||||
## Aan de slag
|
||||
|
||||
Oh My Fish bevat het hulpprogramma `omf` om pakketten en thema's op te halen en te installeren.
|
||||
|
||||
#### `omf update` _`[omf]`_ _`[<package>...]`_
|
||||
|
||||
Werk Oh My Fish, alle pakketbronnen en geïnstalleerde pakketten bij.
|
||||
|
||||
- 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.
|
||||
|
||||
#### `omf install` _`[<name>|<url>]`_
|
||||
|
||||
Installeer één _of meerdere_ pakketten.
|
||||
|
||||
- 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](#puntbestanden).
|
||||
|
||||
#### `omf repositories` _`[list|add|remove]`_
|
||||
|
||||
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.
|
||||
|
||||
#### `omf list`
|
||||
|
||||
Toon alle geïnstalleerde pakketten.
|
||||
|
||||
#### `omf theme` _`<theme>`_
|
||||
|
||||
Pas een thema toe. Bekijk alle beschikbare thema's met `omf theme`. U kunt ze ook [voorvertonen](/docs/Themes.md).
|
||||
|
||||
#### `omf remove` _`<name>`_
|
||||
|
||||
Verwijder een thema of pakket.
|
||||
|
||||
> Pakketten kunnen deïnstallatieopties bevatten zodat er aangepaste opschoning kan plaatsvinden. Lees voor meer informatie [Deïnstalleren](/docs/nl-NL/Packages.md#uninstall).
|
||||
|
||||
#### `omf reload`
|
||||
|
||||
Herlaad Oh My Fish en alle plug-ins door `exec` uit te voeren om alle huidige shellprocessen te vervangen door een nieuw proces.
|
||||
|
||||
> Deze opdracht probeert zo veilig mogelijk te werk te gaan en bijwerkingen van `exec` te voorkomen.
|
||||
|
||||
#### `omf new plugin | theme` _`<name>`_
|
||||
|
||||
Maak een nieuwe plug-in of nieuw thema.
|
||||
|
||||
> Hiermee maakt u een nieuwe map `$OMF_CONFIG/{pkg | themes}/` aan met een sjabloon.
|
||||
|
||||
#### `omf search` _`-t|--theme / -p|--package`_ _`<name>`_
|
||||
|
||||
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`.
|
||||
|
||||
#### `omf channel`
|
||||
|
||||
Toon of wijzig het updatekanaal.
|
||||
|
||||
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.
|
||||
|
||||
#### `omf doctor`
|
||||
|
||||
Voer dit uit om foutopsporingsinformatie vast te leggen voor [een 'issue'][omf-issues-new].
|
||||
|
||||
#### `omf destroy`
|
||||
|
||||
Deïnstalleer Oh My Fish.
|
||||
|
||||
## Geavanceerd
|
||||
|
||||
Het Oh My Fish-installatiescript voegt een knipsel toe aan de Fish-configuratiebestanden (`~/.config/fish/conf.d/`) dat OMF's opstartcode aanroept.
|
||||
|
||||
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.
|
||||
|
||||
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`.
|
||||
|
||||
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.
|
||||
|
||||
### Opstarten
|
||||
|
||||
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.
|
||||
|
||||
Lees voor meer informatie de [veelgestelde vragen](./FAQ.md#wat-doet-oh-my-fish-precies).
|
||||
|
||||
### Puntbestanden
|
||||
|
||||
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:
|
||||
|
||||
- __`theme`__ - het huidige thema
|
||||
- __`bundle`__ - de lijst met geïnstalleerde pakketten en thema's
|
||||
- __`channel`__ - het OMF-updatekanaal (stable of dev)
|
||||
|
||||
Verder kunt u deze speciale bestanden aanmaken of aanpassen:
|
||||
|
||||
- __`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`
|
||||
|
||||
#### Variabelen instellen in `init.fish`
|
||||
|
||||
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:
|
||||
|
||||
```fish
|
||||
# Voor Golang-ontwikkelaars
|
||||
set -xg GOPATH $HOME/gocode
|
||||
|
||||
# Voor Python-ontwikkelaars
|
||||
set -xg PYTHONDONTWRITEBYTECODE 1
|
||||
```
|
||||
|
||||
#### Over de bundel
|
||||
|
||||
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.
|
||||
|
||||
#### Oudere Fish-versies
|
||||
|
||||
Fish 2.2 bevat geen `conf.d`-map, dus dient de opstartcode toegevoegd te worden aan het Fish-configuratiebestand (`~/.config/fish/config.fish`).
|
||||
|
||||
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.
|
||||
|
||||
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`.
|
||||
|
||||
## Pakketten maken
|
||||
|
||||
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](Packages.md).
|
||||
|
||||
|
||||
[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
|
||||
@ -1,3 +1,3 @@
|
||||
function git_is_dirty -d "Check if there are changes to tracked files"
|
||||
git_is_worktree; and not command git diff --no-ext-diff --quiet --exit-code
|
||||
git_is_repo; and not command git diff --no-ext-diff --quiet --exit-code
|
||||
end
|
||||
|
||||
@ -1,7 +1,3 @@
|
||||
function git_is_repo -d "Check if directory is a repository"
|
||||
test -d .git
|
||||
or begin
|
||||
set -l info (command git rev-parse --git-dir --is-bare-repository 2>/dev/null)
|
||||
and test $info[2] = false
|
||||
end
|
||||
test -d .git; or command git rev-parse --git-dir >/dev/null 2> /dev/null
|
||||
end
|
||||
|
||||
@ -1,4 +0,0 @@
|
||||
function git_is_worktree -d "Check if directory is inside the worktree of a repository"
|
||||
git_is_repo
|
||||
and test (command git rev-parse --is-inside-git-dir) = false
|
||||
end
|
||||
@ -1,5 +1,5 @@
|
||||
function git_untracked -d "Print list of untracked files"
|
||||
git_is_worktree; and begin
|
||||
git_is_repo; and begin
|
||||
command git ls-files --other --exclude-standard
|
||||
end
|
||||
end
|
||||
|
||||
@ -1,5 +1,5 @@
|
||||
function omf.index.path -d 'Get the path to the local package index'
|
||||
set -q XDG_CACHE_HOME
|
||||
and echo (echo $XDG_CACHE_HOME | sed 's:/*$::')"/omf"
|
||||
or echo (echo $HOME | sed 's:/*$::')"/.cache/omf"
|
||||
and echo "$XDG_CACHE_HOME/omf"
|
||||
or echo "$HOME/.cache/omf"
|
||||
end
|
||||
|
||||
@ -1,3 +1,3 @@
|
||||
function omf.packages.name -a name_or_url
|
||||
command basename $name_or_url | sed -E 's/^(omf-)?((plugin|pkg|theme)-)?//;s/\\.git$//'
|
||||
command basename $name_or_url | sed -E 's/^(omf-)?((plugin|pkg|theme)-)?//;s/.git$//'
|
||||
end
|
||||
|
||||
@ -1,7 +1,3 @@
|
||||
function omf.repo.clone -a url branch path
|
||||
if test -z "$branch"
|
||||
command git clone --quiet $url $path
|
||||
else
|
||||
command git clone --quiet $url -b $branch $path
|
||||
end
|
||||
function omf.repo.clone -a url path
|
||||
command git clone --quiet $url $path
|
||||
end
|
||||
|
||||
@ -1,32 +0,0 @@
|
||||
function describe_omf_list_tests
|
||||
function before_all
|
||||
set -gx CI WORKAROUND
|
||||
end
|
||||
|
||||
function it_can_list_plugins
|
||||
set -l list_output (omf list -p)
|
||||
assert 0 = $status
|
||||
assert "$list_output" = "fish-spec omf"
|
||||
end
|
||||
|
||||
function it_can_list_themes
|
||||
set -l list_output (omf list -t)
|
||||
assert 0 = $status
|
||||
assert "$list_output" = "default"
|
||||
end
|
||||
|
||||
function it_can_list_insttalled_plugins
|
||||
set -l output (omf remove apt 2> /dev/null)
|
||||
set -l output (omf install apt 2> /dev/null)
|
||||
set -l list_output (omf list -p)
|
||||
assert 0 = $status
|
||||
assert "$list_output" = "apt fish-spec omf"
|
||||
set -l output (omf remove apt 2> /dev/null)
|
||||
end
|
||||
|
||||
function it_can_list_themes
|
||||
set -l list_output (omf list -t)
|
||||
assert 0 = $status
|
||||
assert "$list_output" = "default"
|
||||
end
|
||||
end
|
||||
@ -1,77 +0,0 @@
|
||||
function describe_omf_packages_tests
|
||||
function before_all
|
||||
set -gx CI WORKAROUND
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_name
|
||||
set -l output (omf.packages.name foo)
|
||||
assert 0 = $status
|
||||
assert "foo" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_of_a_plugin_package
|
||||
set -l output (omf.packages.name plugin-foo)
|
||||
assert 0 = $status
|
||||
assert "foo" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_of_a_theme_package
|
||||
set -l output (omf.packages.name theme-foo)
|
||||
assert 0 = $status
|
||||
assert "foo" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_name_ended_in_dot_git
|
||||
set -l output (omf.packages.name foo.git)
|
||||
assert 0 = $status
|
||||
assert "foo" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_name_with_dot
|
||||
set -l output (omf.packages.name foo.bar)
|
||||
assert 0 = $status
|
||||
assert "foo.bar" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_name_ended_in_git
|
||||
set -l output (omf.packages.name foobargit)
|
||||
assert 0 = $status
|
||||
assert "foobargit" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_url
|
||||
set -l output (omf.packages.name http://github.com/user/foo)
|
||||
assert 0 = $status
|
||||
assert "foo" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_url_of_a_plugin_package
|
||||
set -l output (omf.packages.name http://github.com/user/plugin-foo)
|
||||
assert 0 = $status
|
||||
assert "foo" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_url_of_a_theme_package
|
||||
set -l output (omf.packages.name http://github.com/user/theme-foo)
|
||||
assert 0 = $status
|
||||
assert "foo" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_url_ended_in_dot_git
|
||||
set -l output (omf.packages.name http://github.com/user/foo.git)
|
||||
assert 0 = $status
|
||||
assert "foo" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_url_with_dot
|
||||
set -l output (omf.packages.name http://github.com/user/foo.bar)
|
||||
assert 0 = $status
|
||||
assert "foo.bar" = "$output"
|
||||
end
|
||||
|
||||
function it_can_extract_name_from_url_ended_in_git
|
||||
set -l output (omf.packages.name http://github.com/user/foobargit)
|
||||
assert 0 = $status
|
||||
assert "foobargit" = "$output"
|
||||
end
|
||||
end
|
||||
@ -1,26 +0,0 @@
|
||||
#!/usr/bin/env bash
|
||||
|
||||
set -o pipefail
|
||||
set -o errexit
|
||||
set -o nounset
|
||||
|
||||
if [[ $FISH_RELEASE = "brew" ]]; then
|
||||
brew update
|
||||
brew install fish
|
||||
else
|
||||
if [[ $FISH_RELEASE == "2" ]]; then
|
||||
REPO_PPA="ppa:fish-shell/release-2"
|
||||
else
|
||||
REPO_PPA="ppa:fish-shell/release-3"
|
||||
fi
|
||||
|
||||
if [[ $FISH_RELEASE != "stock" ]]; then
|
||||
sudo apt-add-repository -y $REPO_PPA
|
||||
fi
|
||||
|
||||
sudo apt-cache policy fish
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y fish
|
||||
fi
|
||||
|
||||
fish --version
|
||||
@ -0,0 +1,17 @@
|
||||
# Return if we are not in a Pull Request
|
||||
if [[ "$TRAVIS_PULL_REQUEST" = "false" ]]; then
|
||||
export OMF_REPO_URI="https://github.com/$TRAVIS_REPO_SLUG"
|
||||
export OMF_REPO_BRANCH="$TRAVIS_BRANCH"
|
||||
return
|
||||
fi
|
||||
|
||||
GITHUB_PR_URL=https://api.github.com/repos/$TRAVIS_REPO_SLUG/pulls/$TRAVIS_PULL_REQUEST
|
||||
GITHUB_PR_BODY=$(curl -s $GITHUB_PR_URL 2> /dev/null)
|
||||
|
||||
if [[ $GITHUB_PR_BODY =~ \"ref\":\ *\"([a-zA-Z0-9_-]*)\" ]]; then
|
||||
export OMF_REPO_BRANCH=${BASH_REMATCH[1]}
|
||||
fi
|
||||
|
||||
if [[ $GITHUB_PR_BODY =~ \"repo\":.*\"clone_url\":\ *\"(https://github\.com/[a-zA-Z0-9_-]*/[a-zA-Z0-9_-]*\.git).*\"base\" ]]; then
|
||||
export OMF_REPO_URI=${BASH_REMATCH[1]}
|
||||
fi
|
||||
@ -0,0 +1,16 @@
|
||||
#!/usr/bin/env bash
|
||||
|
||||
set -o pipefail
|
||||
set -o errexit
|
||||
set -o nounset
|
||||
#set -o xtrace
|
||||
|
||||
# Return if we are not in a Pull Request
|
||||
if [[ "$TRAVIS_OS_NAME" = "linux" ]]; then
|
||||
sudo apt-add-repository -y ppa:fish-shell/release-2
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y fish
|
||||
else
|
||||
brew update
|
||||
brew install fish tree
|
||||
fi
|
||||
@ -0,0 +1,7 @@
|
||||
#!/usr/bin/env bash
|
||||
|
||||
if [[ "$TRAVIS_OS_NAME" = "linux" ]]; then
|
||||
sudo add-apt-repository -y ppa:git-core/ppa
|
||||
sudo apt-get update
|
||||
sudo apt-get install --only-upgrade -y git
|
||||
fi
|
||||
Loading…
Reference in New Issue