5 KiB
fisherman - fish plugin manager
fisherman é um gestor de plugins para fish-shell.
Traduções: English, Español, 日本語, 简体中文, 한국어, Русский, Català.
Funcionalidades
-
Não necessita de configuração
-
Sem dependências externas
-
Não tem impacto no arranque da consola
-
É possível usar de maneira interactiva ou usando o ficheiro fishfile
-
Instala e actualiza plugins concurrentemente
-
Apenas o essencial, install, update, remove, list e help
Instalação
Via curl.
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
Uso
Instalar um plugin.
fisher simple
Instalar através de múltiplas fontes.
fisher z fzf omf/{grc,thefuck}
Instalar através de URLs.
fisher https://github.com/edc/bass
Instalar através de gists.
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
Instalar através de uma pasta local.
fisher ~/my_aliases
Edite o ficheiro fishfile e execute fisher
para aplicar as alterações
$EDITOR fishfile # adicionar plugins
fisher
Mostrar os plugins instalados actualmente.
fisher ls
@ my_aliases # este plugin é uma pasta local
* simple # este plugin é o Tema da consola
bass
fzf
grc
thefuck
z
Mostrar os plugins disponíveis para instalação.
fisher ls-remote
...
spin roach git_util pwd_info
submit flash pyenv host_info
...
Actualizar fihserman e todos os plugins.
fisher up
Actualizar plugins específicos.
fisher up bass z fzf thefuck
Remover plugins.
fisher rm simple
Remover todos os plugins instalados.
fisher ls | fisher rm
Mostrar ajuda.
fisher help z
FAQ
1. Qual é a versão da fish necessária?
fisherman foi desenhado para fish >= 2.3.0. Se está a usar a versão 2.2.0, é necessário adicionar o seguinte código no seu ficheiro ~/.config/fish/config.fish
de formar a suportar snippets.
for file in ~/.config/fish/conf.d/*.fish
source $file
end
2. Como faço para tornar fish a minha consola predefinida?
Adicione fish à lista de consolas no ficheiro /etc/shells
e defina-a como a sua consola por omissão usando os seguintes comandos.
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
3. Como faço para desinstalar fisherman?
fisher self-uninstall
4. O fisherman é compatível com os plugins e temas do oh my fish?
Sim.
5. Onde é que o fisherman guarda as suas coisas?
O fisherman é guardado no ficheiro ~/.config/fish/functions/fisher.fish
.
A cache e a configuração é guardada nos ficheiros ~/.cache/fisherman
e ~/.config/fisherman
respectivamente.
O ficheiro fishfile é guardado em ~/.config/fish/fishfile
.
6. O que é o ficheiro fishfile e como é que eu o utilizo?
O ficheiro fishfile ~/.config/fish/fishfile
contém todos os plugins instalados.
Pode deixar que fisherman tome conta deste ficheiro automaticamente, ou se quiser, pode adicionar os plugins manualmente ao ficheiro e no fim executar fisher
para aplicar as alterações.
fisherman/simple
fisherman/z
omf/thefuck
omf/grc
Este comando apenas instalas plugins e suas dependências. Para desinstalar um plugin, tem que executar fisher rm <nome-do-plugin>
.
7. Onde consigo ver os plugins disponíveis para instalação?
Visite a organização ou use a pesquisa online para descobrir os plugins disponíveis.
8. O que é um plugin?
Um plugin é:
-
uma pasta local ou repositório git com uma função dentro de um ficheiro
.fish
na raiz da pasta ou repositório ou dentro de uma pasta chamadafunctions
. -
um tema ou um prompt, i.e,
fish_prompt.fish
,fish_right_prompt.fish
ou ambos. -
um snippet, i.e, um ou mais ficheiros
.fish
dentro de uma pasta chamadaconf.d
que são executados sempre por fish no arranque da consola.
9. Como posso definir plugins como dependências do meu plugin?
Crie um ficheiro fishfile
na raiz do seu projecto e adicione ao ficheiros as dependências.
owner/repo
https://github.com/dude/sweet
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32