mirror of
https://github.com/jorgebucaran/fisher
synced 2024-09-10 15:07:40 +02:00
Installing with npm works 9 out of 10 times. This may be due to the post-install hook hack set in order to move fisher.fish into the user functions directory. The simplest and best way to install fisherman is by putting the fisher.fish file in your functions directory.
231 lines
5.1 KiB
Markdown
231 lines
5.1 KiB
Markdown
[slack-link]: https://fisherman-wharf.herokuapp.com
|
|
[slack-badge]: https://fisherman-wharf.herokuapp.com/badge.svg
|
|
[travis-link]: https://travis-ci.org/fisherman/fisherman
|
|
[travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg
|
|
|
|
[organització]: https://github.com/fisherman
|
|
[fish shell]: https://github.com/fish-shell/fish-shell
|
|
[fisherman]: http://fisherman.sh
|
|
[en línia]: http://fisherman.sh/#search
|
|
|
|
[English]: ../../README.md
|
|
[Español]: docs/es-ES
|
|
[简体中文]: docs/zh-CN
|
|
[日本語]: docs/jp-JA
|
|
[한국어]: docs/ko-KR
|
|
[Русский]: docs/ru-RU
|
|
[Català]: docs/ca-ES
|
|
|
|
[![Build Status][travis-badge]][travis-link]
|
|
[![Slack][slack-badge]][slack-link]
|
|
|
|
# [fisherman] - gestor de complements per a fish
|
|
|
|
Llegeix aquest document en un altre llenguatge: [English], [Español], [日本語], [简体中文], [한국어], [Русский].
|
|
|
|
## Prestacions
|
|
|
|
* Sense configuració
|
|
|
|
* Sense dependencies externes
|
|
|
|
* No afecta als temps d'arrencada de la consola de comandes
|
|
|
|
* Fes-la anar interactivament o per mitjà del arxiu fishfile
|
|
|
|
* Instal·la i actualitza complements de manera concurrent
|
|
|
|
* Només l'essencial, instal·lar, actualitzar, esborrar, llistar i ajuda
|
|
|
|
## Instal·la
|
|
|
|
Amb curl.
|
|
|
|
```sh
|
|
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
|
|
```
|
|
|
|
Si encara estàs fent anar la versió 1.5 i vols actualitzar a >2.0 sense mes preocupació.
|
|
|
|
```
|
|
curl -L git.io/fisher-up-me | fish
|
|
```
|
|
|
|
## Mode d'ús
|
|
|
|
Instal·la un complement.
|
|
|
|
```
|
|
fisher simple
|
|
```
|
|
|
|
Instal·la des de múltiples fonts.
|
|
|
|
```
|
|
fisher z fzf omf/{grc,thefuck}
|
|
```
|
|
|
|
Instal·la des de una URL.
|
|
|
|
```
|
|
fisher https://github.com/edc/bass
|
|
```
|
|
|
|
Instal·la des de un gist.
|
|
|
|
```
|
|
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
|
|
```
|
|
|
|
Instal·la des de un directori local.
|
|
|
|
```sh
|
|
fisher ~/my_aliases
|
|
```
|
|
|
|
Edita el teu arxiu fishfile i executa `fisher` per a aplicar els canvis.
|
|
|
|
> [Que és un arxiu fishfile i com el faig anar?](#6-que-és-un-arxiu-fishfile-i-com-el-faig-anar)
|
|
|
|
```sh
|
|
$EDITOR fishfile # afegeix complements
|
|
fisher
|
|
```
|
|
|
|
Fes un cop d'ull al que tens instal·lat.
|
|
|
|
```ApacheConf
|
|
fisher ls
|
|
@ my_aliases # aquest complement esta dins un directori local
|
|
* simple # aquest complement es el tema actual
|
|
bass
|
|
fzf
|
|
grc
|
|
thefuck
|
|
z
|
|
```
|
|
|
|
Tria el que pots instal·lar.
|
|
|
|
```ApacheConf
|
|
fisher ls-remote
|
|
...
|
|
spin roach git_util pwd_info
|
|
submit flash pyenv host_info
|
|
...
|
|
```
|
|
|
|
Actualitza-ho tot.
|
|
|
|
```
|
|
fisher up
|
|
```
|
|
|
|
Actualitza alguns complements.
|
|
|
|
```
|
|
fisher up bass z fzf thefuck
|
|
```
|
|
|
|
Esborra alguns complements.
|
|
|
|
```
|
|
fisher rm simple
|
|
```
|
|
|
|
Esborra tots els complements.
|
|
|
|
```
|
|
fisher ls | fisher rm
|
|
```
|
|
|
|
Aconsegueix ajuda.
|
|
|
|
```
|
|
fisher help z
|
|
```
|
|
|
|
## FAQ
|
|
|
|
### 1. Quina es la versió necessaria de fish?
|
|
|
|
fisherman va ésser construït per a fish >= 2.3.0. Si estàs fent anar la versió 2.2.0,
|
|
afegeix el següent codi al teu arxiu `~/.config/fish/config.fish` per a donar suport a [retalls](#8-que-es-un-complement).
|
|
|
|
```fish
|
|
for file in ~/.config/fish/conf.d/*.fish
|
|
source $file
|
|
end
|
|
```
|
|
|
|
### 2. Com converteixo fish en la meva consola de comandes per defecte?
|
|
|
|
Afegeix fish a la llista de consoles de comandes dins de l'arxiu `/etc/shells` i converteix-la en la teva consola de comandes per defecte.
|
|
|
|
```sh
|
|
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
|
|
chsh -s /usr/local/bin/fish
|
|
```
|
|
|
|
### 3. Com des-instal·lo fisherman?
|
|
|
|
```fish
|
|
fisher self-uninstall
|
|
```
|
|
|
|
o
|
|
|
|
```
|
|
npm un -g fisherman
|
|
```
|
|
|
|
### 4. És fisherman compatible amb els temes i complements de oh my fish?
|
|
|
|
Si.
|
|
|
|
### 5. On deixa fisherman les seves coses?
|
|
|
|
fisherman es guarda al directori `~/.config/fish/functions/fisher.fish`.
|
|
|
|
La caché i configuracions són creades dins de `~/.cache/fisherman` i `~/.config/fisherman` respectivament.
|
|
|
|
El arxiu fishfile es guarda a `~/.config/fish/fishfile`.
|
|
|
|
### 6. Que és un arxiu fishfile i com el faig anar?
|
|
|
|
El arxiu fishfile `~/.config/fish/fishfile` llista tots els complements instal·lats.
|
|
|
|
Pots deixar que en fisherman s'encarregui d'aquest arxiu per tu automaticament, o be escriure a dins els complements que vols instal·lar i llavors executar `fisher` per a aplicar els canvis.
|
|
|
|
```
|
|
fisherman/simple
|
|
fisherman/z
|
|
omf/thefuck
|
|
omf/grc
|
|
```
|
|
|
|
Aquest procediment només instal·la complements i dependències. Per esborrar complements, fes anar `fisher rm` al seu lloc.
|
|
|
|
### 7. On puc trobar una llista de complements de fish?
|
|
|
|
Busca dins de l'[organització] o fes anar la busqueda [en línia] per descobrir contingut.
|
|
|
|
### 8. Que es un complement?
|
|
|
|
Un complement es:
|
|
|
|
1. un directori o repositori de git amb una funció dins d'un arxiu `.fish` ja be a l'arrel del projecte o dins d'un directori `functions`
|
|
|
|
2. un tema o prompt, p.e., un `fish_prompt.fish`, `fish_right_prompt.fish` o ambdós
|
|
|
|
3. un retall, p.e., un o mes arxius `.fish` dins un directori anomenat `conf.d` que es evaluat per fish a l'arrencada de la consola de comandes.
|
|
|
|
### 9. Com puc llistar complements com dependencies del meu complement?
|
|
|
|
Crea un nou arxiu `fishfile` a l'arrel del teu i escriu a dins les dependències del teu complement.
|
|
|
|
```fish
|
|
owner/repo
|
|
https://github.com/dude/sweet
|
|
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
|
|
```
|