docs: add Brazilian Portuguese translation

README.md

@@ -12,6 +12,7 @@ Oh My Fish provides core infrastructure to allow you to install packages which e
 > <a href="docs/ru-RU/README.md">🇷🇺</a>
 > <a href="docs/zh-CN/README.md">🇨🇳</a>
 > <a href="docs/uk-UA/README.md">🇺🇦</a>
+> <a href="docs/pt-BR/README.md">🇧🇷</a>
 
 <br>
 

docs/en-US/FAQ.md

@@ -7,7 +7,7 @@
 > <a href="../ru-RU/FAQ.md">🇷🇺</a>
 > <a href="../zh-CN/FAQ.md">🇨🇳</a>
 > <a href="../uk-UA/FAQ.md">🇺🇦</a>
-
+> <a href="../pt-BR/FAQ.md">🇧🇷</a>
 <br>
 
 Thanks for taking the time to read this FAQ. Feel free to create a new issue if your question is not answered here.

docs/en-US/Packages.md

@@ -7,7 +7,7 @@
 > <a href="../ru-RU/Packages.md">🇷🇺</a>
 > <a href="../zh-CN/Packages.md">🇨🇳</a>
 > <a href="../uk-UA/Packages.md">🇺🇦</a>
-
+> <a href="../pt-BR/Packages.md">🇧🇷</a>
 <br>
 
 # Creating

docs/pt-BR/FAQ.md

