README-pt.md

Instalando Fish no Windows (WSL) - Passo a passo completo para Iniciantes (ou não)

{ English Version }

Ao terminar este Tutorial, você sairá disso:

Para isso:

Sobre

Fish é um interpretador de comandos; um dos diversos tradutores entre Usuário e o Sistema Operacional conhecidos como shell, tais como: cmd, PowerShell, bash, zsh, etc..

Umas das melhores vantagens do Fish são as funcionalidades AutoComplete e AutoSuggestion virem instaladas de fábrica, prontas para uso sem a necessidade de instalar ou configurar nada.

Clique aqui para saber mais sbore o Fish Shell

Como Fish é um shell para Unix, ou seja, não funciona no Windows padrão, então será necessário instalar o Windows Subsystem for Linux (WSL)

IMPORTANTE

Antes de seguir com o passo a passo, crie um Ponto de Restauração do Sistema (C:/) - faça isso SEMPRE que for instalar ou alterar configurações do Windows.

Instalação

Documentações da Microsoft

• Instalar WSL
• Instalar WSL (manualmente)

1) Instalando WSL (Windows Subsystem for Linux)

Abra o Pronpt de Comando (cmd) como Administrador e execute o comando abaixo.

Obs: Se wsl --install retornar o HELP Menu, isso significa que você já tem o wsl instalado - vá para o próximo passo

wsl --install

Obs: Caso Ctrl + v não funcione no terminal, aperte o botão direito do mouse para colar.

wsl --install executará as seguintes ações:

• Habilitar os componentes WSL e Virtual Machine Platform
• Baixar e instalar o Linux Kernel mais recente
• Baixar e instalar a distribuição Ubuntu do Linux

Após a instalação ser finalizada, Reinicie seu Computador

Obs: Se a instalação automática der problema, instale manualmente

2) Configurando o Ubuntu

Agora com o WSL instalado, clique no Menu Iniciar e abra o "app" Ubuntu

Obs: Se o app não aparecer, clique aqui e pesquise por Ubuntu, selecione a versão instalada e depois clique em Iniciar

Aguarde finalizar a instalação e cadastre um username e senha

3) Instalando o Fish

Documentações do Fish

• Site Oficial
• GitHub Oficial
• Instalando

Abra o cmd e execute bash ou wsl para acessar seu ambiente Linux (Ubuntu)

Instalando o repositório do Fish

sudo apt-add-repository ppa:fish-shell/release-3

Obs: Se apt-add-repository for um "comando não encontrado", execute apt-get install software-properties-common

Checando e Instalando atualizações

sudo apt-get update && sudo apt-get upgrade

Instalando o Fish

sudo apt-get install fish

Definindo Fish como Shell padrão

É isso ai, parabéns, você instalou o Fish Shell no seu Windows.

Agora basta executar fish no Terminal Ubuntu (bash ou wsl) para acessar seu novo Shell

Configurando o Visual do terminal

Agora vamos deixar seu terminal com um visual mais agradável.

1) Instalando o Windows Terminal

Não usaremos mais o antigo terminal padrão. Clique aqui e instale o Windows Terminal

• Para fazer algumas modificações no Fish, é necessário instalar o plugin manager Oh My Fish

2) Instalando Oh My Fish (omf)

Documentação do Oh My Fish

• GitHub Oficial

Abra o Windows Terminal e execute fish para acessar o Fish Shell.

Para continuar precisamos do Git

 sudo apt-get install git

Instalando omf

curl https://raw.githubusercontent.com/oh-my-fish/oh-my-fish/master/bin/install | fish

3) Instalando o Tema

Você pode visualizar e escolher outro tema clicando aqui

Porém, neste passo a passo iremos instalar e configurar o tema bobthefish

omf install bobthefish

4) Configurando o Tema bobthefish

Use o comando abaixo para entrar na pasta fish e abri-la no Windows

cd ~/.config/fish/ && explorer.exe .

Agora abra o arquivo config.fish, cole os códigos abaixo e depois Salve a alteração

if status is-interactive
	# Commands to run in interactive sessions can go here
	set -g theme_display_git_default_branch yes
	set -g theme_title_display_process yes
	set -g theme_title_display_path no
	set -g theme_title_use_abbreviated_path no
	set -g theme_date_format "+%d/%m/%y %H:%M"
	set -g theme_display_user yes
	set -g theme_display_hostname yes
	set -g fish_prompt_pwd_dir_length 6
	set -g theme_display_jobs_verbose yes
end

Clique aqui para saber o que cada comando acima faz

Esse será o resultado

5) Instalando a Nerd Font

Documentação da Nerd Fonts

• GitHub Oficial

Para trocar os "erros" [] por Simbolos, precisamos instalar uma fonte do Nerd Fonts. Iremos instalar a SourceCode Pro (SauceCodePro NF). Para ver mais Fontes clique aqui

Baixe a (última versão do Source Code)[https://github.com/ryanoasis/nerd-fonts/releases/latest], indo em Assests e buscando por SourceCodePro.zip.

Vá na sua pasta de Download do Windows, dezipe o arquivo e execute todos os arquivos .ttf para instalar a fonte.

6) Configurando o Windows Terminal

Agora podemos alterar a fonte do terminal para arrumar os []

Clique na setinha > Configurações

Clique em Abrir o arquivo JSON no canto inferior esquerdo da tela

• Dentro de "profiles">"default" faça as alterações abaixo e Salve o arquivo:
  • Alterar o name do "Ubuntu" que você instalou para Fish (ou qualquer outro)
  • Adicionar o tema (colorScheme) "Campbell"
  • Adicionar o guid do Fish para ser o Perfil padrão do Windows Terminal
  • Adicionar "SauceCodePro Nerd Font" em font:face

   "profiles": 
   {
       "defaults": 
       {
           "font": 
           {
               "face": "SauceCodePro Nerd Font"
           }
       },
   }

Caso queira seu Terminal translúcido, adicione os valores abaixo dentro de "defaults"

Obs: Efeitos de transparência precisa estar Ativado para funcionar Menu Iniciar > Configurações > Personalização > Cores

//"defaults": {
	"opacity": 50,
	"useAcrylic": true,
	"acrylicOpacity": 0.5,
//}

Definindo o Fish como Shell padrão do Windows Terminal

chsh -s /usr/bin/fish

7) Configurando os Simbolos (Fonte)

Você pode escolher entre dois estilos de símbolos: PowerLine Fonts ou Nerd Fonts

set -g theme_powerline_fonts yes

ou

set -g theme_nerd_fonts yes

Obs: Use yes para ativar e no para desativar (deixar apenas uma como YES)

FIM