416f4d7238
A lot has changed, in fact, fisherman as you knew it, is no longer with us. Let me explain. The new fisherman, is in fact a rewired clone of ``fin´´, a short-lived 2 week experiment that started because it was easier to rewrite everything than moving fisherman forward. Let me explain. I was longing for a lightweight, simpler fisherman with minimal maintanance cost. This fin lad is one of the most pragmatic pieces of code I've ever written, but attempting to maintain two drastically different plugin managers was not a sane decision. fin's goal was to get out of my way and let me be productive with fish and it did. Now fin is fisherman and fisherman is fin. The most notable change is that fisherman no longer depends on an index, so like fin, it's neutral and agnostic to what plugins you use. No index means fisherman completions are no longer as clever as to show you description of plugins, but you will still get enough information to know whether the plugin is a theme or not. I hope you always check the plugin's README / online docs before installing anything anyway. With the index gone, we had no use for ``search``, so this command is also gone. If you were using search often or depended on the removed features above, I am afraid they are gone *gone*, but trust me it's all for the very best. Now, with this out of the way, it's all unicorns and dartfish. Almost. To upgrade to fisherman 2.0.0 you need to REMOVE your current version of fisherman: 1. ```rm -rf "$fisher_home" "$fisher_config"``` 2. Open your config.fish and remove the fisherman initialization code. 3. ```exec fish < /dev/tty``` to reload the session. 4. Run `curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman` That's it. Probably. The new fisherman brings a lot more stability and maturity to the project and we need this change in order to move forward. I will be actively fixing any bugs that may have sneaked in during the ```fin->fisherman``` rewiring, but please do ping me: @bucaran on GitHub or directly to my email j@bucaran.me if you find anything out of place. Feel free and invited to go wild with issues in order to get this into shape ASAP. Cheers! |
||
---|---|---|
.. | ||
README.md |
fisherman - fish shell plugin manager
fisherman es un gestionador de paquetes para el fish shell de procesamiento en paralelo libre de configuración.
Lee este documento en otro idioma: English, 日本語, 简体中文.
Motivo
-
Simple
-
Sin configuración
-
Sin dependencias externas
-
No influye en el tiempo de inicio de la sesión
-
Se puede utilizar de manera interactiva o a la vundle
-
Solo lo fundamental, install, update, remove, list y help
Instalación
Copia fisher.fish
en ~/.config/fish/functions
y listo.
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
Uso
Instala paquetes.
fisher simple
Instala de múltiples fuentes.
fisher z fzf omf/{grc,thefuck}
Instala URLs.
fisher https://github.com/edc/bass
Instala gists.
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
Instala un directorio.
fisher ~/my_aliases
A la vundle. Edita el fishfile y entra fisher
para satisfacer los cambios.
$EDITOR fishfile # añade paquetes
fisher
Muestra que está instalado actualmente.
fisher ls
@ my_aliases # este paquete es un directorio
* simple # este paquete es el tema actual
bass
fzf
grc
thefuck
z
Actualiza todo.
fisher up
Actualiza algunos paquetes.
fisher up bass z fzf thefuck
Elimina paquetes.
fisher rm simple
Elimina todos los paquetes.
fisher ls | fisher rm
Muestra ayuda.
fisher help z
FAQ
1. ¿Qué versión de fish se requiere?
fisherman está diseñado para el último fish, pero se requiere 2.0.0 mínimo. Si no puedes actualizar fish, añade este código a ~/.config/fish/config.fish
para poder ejecutar snippets.
for file in ~/.config/fish/conf.d/*.fish
source $file
end
2. ¿Cómo puedo instalar fish en OS X?
Via Homebrew.
brew install fish
3. ¿Cómo puedo instalar el útlimo fish en algunos Linux?
Via git, compilando el código.
sudo apt-get -y install git gettext automake autoconf \
ncurses-dev build-essential libncurses5-dev
git clone -q --depth 1 https://github.com/fish-shell/fish-shell
cd fish-shell
autoreconf && ./configure
make && sudo make install
4. ¿Cómo hago fish mi shell por defecto?
Añade fish a la lista de login shells in /etc/shells
.
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
5. ¿Cómo puedo desinstalar fisherman?
Entra
fisher self-uninstall
6. ¿Es fisherman compatible con paquetes y temas de oh my fish?
Sí.
7. ¿Por qué fisherman? ¿Por qué no ____?
fisherman tiene / es:
-
Diminuto y cabe en un solo archivo
-
No influye en el tiempo de inicio de la sesión
-
Rápido y fácil de instalar, actualizar y desinstalar
-
No requiere modificar tu configuración de fish
-
Usa el sistema XDG de directions base correctamente
8. ¿Dónde guarda fisherman las cosas?
fisherman mismo va en ~/.config/fish/functions/fisher.fish
.
El caché y la configuración en ~/.cache/fisherman
y ~/.config/fisherman
respectivamente.
El fishfile en ~/.config/fish/fishfile
.
9. ¿Qué es el fishfile y cómo lo uso?
El fishfile ~/.config/fish/fishfile
registra todos los paquetes que están instalados.
Puedes dejar que fisherman se encargue de este archivo automáticamente, o ingresar los paquetes que requieres y entrar fisher
para satisfacer los cambios.
fisherman/simple
fisherman/z
omf/thefuck
omf/grc
Este mecanismo solo instala paquetes y dependecias necesarias. Para remover paquetes, usa fisher rm
.
10. ¿Dónde consigo las lista de paquetes para fish?
Diríjete a la organización o usa la búsqueda en línea para descrubir contenido.
11. ¿Cómo puedo migrar desde ____?
fisherman no interfiere con otros sistemas conocidos. Si quieres desinstalar oh my fish, diríjete a su documentación
13. ¿Qué es un paquete?
Un paquete es:
-
un directorio o repositorio de git con una función / archivo
.fish
bien sea en el nivel raíz del proyecto o en un directorio llamadofunctions
. -
un tema o prompt, es decir,
fish_prompt.fish
,fish_right_prompt.fish
o ambos. -
un snippet, es decir, uno o más archivos
.fish
en un directorio llamadoconf.d
que son ejecutados por fish al inicio de la sesión.
14. ¿Cómo puedo añadir dependencias a mi plugin?
Crea un fishfile
en el nivel raíz de tu proyecto y escribe los paquetes.
owner/repo
https://github.com/dude/sweet
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
15. ¿Qué puedes decir de fundle?
fundle fue la inspiración para utilizar el fishfile, pero todavía es limitado en sus capacidades y hace requisito modificar la configuración de fish.
16. Tengo una pregunta que no aparece aquí. ¿Dónde pregunto?
Crea un nuevo ticket en el issue tracker: