Oh My Zsh é um framework de código aberto, orientado à comunidade, para gerir a sua configuração zsh.

Sons enfadonhos. Vamos tentar novamente.

Oh My Zsh não fará de você um desenvolvedor 10x…mas você pode se sentir como um.

Once instalado, seu terminal shell se tornará a conversa da cidade ou seu dinheiro de volta! Com cada pressionamento de tecla no seu prompt de comando, você irá aproveitar as centenas de plugins poderosos e temas bonitos. Estranhos virão até você nos cafés e perguntarão: “isso é incrível! você é algum tipo de gênio?”

Finalmente, você começará a receber o tipo de atenção que você sempre sentiu que merecia. …ou talvez você use o tempo que você está economizando para começar a usar o fio dental mais vezes. 😬

Para saber mais, visite ohmyz.sh, siga @ohmyzsh no Twitter, e junte-se a nós no Discord.

Começando

Pré-requisitos

• Um sistema operacional do tipo Unix: macOS, Linux, BSD. No Windows: WSL2 é preferido, mas cygwin ou msys também funcionam na maioria.
• Zsh deve ser instalado (v4.3.9 ou mais recente é bom, mas preferimos 5.0.8 e mais recente). Se não estiver pré-instalado (execute zsh --version para confirmar), verifique as seguintes instruções do wiki aqui: Instalando ZSH
• curl ou wget deve ser instalado
• git deve ser instalado (recomendado v2.4.11 ou superior)

Instalação básica

Oh My Zsh é instalado executando um dos seguintes comandos em seu terminal. Você pode instalá-lo através da linha de comando com curl, wget ou outra ferramenta similar.

Inspeção manual

É uma boa idéia inspecionar o script de instalação de projetos que você ainda não conhece. Você pode fazer o download do script de instalação primeiro, olhando através dele para que tudo pareça normal, depois executando-o:

wget https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.shsh install.sh

Usando Oh My Zsh

Plugins

Oh My Zsh vem com um monte de plugins para você tirar proveito. Você pode dar uma olhada no diretório de plugins e/ou no wiki para ver o que está atualmente disponível.

Enabling Plugins

Após localizar um plugin (ou vários) que você gostaria de usar com o Oh My Zsh, você precisará habilitá-los no arquivo .zshrc. Você encontrará o arquivo zshrc no seu diretório $HOME. Abra-o com seu editor de texto favorito e você verá um local para listar todos os plugins que você quer carregar.

vi ~/.zshrc

Por exemplo, isto pode começar a se parecer com isto:

plugins=( git bundler dotenv osx rake rbenv ruby)

Note que os plugins estão separados por espaços em branco (espaços, abas, novas linhas…). Não use vírgulas entre eles ou ele irá quebrar.

Usando Plugins

Cada plugin inclui um README, documentando-o. Este README deve mostrar os pseudônimos (se o plugin adicionar algum) e os extras que estão incluídos nesse plugin em particular.

Temas

Nós o admitiremos. No início do mundo Oh My Zsh, talvez tenhamos ficado um pouco felizes com o tema. Temos agora mais de cento e cinquenta temas empacotados. A maioria deles tem screenshots no wiki (Estamos trabalhando para atualizar isso!). Confira-os!

Selecionando um Tema

O tema do Robby é o tema padrão. Não é o mais extravagante. Não é o mais simples. É apenas o certo (para ele).

Após encontrar um tema que gostaria de utilizar, terá de editar o ficheiro ~/.zshrc. Você verá uma variável de ambiente (todas as letras maiúsculas) que se parece com:

ZSH_THEME="robbyrussell"

Para usar um tema diferente, basta alterar o valor para combinar com o nome do tema desejado. Por exemplo:

ZSH_THEME="agnoster" # (this is one of the fancy ones)# see https://github.com/ohmyzsh/ohmyzsh/wiki/Themes#agnoster

Nota: muitos temas requerem a instalação das fontes Powerline para renderizar corretamente.

Abra uma nova janela de terminal e seu prompt deve se parecer com isto:

Caso você não tenha encontrado um tema adequado para suas necessidades, por favor dê uma olhada no wiki para mais deles.

Se você está se sentindo animado, você pode deixar o computador selecionar um aleatoriamente para você cada vez que você abrir uma nova janela de terminal.

ZSH_THEME="random" # (...please let it be pie... please be some pie..)

E se você quiser escolher um tema aleatório de uma lista de seus temas favoritos:

ZSH_THEME_RANDOM_CANDIDATES=( "robbyrussell" "agnoster")

Se você só sabe quais temas você não gosta, você pode adicioná-los de forma similar a uma lista ignorada:

ZSH_THEME_RANDOM_IGNORED=(pygmalion tjkirch_mod)

FAQ

Se você tiver mais algumas perguntas ou problemas, você pode encontrar uma solução em nosso FAQ.

Tópicos Avançados

Se você é do tipo que gosta de sujar as mãos, estas seções podem ressoar.

Instalação Avançada

Alguns usuários podem querer instalar manualmente o Oh My Zsh, ou alterar o caminho padrão ou outras configurações que o instalador aceita (estas configurações também estão documentadas no topo do script de instalação).

Diretório Personalizado

O local padrão é ~/.oh-my-zsh (oculto em seu diretório home, você pode acessá-lo com cd ~/.oh-my-zsh)

Se você quiser alterar o diretório de instalação com a variável de ambiente ZSH, execute export ZSH=/your/path antes de instalar, ou configure-o antes do final do pipelineli de instalação como este:

