fisher/docs/pt-PT

fisherman

fisherman é um gestor de plugins para fish.

Instalação

Via curl.

curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman

Uso

Instalar um plugin.

fisher sol 

Instalar através de múltiplas fontes.

fisher z fzf edc/bass omf/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 ~/plugin

Edite o ficheiro fishfile e execute fisher para aplicar as alterações

O que é o ficheiro fishfile e como é que eu o utilizo?

$EDITOR fishfile # adicionar plugins
fisher

Mostrar os plugins instalados actualmente.

fisher ls
@ plugin      # este plugin é uma pasta local
* sol         # este plugin é o Tema da consola
  bass
  fzf
  grc
  thefuck
  z

Mostrar os plugins disponíveis para instalação.

fisher ls-remote

Actualizar fihserman e todos os plugins.

fisher up

Actualizar plugins específicos.

fisher up bass z fzf thefuck

Remover plugins.

fisher rm thefuck

Remover todos os plugins instalados.

fisher ls | fisher rm

Mostrar ajuda.

fisher help z

FAQ

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

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

Como faço para desinstalar fisherman?

fisher self-uninstall

O fisherman é compatível com os plugins e temas do oh my fish?

Sim.

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.

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/sol 
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>.

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.

O que é um plugin?

Um plugin é:

1. 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 chamada functions.

2. um tema ou um prompt, i.e, fish_prompt.fish, fish_right_prompt.fish ou ambos.

3. um snippet, i.e, um ou mais ficheiros .fish dentro de uma pasta chamada conf.d que são executados sempre por fish no arranque da consola.

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/owner/repo
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32