diff --git a/README.md b/README.md index 2e83194..d63fadc 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,7 @@ [한국어]: docs/ko-KR [Русский]: docs/ru-RU [Català]: docs/ca-ES +[Português]: docs/pt-PT [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] @@ -22,7 +23,7 @@ fisherman is a concurrent plugin manager for [fish-shell]. -Translations: [Español], [日本語], [简体中文], [한국어], [Русский], [Català]. +Translations: [Español], [日本語], [简体中文], [한국어], [Русский], [Català], [Português]. ## Features diff --git a/docs/ca-ES/README.md b/docs/ca-ES/README.md index 608898e..0bfb112 100644 --- a/docs/ca-ES/README.md +++ b/docs/ca-ES/README.md @@ -4,7 +4,7 @@ [travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg [organització]: https://github.com/fisherman -[fish shell]: https://github.com/fish-shell/fish-shell +[fish-shell]: https://github.com/fish-shell/fish-shell [fisherman]: http://fisherman.sh [en línia]: http://fisherman.sh/#search @@ -15,13 +15,14 @@ [한국어]: docs/ko-KR [Русский]: docs/ru-RU [Català]: docs/ca-ES +[Português]: ../pt-PT [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] # [fisherman] - gestor de complements per a fish -Llegeix aquest document en un altre llenguatge: [English], [Español], [日本語], [简体中文], [한국어], [Русский]. +Llegeix aquest document en un altre llenguatge: [English], [Español], [日本語], [简体中文], [한국어], [Русский], [Português]. ## Prestacions diff --git a/docs/es-ES/README.md b/docs/es-ES/README.md index 1bdb105..bd626d2 100644 --- a/docs/es-ES/README.md +++ b/docs/es-ES/README.md @@ -4,7 +4,7 @@ [travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg [organización]: https://github.com/fisherman -[fish shell]: https://github.com/fish-shell/fish-shell +[fish-shell]: https://github.com/fish-shell/fish-shell [fisherman]: http://fisherman.sh [en línea]: http://fisherman.sh/#search @@ -14,13 +14,14 @@ [Русский]: ../ru-RU [한국어]: ../ko-KR [Català]: ../ca-ES +[Português]: ../pt-PT [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] # [fisherman] - fish plugin manager -Lee este documento en otro idioma: [English], [日本語], [简体中文], [한국어], [Русский], [Català]. +Lee este documento en otro idioma: [English], [日本語], [简体中文], [한국어], [Русский], [Català], [Português]. ## Prestaciones diff --git a/docs/jp-JA/README.md b/docs/jp-JA/README.md index 74e07cb..8c0885a 100644 --- a/docs/jp-JA/README.md +++ b/docs/jp-JA/README.md @@ -4,7 +4,7 @@ [travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg [organization]: https://github.com/fisherman -[fish shell]: https://github.com/fish-shell/fish-shell +[fish-shell]: https://github.com/fish-shell/fish-shell [fisherman]: http://fisherman.sh [ウェブサイト]: http://fisherman.sh/#search @@ -14,6 +14,7 @@ [Русский]: ..//ru-RU [한국어]: ../ko-KR [Català]: ../ca-ES +[Português]: ../pt-PT [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] @@ -22,7 +23,7 @@ fisherman とは フィッシュシェルのための並列処理パッケージマネージャーです。 -翻訳: [English], [Español], [简体中文], [한국어], [Русский], [Català]. +翻訳: [English], [Español], [简体中文], [한국어], [Русский], [Català], [Português]. ## 理由 diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.md index b1788a2..f25ce10 100644 --- a/docs/ko-KR/README.md +++ b/docs/ko-KR/README.md @@ -4,7 +4,7 @@ [travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg [organization]: https://github.com/fisherman -[fish shell]: https://github.com/fish-shell/fish-shell +[fish-shell]: https://github.com/fish-shell/fish-shell [fisherman]: http://fisherman.sh [online]: http://fisherman.sh/#search @@ -14,15 +14,16 @@ [日本語]: ../jp-JA [Русский]: ../ru-RU [Català]: ../ca-ES +[Português]: ../pt-PT [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] # [fisherman] - fish shell 플러그인 매니저 -fisherman은 [fish shell]을 위한 병렬 처리 플러그인 매니저 입니다. +fisherman은 [fish-shell]을 위한 병렬 처리 플러그인 매니저 입니다. -다른 언어로 읽기: [English], [Español], [日本語], [简体中文], [Русский], [Català]. +다른 언어로 읽기: [English], [Español], [日本語], [简体中文], [Русский], [Català], [Português]. ## 왜 fisherman을 사용해야 하죠? diff --git a/docs/pt-PT/README.md b/docs/pt-PT/README.md new file mode 100644 index 0000000..1ae83e8 --- /dev/null +++ b/docs/pt-PT/README.md @@ -0,0 +1,219 @@ +[slack-link]: https://fisherman-wharf.herokuapp.com/ +[slack-badge]: https://fisherman-wharf.herokuapp.com/badge.svg +[travis-link]: https://travis-ci.org/fisherman/fisherman +[travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg + +[organização]: https://github.com/fisherman +[fish-shell]: https://github.com/fish-shell/fish-shell +[fisherman]: http://fisherman.sh +[online]: http://fisherman.sh/#search + +[English]: ../../README.md +[Español]: ../es-ES +[简体中文]: ../zh-CN +[日本語]: ../jp-JA +[Русский]: ../ru-RU +[한국어]: ../ko-KR +[Català]: ../ca-ES + +[![Build Status][travis-badge]][travis-link] +[![Slack][slack-badge]][slack-link] + +# [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. + +```sh +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. + +```sh +fisher ~/my_aliases +``` + +Edite o ficheiro fishfile e execute `fisher` para aplicar as alterações + +> [O que é o ficheiro fishfile e como é que eu o utilizo?](#6-o-que-é-o-ficheiro-fishfile-e-como-é-que-eu-o-utilizo) + +```sh +$EDITOR fishfile # adicionar plugins +fisher +``` + +Mostrar os plugins instalados actualmente. + +```ApacheConf +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. + +```ApacheConf +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](#8-o-que-é-um-plugin). + +```fish +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. + +```sh +echo "/usr/local/bin/fish" | sudo tee -a /etc/shells +chsh -s /usr/local/bin/fish +``` + +### 3. Como faço para desinstalar fisherman? +```fish +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 `. + +### 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 é: + +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. + +### 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. + +```fish +owner/repo +https://github.com/dude/sweet +https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32 +``` diff --git a/docs/ru-RU/README.md b/docs/ru-RU/README.md index 0fa65b2..352793d 100644 --- a/docs/ru-RU/README.md +++ b/docs/ru-RU/README.md @@ -3,7 +3,7 @@ [travis-link]: https://travis-ci.org/fisherman/fisherman [travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg -[fish shell]: https://github.com/fish-shell/fish-shell +[fish-shell]: https://github.com/fish-shell/fish-shell [fisherman]: https://github.com/fisherman.sh [fishfile]: #6-Что-такое-fishfile-и-как-я-могу-его-использовать [организации]: https://github.com/fisherman @@ -16,13 +16,14 @@ [Русский]: ../ru-RU [한국어]: ../ko-KR [Català]: ../ca-ES +[Português]: ../pt-PT [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] -# [fisherman] - менеджер плагинов для [fish shell] +# [fisherman] - менеджер плагинов для [fish-shell] -Другие переводы: [English], [Español], [日本語], [简体中文], [한국어], [Català]. +Другие переводы: [English], [Español], [日本語], [简体中文], [한국어], [Català], [Português]. ## Достоинства fisherman diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index 62d344a..f9d41b5 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -4,7 +4,7 @@ [travis-badge]: https://img.shields.io/travis/fisherman/fisherman.svg [organization]: https://github.com/fisherman -[fish shell]: https://github.com/fish-shell/fish-shell +[fish-shell]: https://github.com/fish-shell/fish-shell [fisherman]: http://fisherman.sh [online]: http://fisherman.sh/#search @@ -14,15 +14,16 @@ [Русский]: ../ru-RU [한국어]: ../ko-KR [Català]: ../ca-ES +[Português]: ../pt-PT [![Build Status][travis-badge]][travis-link] [![Slack][slack-badge]][slack-link] # [fisherman] - fish shell plugin manager -fisherman 是一款零配置,并发的 [fish shell] 插件管理器。 +fisherman 是一款零配置,并发的 [fish-shell] 插件管理器。 -选择不同语言版本的文档: [Español], [日本語], [English], [한국어], [Русский], [Català]。 +选择不同语言版本的文档: [Español], [日本語], [English], [한국어], [Русский], [Català], [Português]。 ##为什么使用fisherman?