fisher/docs/ca-ES/README.md

218 lines
4.6 KiB
Markdown
Raw Normal View History

2016-04-25 20:28:36 +02:00
[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
2016-04-25 20:28:36 +02:00
[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
2016-04-25 20:28:36 +02:00
fisherman és un gestor de complements per a [fish-shell].
2016-04-25 20:28:36 +02:00
2016-04-29 08:15:02 +02:00
## Prestacions
2016-04-25 20:28:36 +02:00
* 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
```
2016-04-29 08:15:02 +02:00
Edita el teu arxiu fishfile i executa `fisher` per a aplicar els canvis.
2016-04-25 20:28:36 +02:00
> [Que és un arxiu fishfile i com el faig anar?](#6-que-és-un-arxiu-fishfile-i-com-el-faig-anar)
2016-04-25 20:28:36 +02:00
```sh
$EDITOR fishfile # afegeix complements
fisher
```
Fes un cop d'ull al que tens instal·lat.
2016-04-27 18:11:48 +02:00
```ApacheConf
2016-04-25 20:28:36 +02:00
fisher ls
@ my_aliases # aquest complement esta dins un directori local
* simple # aquest complement es el tema actual
bass
fzf
grc
thefuck
z
```
2016-04-29 08:15:02 +02:00
Tria el que pots instal·lar.
```
2016-04-29 08:15:02 +02:00
fisher ls-remote
```
2016-04-25 20:28:36 +02:00
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.
2016-04-25 20:28:36 +02:00
```
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?
2016-05-05 18:22:24 +02:00
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.
2016-04-25 20:28:36 +02:00
```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?
2016-05-05 18:22:24 +02:00
fisherman es guarda al directori *~/.config/fish/functions/fisher.fish*.
2016-04-25 20:28:36 +02:00
2016-05-05 18:22:24 +02:00
La caché i configuracions són creades dins de *~/.cache/fisherman* i *~/.config/fisherman* respectivament.
2016-04-25 20:28:36 +02:00
2016-05-05 18:22:24 +02:00
El arxiu fishfile es guarda a *~/.config/fish/fishfile*.
2016-04-25 20:28:36 +02:00
### 6. Que és un arxiu fishfile i com el faig anar?
2016-05-05 18:22:24 +02:00
El arxiu fishfile *~/.config/fish/fishfile* llista tots els complements instal·lats.
2016-04-25 20:28:36 +02:00
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:
2016-05-05 18:22:24 +02:00
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*
2016-04-25 20:28:36 +02:00
2016-05-05 18:22:24 +02:00
2. un tema o prompt, p.e., un *fish_prompt.fish*, *fish_right_prompt.fish* o ambdós
2016-04-25 20:28:36 +02:00
2016-05-05 18:22:24 +02:00
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.
2016-04-25 20:28:36 +02:00
### 9. Com puc llistar complements com dependencies del meu complement?
2016-05-05 18:22:24 +02:00
Crea un nou arxiu *fishfile* a l'arrel del teu i escriu a dins les dependències del teu complement.
2016-04-25 20:28:36 +02:00
```fish
owner/repo
2016-05-02 20:02:48 +02:00
https://github.com/owner/repo
2016-05-05 18:22:24 +02:00
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
2016-04-25 20:28:36 +02:00
```