mirror of
https://github.com/jorgebucaran/fisher
synced 2024-11-05 12:00:17 +00:00
218 lines
4.6 KiB
Markdown
218 lines
4.6 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
|
|
|
|
[![Build Status][travis-badge]][travis-link]
|
|
[![Slack][slack-badge]][slack-link]
|
|
|
|
# [fisherman] - fish plugin manager
|
|
|
|
fisherman és un gestor de complements per a [fish-shell].
|
|
|
|
## Prestacions
|
|
|
|
* Sense configuració
|
|
|
|
* Sense dependencies externes
|
|
|
|
* No afecta als temps d'arrencada de la consola de comandes
|
|
|
|
* 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.
|
|
|
|
```
|
|
fisher ls-remote
|
|
```
|
|
|
|
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/owner/repo
|
|
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
|
|
```
|