ZSH="$HOME/.dotfiles/oh-my-zsh" sh install.sh

Instalação desacompanhada

Se você estiver executando o script de instalação Oh My Zsh como parte de uma instalação automatizada, você pode passar a bandeira --unattended para o script install.sh. Isto terá o efeito de não tentar alterar a shell padrão, e também não executará zsh quando a instalação tiver terminado.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended

Instalando a partir de um repositório bifurcado

O script de instalação também aceita estas variáveis para permitir a instalação de um repositório diferente:

• REPO (padrão: ohmyzsh/ohmyzsh): isto toma a forma de owner/repository. Se você definir esta variável, o instalador irá procurar por um repositório em

• REMOTE (padrão: ): esta é a URL completa do repositório gitclone. Você pode usar esta configuração se você quiser instalar de um garfo que não está no GitHub (GitLab,Bitbucket…) ou se você quiser clonar com SSH ao invés de HTTPS ([email protected]:user/project.git).

  NOTE: é incompatível com a configuração da variável REPO. Esta configuração terá precedência.

• BRANCH (padrão: master): você pode usar esta configuração se você quiser alterar o ramo padrão para ser verificado ao clonar o repositório. Isto pode ser útil para testar um Pull Request, ou se você quiser usar um ramo diferente de master.

Por exemplo:

REPO=apjanke/oh-my-zsh BRANCH=edge sh install.sh

Instalação Manual

1. Clone o repositório

git clone https://github.com/ohmyzsh/ohmyzsh.git ~/.oh-my-zsh

2. Opcionalmente, faça backup do seu arquivo existente ~/.zshrc arquivo

cp ~/.zshrc ~/.zshrc.orig

3. Crie um novo arquivo de configuração zsh

Você pode criar um novo arquivo de configuração zsh copiando o modelo que nós incluímos para você.

cp ~/.oh-my-zsh/templates/zshrc.zsh-template ~/.zshrc

4. Altere a sua shell padrão

chsh -s $(which zsh)

Você deve sair da sua sessão de usuário e entrar novamente para ver esta alteração.

5. Inicialize sua nova configuração zsh

Após você abrir uma nova janela de terminal, ela deve carregar o zsh com a configuração do Oh My Zsh.

Problemas de instalação

Se você tiver algum soluço instalando, aqui estão algumas correções comuns.

• Pode ser necessário modificar o seu PATH em ~/.zshrc se não conseguir encontrar alguns comandos após a mudança para oh-my-zsh.
• Se você instalou manualmente ou alterou o local de instalação, verifique a variável de ambiente ZSH em ~/.zshrc.

Plugins e Temas Personalizados

Se você quiser sobrepor algum dos comportamentos padrão, basta adicionar um novo arquivo (terminando em .zsh) no diretório custom/.

Se você tiver muitas funções que vão bem juntas, você pode colocá-las como um arquivo XYZ.plugin.zsh no diretório custom/plugins/ e então habilitar este plugin.

Se você gostaria de sobrepor a funcionalidade de um plugin distribuído com Oh My Zsh, crie um plugin com o mesmo nome no diretório custom/plugins/ e ele será carregado ao invés do que está em plugins/.

Obtendo Atualizações

Por padrão, você será solicitado a verificar por atualizações a cada poucas semanas. Se você gostaria de oh-my-zsh atualizar automaticamente a si mesmo sem solicitar, defina o seguinte no seu ~/.zshrc:

Para desativar as atualizações automáticas, defina o seguinte no seu ~/.zshrc:

DISABLE_AUTO_UPDATE=true

Atualizações Manuais

Se você gostaria de atualizar a qualquer momento (talvez alguém acabou de lançar um novo plugin e você não quer esperar uma semana?) você só precisa executar:

omz update

Magic! 🎉

Desinstalando Oh My Zsh

Oh My Zsh não é para todos. Vamos sentir a sua falta, mas queremos fazer desta uma separação fácil.

Se você quiser desinstalar oh-my-zsh, basta executar uninstall_oh_my_zsh a partir da linha de comando. Ele irá remover-se e reverter o seu anterior bash ou zsh configuração.

Como posso contribuir para Oh My Zsh?

Antes de participar na nossa encantadora comunidade, por favor leia o código de conduta.

Eu estou longe de ser um especialista em Zsh e suspeito que há muitas maneiras de melhorar – se você tem idéias de como tornar a configuração mais fácil de manter (e mais rápida), não hesite em bifurcar e enviar pedidos de puxar!

Tambem precisamos de pessoas para testar os pedidos de puxar. Então dê uma olhada nos problemas abertos e ajude onde você pode.

Veja Contribuir para mais detalhes.

NÃO nos envie temas

Temos (mais do que) temas suficientes por enquanto. Por favor adicione seu tema à página wiki de temas externos.

Contribuintes

Oh Meu Zsh tem uma comunidade vibrante de usuários felizes e contribuintes deliciosos. Sem todo o tempo e ajuda de nossos colaboradores, não seria tão fantástico.

Muito obrigado!

Siga-nos

Estamos nas redes sociais:

• @ohmyzsh no Twitter. Você deve seguir.
• FaceBook nos cutucar.
• Instagram nos marcar no seu post mostrando Oh My Zsh!
• Discordar para conversar conosco!

Mercadoria

Temos adesivos, camisas e canecas de café disponíveis para você mostrar o seu amor por Oh My Zsh. Mais uma vez, você vai se tornar a conversa da cidade!

Licença

Oh My Zsh é lançado sob a licença do MIT.

Sobre o Planeta Argon