@@ -0,0 +1,89 @@
+<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="128px" height="128px"/>
+<img align="left" width="0" height="128px"/>
+
+# FAQ
+
+> Documentação do Oh My Fish &nbsp;&bull;&nbsp;Também em
+> <a href="../en-US/FAQ.md">🇺🇸</a>
+> <a href="../ru-RU/FAQ.md">🇷🇺</a>
+> <a href="../zh-CN/FAQ.md">🇨🇳</a>
+> <a href="../uk-UA/FAQ.md">🇺🇦</a>
+
+<br>
+
+Obrigado por dedicar algum tempo para ler este FAQ. Sinta-se livre para criar um nova issue se sua pergunta não for respondida aqui.
+
+
+## O que é Oh My Fish e por que eu quero isso?
+
+Oh My Fish é um _framework_ para o [Fishshell](http://fishshell.com/). Ele ajuda você a gerenciar sua configuração, temas e pacotes.
+
+
+## O que eu preciso saber para usar o Oh My Fish?
+
+_Nada_. Você pode instalar o Oh My Fish e manter usando o Fish normalmente. Quando estiver pronto para aprender mais apenas digite `omf help`.
+
+
+## O que são os pacotes Oh My Fish?
+
+Os pacotes Oh My Fish são temas ou plugins escritos em fish que estendem as funcionalidades do shell, executando códigos durante a inicialização, adicionando auto-complete para funcionalidades conhecidas, etc.
+
+
+## Quais os tipos de pacotes do Oh My Fish?
+
+Há aproximadamente 3 tipos de pacotes:
+
+1. Utilitários de configuração. Por exemplo, [`pkg-pyenv`](https://github.com/oh-my-fish/pkg-pyenv) verifica se` pyenv` existe no seu sistema e executa `(pyenv init - | psub)` para você durante a inicialização.
+
+2. Temas. Confira nossa [galeria de temas](https://github.com/oh-my-fish).
+
+3. Utilitários shell tradicionais. Por exemplo [`pkg-copy`](https://github.com/oh-my-fish/pkg-copy), um utilitário de área de transferência compatível entre Linux e OSX.
+
+## O que exatamente o Oh My Fish faz?
+
++ Executa `$OMF_CONFIG/before.init.fish` se disponível.
+
++ Carregamento automático de pacotes e temas instalados em `$OMF_PATH/`.
+
++ Carregamento automático suas configurações. `~/.config/omf` por padrão, mas configurável via `$OMF_CONFIG`.
+
++ Carregamento automático de quaisquer `functions` armazenadas em `$OMF_PATH` e `$OMF_CONFIG`
+
++ Executa `$OMF_CONFIG/init.fish` se disponível.
+
+
+## Como eu posso atualizar uma instalação existente do Oh My Fish?
+
+> :warning: Lembre de fazer um backup de seus dotfiles e de outros dados importantes.
+
+```
+curl -L github.com/oh-my-fish/oh-my-fish/raw/master/bin/install | sh
+```
+
+Agora você pode remover com segurança o `$fish_path`.
+
+```fish
+rm -rf "$fish_path"
+```
+
+
+## Como eu uso o fish como meu shell padrão?
+
+Adicione Fish ao `/etc/shells`:
+
+```sh
+echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
+```
+
+Faça Fish seu shell padrão:
+
+```sh
+chsh -s /usr/local/bin/fish
+```
+
+Para alterar seu shell padrão de volta:
+> Substitua `/bin/bash` com `/bin/tcsh` ou `/bin/zsh` como desejar.
+
+```sh
+chsh -s /bin/bash
+```

docs/pt-BR/Packages.md

@@ -0,0 +1,129 @@
+<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="128px" height="128px"/>
+<img align="left" width="0" height="128px"/>
+
+# Pacotes
+
+> Documentação do Oh My Fish &nbsp;&bull;&nbsp;Também em
+> <a href="../en-US/Packages.md">🇺🇸</a>
+> <a href="../ru-RU/Packages.md">🇷🇺</a>
+> <a href="../zh-CN/Packages.md">🇨🇳</a>
+> <a href="../uk-UA/Packages.md">🇺🇦</a>
+
+<br>
+
+# Criando
+
+Para aprender a criação de pacotes vamos criar um novo pacote que irá fornecer um comando `hello_world` para o seu shell. Os nomes de pacotes só podem conter letras minúsculas e hifens para separar palavras.
+
+Oh My Fish pode criar uma estrutura padrão de um pacote para você. Use o comando `omf new`:
+
+```fish
+$ omf new pkg hello_world
+```
+
+> Use `omf new theme my_theme_name` para temas.
+
+O utilitário altera o diretório atual para o pacote recém-criado:
+```
+$ ls -l
+  README.md
+  init.fish
+  functions/hello_world.fish
+  completions/hello_world.fish
+```
+
+>Sempre descreva como seu pacote trabalha em `README.md`.
+
+
+>Também leia mais sobre [auto-complete](http://fishshell.com/docs/current/commands.html#complete) e tome cuidado para fornecê-lo para seus utilitários, quando aplicável.
+
+`functions/hello_world.fish` define uma
+simples função:
+
+```fish
+function hello_world -d "Prints hello world"
+  echo "Hello World!"
+end
+```
+
+Cada função no seu pacote deve ser declarada em seu próprio arquivo no diretório `functions`. Isso é exigido pelo mecanismo de carregamento automático do fish, que carrega funções sob demanda, evitando o carregamento de funções não utilizadas no momento da inicialização.
+
+Tenha em mente que o fish não tem um escopo privado, portanto, se você precisa dividir seu pacote em funções, evite conflitos de nomes prefixando suas funções com algo único -- como o nome do pacote (por exemplo, hello_world_print_help). Para evitar poluir o namespace de comandos, considere prefixar as funções privadas com dois sublinhados (por exemplo, `__function_name_print_help`).
+
+# Hooks
+
+Oh My Fish fornece um sistema de "hooks" que permite que você escreva scripts para seu pacote que são executados quando ocorrem outros eventos interessantes. Os pacotes podem usar esses ganchos para fornecer instalação avançada, gerenciamento de recursos personalizados, etc. Os ganchos são scripts fish comuns, nomeados de acordo com o nome do evento pelo qual são acionados. A maioria dos hooks residem em um diretório `hooks` dentro do diretório do projeto de um pacote.
+
+>Os Hooks que são chamados no momento da inicialização (`init.fish` e` key_bindings.fish`) podem desacelerar a inicialização do shell. Certifique-se de evitar o código lento no momento da inicialização! Além disso, se seu pacote não precisa de um arquivo de Hook, certifique-se de removê-lo.
+
+O diretório de trabalho dentro de um Hook é sempre definido para o diretório raiz do pacote. Os Hooks Oh My Fish atualmente suportados estão listados abaixo:
+
+## `init`
+
+O hook `init` é executado uma vez quando o shell primeiro carrega. Os scripts para lidar com este hook devem estar localizados em `init.fish` no diretório raiz do pacote.
+
+Dentro desse Hook, você pode acessar três variáveis relacionadas ao pacote:
+
+* `$package`: Nome do pacote
+* `$path`: Caminho de instalação do pacote
+* `$dependencies`: Dependências do pacote
+
+Por exemplo, com um script `init.fish` contendo o seguinte código:
+
+```fish
+echo "hello_world initialized"
+```
+Você verá a linha `hello_world initialized` no topo do terminal quando ele for aberto pela primeira vez.
+
+Use esse Hook para modificar o ambiente, carregar recursos, funções de carregamento automático, etc. Se o pacote não exportar nenhuma função, você ainda pode usar esse evento para adicionar funcionalidade ao seu pacote ou criar dinamicamente funções.
+
+
+## `key_bindings`
+
+Se o seu pacote ou tema precisar usar teclas de atalho, certifique-se de configurá-los no gancho `key_bindings`. Os scripts de teclas de atalho devem estar localizados em `key_bindings.fish` no diretório raiz do pacote. Neste gancho, você pode usar livremente o comando [`bind`][fish-bind] para definir ligações de teclas personalizadas.
+
+>Os temas também podem definir teclas de atalho! O Oh My Fish irá recarregar as teclas de atalho quando mudar de tema.
+
+## `install`
+
+O Hook `install` é acionado quando um pacote é instalado pela primeira vez. Os scripts para este gancho devem estar localizados em `hooks/install.fish`.
+
+Dentro desse hook, você pode acessar duas variáveis relacionadas ao pacote:
+
+* `$package`: Nome do pacote
+* `$path`: Caminho de instalação do pacote
+
+Este hook é útil para fazer o download de recursos adicionais, a criação de submódulos Git ou a instalação de dependências de terceiros, como os scripts Bash.
+
+
+## `update`
+
+Como você deve ter adivinhado, o gancho `update` é acionado para um pacote depois que ele é atualizado. Os scripts para este hook devem estar localizados em `hooks/update.fish`.
+
+Dentro desse gancho, você pode acessar duas variáveis relacionadas ao pacote:
+
+* `$package`: Nome do pacote
+* `$path`: Caminho de instalação do pacote
+
+Este hook é útil para atualizar submódulos Git ou verificar novas versões de dependências de terceiros.
+
+## `uninstall`
+
+O hook `uninstall` será acionado antes que um pacote seja removido via `omf remove <pkg>`. Os scripts para este hook devem estar localizados em `hooks/uninstall.fish`.
+
+Dentro desse gancho, você pode acessar duas variáveis relacionadas ao pacote:
+
+* `$package`: Nome do pacote
+* `$path`: Caminho de instalação do pacote
+
+Os pacotes podem usar este gancho para limpar recursos personalizados, etc.
+
+> Nota: para compatibilidade com versões anteriores, os hooks de desinstalação também serão executados se estiverem localizados em `uninstall.fish` na raiz do pacote.
+
+# Torná-lo público
+
+O registro oficial de pacotes públicos é gerenciado no repositório [oh-my-fish/packages-main](https://github.com/oh-my-fish/packages-main). Consulte o README desse repositório para obter instruções sobre como adicionar seu pacote ao banco de dados oficial do pacote.
+
+
+[fish-bind]: http://fishshell.com/docs/current/commands.html#bind
+[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls

docs/pt-BR/README.md

@@ -0,0 +1,151 @@
+<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="192px" height="192px"/>
+<img align="left" width="0" height="192px" hspace="10"/>
+
+
+> The <a href="http://fishshell.com">Fishshell</a> Framework
+
+[![MIT License](https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square)](/LICENSE.md) [![Fish Shell Version](https://img.shields.io/badge/fish-≥v2.2.0-007EC7.svg?style=flat-square)](http://fishshell.com) [![Travis Build Status](http://img.shields.io/travis/oh-my-fish/oh-my-fish.svg?style=flat-square)](https://travis-ci.org/oh-my-fish/oh-my-fish) [![Slack Status](https://oh-my-fish-slack.herokuapp.com/badge.svg)](https://oh-my-fish-slack.herokuapp.com)
+
+
+O Oh My Fish fornece infra-estrutura básica para permitir que você instale pacotes que estendam ou modifiquem a aparência do seu shell. É rápido, extensível e fácil de usar.
+
+> Veja também em&nbsp;
+> <a href="../ru-RU/README.md">🇷🇺</a>
+> <a href="../zh-CN/README.md">🇨🇳</a>
+> <a href="../uk-UA/README.md">🇺🇦</a>
+
+
+<br>
+
+## Instalação
+
+```fish
+curl -L https://github.com/oh-my-fish/oh-my-fish/raw/master/bin/install | fish
+omf help
+```
+
+Ou baixar e executar:
+
+```fish
+curl -L https://github.com/oh-my-fish/oh-my-fish/raw/master/bin/install > install
+fish install
+```
+
+## Tutorial
+
+O Oh My Fish inclui um pequeno utilitário `omf` para buscar e instalar novos pacotes e temas.
+
+#### `omf update` _`[omf]`_ _`[<package>...]`_
+
+Atualiza o Oh My Fish, todos os pacotes do repositório, e todos os pacotes instalados.
+
+- Quando chamado sem argumentos, atualiza o framework e todos os pacotes instalados.
+- Voce pode escolher atualizar somente o framework, executando `omf update omf`.
+- Para uma atualização seletiva de pacotes, liste apenas os nomes dos pacotes que pretende atualizar. Você ainda pode incluir "omf" na lista para atualizar o framework também.
+
+#### `omf install` _`[<name>|<url>]`_
+
+Instala um _ou mais_ pacotes.
+
+- Voce pode instalar pacotes diretamente pela URL via `omf install URL`
+- Quando chamado sem argumentos, instala os pacotes ausentes do [bundle](#dotfiles).
+
+#### `omf repositories` _`[list|add|remove]`_
+
+Gerencie os repositórios de pacotes instalados pelo usuário. Repositórios de pacotes são onde os pacotes vêm a ser usados por comandos como `omf install`. Por padrão o [repositorio oficial](https://github.com/oh-my-fish/packages-main) é sempre instalado e disponível.
+
+#### `omf list`
+
+Lista dos pacotes instalados.
+
+#### `omf theme` _`<theme>`_
+
+Aplica um tema. Para lista os temas disponíveis, digite `omf theme`. Você pode também [visualizar os temas disponíveis](./docs/Themes.md) antes da instalação.
+
+#### `omf remove` _`<name>`_
+
+Remove um tema ou pacote.
+
+> Os pacotes podem usar ganchos de desinstalação, portanto, a limpeza personalizada de recursos pode ser feita ao desinstalá-la. Ver [Desinstalação](/docs/en-US/Packages.md#uninstall) para mais informações.
+
+#### `omf reload`
+
+Recarrega Oh My Fish e todos os plugins usando `exec` para substituir o processo shell atual com um novo.
+
+> Este comando tenta ser o mais seguro possivel, suavizando os efeitos colaterais causados pelo `exec` e impedindo o recarregamento no caso de processos em plano de fundo.
+
+#### `omf new pkg | theme` _`<name>`_
+
+Cria uma estrutura para um novo pacote ou tema.
+
+> Cria um novo diretorio `$OMF_CONFIG/{pkg | themes}/` com um template.
+
+#### `omf search` _`-t|--theme / -pkg|--package`_ _`<name>`_
+
+Procura no banco de dados de Oh My Fish para um determinado pacote, tema ou ambos. Ele também suporta pesquisa fuzzy, então se você não tem certeza do nome, você pode simplesmente buscar `omf search simple`.
+
+#### `omf channel`
+
+Obtém ou altera o canal de atualização.
+
+Dois canais estão disponíveis por padrão: o canal `stable` que fornece atualizações estáveis com a última versão etiquetada de Oh My Fish e `dev` que fornece as últimas alterações em desenvolvimento. O canal de atualização atualmente definido determina para qual versão `omf update` atualizará.
+
+#### `omf doctor`
+
+Use para solucionar problemas antes de [abrir um issue][omf-issues-new].
+
+#### `omf destroy`
+
+Desinstala o Oh My Fish.
+
+## Avançado
+
+O instalador do Oh My Fish coloca seu código de inicialização no arquivo de configuração do fish (`~/.config/fish/config.fish`).
+
+### Inicialização
+
+Toda vez que você abre um novo shell, o código de inicialização define o diretório de instalação do Oh My Fish e o caminho da _configuração_ (~/.config/omf por padrão), chamando o script init.fish posteriormente, o qual carrega os pacotes, temas e
+seus arquivos de inicialização personalizados.
+
+Para mais informações confira a [FAQ](FAQ.md#o-que-exatamente-o-oh-my-fish-faz).
+
+### Dotfiles (arquivos de configuração)
+
+O diretório `$ OMF_CONFIG` representa o estado do usuário de Oh My Fish. É o candidato perfeito para ser adicionado aos seus dotfiles e / ou ao sistema de controle de versão. Existem quatro arquivos importantes:
+
+- __`theme`__ - O tema atual
+- __`bundle`__ - Lista atual dos  pacotes/temas instalados
+- __`init.fish`__ - Script personalizado que é executado depois de executar shell
+- __`before.init.fish`__ - Script personalizado que é executado antes de executar shell
+- __`key_bindings.fish`__ - Teclas de atalho customizadas onde você pode usar o comando `bind` livremente.
+
+É altamente recomendado que customize os comandos de inicialização no arquivo `init.fish` invés do `~/.config/fish/config.fish`, com isso permite a você manter todo `$OMF_CONFIG` diretamente sobre o controle de versão.
+
+Se você precisar executar comandos de inicialização *antes* Oh My Fish iniciar os plugins, coloque eles em `before.init.fish`. Se está inseguro, é melhor coloca-los em `init.fish`.
+
+#### Alterando variáveis em `init.fish`
+
+Um dos mais comuns comandos de inicialização usados no `init.fish` é a definição de variáveis. Muito provavelmente, essas variáveis precisam estar disponíveis em qualquer sessão do shell. Para conseguir isso, defina-os globalmente. Por exemplo:
+
+```fish
+# Golang developers might need this one
+set -xg GOPATH $HOME/gocode
+
+# Python developers otherwise
+set -xg PYTHONDONTWRITEBYTECODE 1
+```
+
+#### Sobre o bundle
+
+A todo momento pacotes/temas são instalados ou removidos, o arquivo `bundle` é atualizado. Você também pode editar eles manualmente e executar `omf install` apos concluir as alterações. Por favor note que enquanto pacotes/temas adicionados ao bundle são automaticamente instalados, um pacote/tema removido do bundle não sera removido das instalações do usuário.
+
+## Criando Pacotes
+
+O Oh My Fish usa uma arquitetura moderna e bem definida de plugins para facilitar o desenvolvimento de um plugin, incluindo eventos de inicialização/exclusão, funções de backup. [consulte a documentação](docs/en-US/Packages.md) para mais detalhes.
+
+
+[fishshell]: http://fishshell.com
+[contributors]: https://github.com/oh-my-fish/oh-my-fish/graphs/contributors
+[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls
+[omf-issues-new]: https://github.com/oh-my-fish/oh-my-fish/issues/new
+[releases]: https://github.com/oh-my-fish/oh-my-fish/releases