mirror of
https://github.com/jorgebucaran/fisher
synced 2024-08-17 12:31:05 +02:00
215 lines
4.3 KiB
Markdown
215 lines
4.3 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
|
|
|
|
[organización]: https://github.com/fisherman
|
|
[fish]: https://github.com/fish-shell/fish-shell
|
|
[fisherman]: http://fisherman.sh
|
|
[en línea]: http://fisherman.sh/#search
|
|
|
|
[![Build Status][travis-badge]][travis-link]
|
|
[![Slack][slack-badge]][slack-link]
|
|
|
|
# [fisherman]
|
|
|
|
fisherman es un gestor de paquetes para [fish].
|
|
|
|
## Prestaciones
|
|
|
|
* Sin configuración
|
|
|
|
* Sin dependencias externas
|
|
|
|
* No afecta al tiempo de inicio de la sesión
|
|
|
|
* Se puede utilizar de manera interactiva o con un archivo fishfile
|
|
|
|
* Instala i actualiza paquetes de manera concurrente
|
|
|
|
* Solo lo fundamental, install, update, remove, list y help
|
|
|
|
## Instalación
|
|
|
|
Via curl.
|
|
|
|
```sh
|
|
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
|
|
```
|
|
|
|
## Modo de uso
|
|
|
|
Instalar paquetes.
|
|
|
|
```
|
|
fisher sol
|
|
```
|
|
|
|
Instalar desde múltiples fuentes.
|
|
|
|
```
|
|
fisher z fzf edc/bass omf/thefuck
|
|
```
|
|
|
|
Instalar desde URLs.
|
|
|
|
```
|
|
fisher https://github.com/edc/bass
|
|
```
|
|
|
|
Instalar desde gists.
|
|
|
|
```
|
|
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
|
|
```
|
|
|
|
Instalar desde un directorio.
|
|
|
|
```sh
|
|
fisher ~/plugin
|
|
```
|
|
|
|
Edita el archivo fishfile y ejecuta `fisher` para aplicar los cambios.
|
|
|
|
> [¿Qué es el archivo fishfile y cómo lo utilizo?](#6-qué-es-el-fishfile-y-cómo-lo-uso)
|
|
|
|
```sh
|
|
$EDITOR fishfile # añade los paquetes como dependencias
|
|
fisher
|
|
```
|
|
|
|
Muestra que tienes instalado actualmente.
|
|
|
|
```ApacheConf
|
|
fisher ls
|
|
@ plugin # este paquete esta en un directorio
|
|
* sol # este paquete es el tema actual
|
|
bass
|
|
fzf
|
|
grc
|
|
thefuck
|
|
z
|
|
```
|
|
|
|
Muestra que puedes instalar.
|
|
|
|
```
|
|
fisher ls-remote
|
|
```
|
|
|
|
Actualiza todo.
|
|
|
|
```
|
|
fisher up
|
|
```
|
|
|
|
Actualiza algunos paquetes.
|
|
|
|
```
|
|
fisher up bass z fzf thefuck
|
|
```
|
|
|
|
Elimina paquetes.
|
|
|
|
```
|
|
fisher rm thefuck
|
|
```
|
|
|
|
Elimina todos los paquetes.
|
|
|
|
```
|
|
fisher ls | fisher rm
|
|
```
|
|
|
|
Muestra ayuda.
|
|
|
|
```
|
|
fisher help z
|
|
```
|
|
|
|
## FAQ
|
|
|
|
### ¿Qué versión de fish es necesaria?
|
|
|
|
fisherman fue diseñado para fish >= 2.3.0. Si tienes la versión 2.2.0 y no puedes actualizarla por algún motivo, añade este código en el archivo `~/.config/fish/config.fish` para poder ejecutar [snippets](#8-qué-es-un-paquete).
|
|
|
|
```fish
|
|
for file in ~/.config/fish/conf.d/*.fish
|
|
source $file
|
|
end
|
|
```
|
|
|
|
### ¿Cómo hago fish mi consola de comandos por defecto?
|
|
|
|
Añade fish a la lista de consolas de comandos en */etc/shells*.
|
|
|
|
```sh
|
|
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
|
|
chsh -s /usr/local/bin/fish
|
|
```
|
|
|
|
### ¿Cómo puedo desinstalar fisherman?
|
|
|
|
Ejecuta
|
|
|
|
```fish
|
|
fisher self-uninstall
|
|
```
|
|
|
|
o
|
|
|
|
```fish
|
|
npm un -g fisherman
|
|
```
|
|
|
|
### ¿Es fisherman compatible con paquetes y temas de oh my fish?
|
|
|
|
Sí.
|
|
|
|
### ¿Dónde guarda fisherman sus cosas?
|
|
|
|
fisherman mismo esta en el archivo *~/.config/fish/functions/fisher.fish*.
|
|
|
|
El caché y la configuración en *~/.cache/fisherman* y *~/.config/fisherman* respectivamente.
|
|
|
|
El archivo fishfile en *~/.config/fish/fishfile*.
|
|
|
|
### ¿Qué es el archivo fishfile y cómo lo uso?
|
|
|
|
El archivo fishfile *~/.config/fish/fishfile* contiene todos los paquetes que están instalados.
|
|
|
|
Puedes dejar que fisherman se encargue de este archivo automáticamente, o incluir los paquetes que necesitas y ejecutar `fisher` para aplicar los cambios.
|
|
|
|
```
|
|
fisherman/sol
|
|
fisherman/z
|
|
omf/thefuck
|
|
omf/grc
|
|
```
|
|
|
|
Este comando solo instala paquetes y sus dependencias. Para borrar paquetes, usa `fisher rm`.
|
|
|
|
### ¿Dónde consigo un listado de paquetes para fish?
|
|
|
|
Dirígete a la [organización] o usa la búsqueda [en línea] para descubrir contenido.
|
|
|
|
### ¿Qué es un paquete?
|
|
|
|
Un paquete es:
|
|
|
|
1. un directorio o repositorio de git con una función / archivo *.fish* bien sea en el directorio raíz del proyecto o en un directorio llamado *functions*.
|
|
|
|
2. un tema o prompt, es decir, *fish_prompt.fish*, *fish_right_prompt.fish* o ambos.
|
|
|
|
3. un snippet, es decir, uno o más archivos *.fish* en un directorio llamado *conf.d* que son ejecutados por fish al iniciar la sesión.
|
|
|
|
### ¿Cómo puedo añadir dependencias a mi plugin?
|
|
|
|
Crea un archivo *fishfile* en la carpeta raíz de tu plugin y incluye los paquetes en el.
|
|
|
|
```fish
|
|
owner/repo
|
|
https://github.com/owner/repo
|
|
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
|
|
```
|