This commit is contained in:
Jorge Bucaran 2016-05-14 14:17:27 +09:00
parent 1f2941ac1d
commit 59000414e8
No known key found for this signature in database
GPG key ID: E54BA3C0E646DB30
9 changed files with 149 additions and 235 deletions

View file

@ -25,16 +25,6 @@ A plugin manager for [fish].
Translations: [日本語], [简体中文], [한국어], [Русский], [Català], [Português], [Español].
## Features
* Zero configuration
* No external dependencies
* No impact on shell startup time
* Only the essentials, install, update, remove, list and help
## Install
```sh
@ -46,13 +36,13 @@ curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
Install a plugin.
```
fisher simple
fisher real
```
Install from multiple sources.
```
fisher z fzf edc/bass omf/tab
fisher z fzf edc/bass omf/thefuck
```
Install a gist.
@ -79,10 +69,10 @@ List what you've installed.
```ApacheConf
fisher ls
@ plugin # a local plugin
* simple # current prompt
* real # current prompt
bass
fzf
tab
thefuck
z
```
@ -107,7 +97,7 @@ fisher up bass z fzf
Remove plugins.
```
fisher rm simple
fisher rm thefuck
```
Remove all the plugins.

View file

@ -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]: https://github.com/fish-shell/fish-shell
[fisherman]: http://fisherman.sh
[en línia]: http://fisherman.sh/#search
@ -13,19 +13,9 @@
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish plugin manager
# [fisherman]
fisherman és un gestor de complements per a [fish-shell].
## Prestacions
* Sense configuració
* Sense dependencies externes
* No afecta als temps d'arrencada de la consola de comandes
* Només l'essencial, instal·lar, actualitzar, esborrar, llistar i ajuda
fisherman és un gestor de complements per a [fish].
## Instal·la
@ -35,24 +25,18 @@ Amb curl.
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
```
Si encara estàs fent anar la versió 1.5 i vols actualitzar a >2.0 sense mes preocupació.
```
curl -L git.io/fisher-up-me | fish
```
## Mode d'ús
Instal·la un complement.
```
fisher simple
fisher real
```
Instal·la des de múltiples fonts.
```
fisher z fzf omf/{grc,thefuck}
fisher z fzf edc/bass omf/thefuck
```
Instal·la des de una URL.
@ -70,7 +54,7 @@ fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
Instal·la des de un directori local.
```sh
fisher ~/my_aliases
fisher ~/plugin
```
Edita el teu arxiu fishfile i executa `fisher` per a aplicar els canvis.
@ -86,8 +70,8 @@ Fes un cop d'ull al que tens instal·lat.
```ApacheConf
fisher ls
@ my_aliases # aquest complement esta dins un directori local
* simple # aquest complement es el tema actual
@ plugin # aquest complement esta dins un directori local
* real # aquest complement es el tema actual
bass
fzf
grc
@ -116,7 +100,7 @@ fisher up bass z fzf thefuck
Esborra alguns complements.
```
fisher rm simple
fisher rm thefuck
```
Esborra tots els complements.
@ -133,7 +117,7 @@ fisher help z
## FAQ
### 1. Quina es la versió necessaria de fish?
### Quina es la versió necessaria de fish?
fisherman va ésser construït per a fish >= 2.3.0. Si estàs fent anar la versió 2.2.0,
afegeix el següent codi al teu arxiu `~/.config/fish/config.fish` per a donar suport a [retalls](#8-que-es-un-complement).
@ -144,7 +128,7 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. Com converteixo fish en la meva consola de comandes per defecte?
### Com converteixo fish en la meva consola de comandes per defecte?
Afegeix fish a la llista de consoles de comandes dins de l'arxiu */etc/shells* i converteix-la en la teva consola de comandes per defecte.
@ -153,7 +137,7 @@ echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
### 3. Com des-instal·lo fisherman?
### Com des-instal·lo fisherman?
```fish
fisher self-uninstall
@ -165,11 +149,11 @@ o
npm un -g fisherman
```
### 4. És fisherman compatible amb els temes i complements de oh my fish?
### És fisherman compatible amb els temes i complements de oh my fish?
Si.
### 5. On deixa fisherman les seves coses?
### On deixa fisherman les seves coses?
fisherman es guarda al directori *~/.config/fish/functions/fisher.fish*.
@ -177,14 +161,14 @@ La caché i configuracions són creades dins de *~/.cache/fisherman* i *~/.confi
El arxiu fishfile es guarda a *~/.config/fish/fishfile*.
### 6. Que és un arxiu fishfile i com el faig anar?
### Que és un arxiu fishfile i com el faig anar?
El arxiu fishfile *~/.config/fish/fishfile* llista tots els complements instal·lats.
Pots deixar que en fisherman s'encarregui d'aquest arxiu per tu automaticament, o be escriure a dins els complements que vols instal·lar i llavors executar `fisher` per a aplicar els canvis.
```
fisherman/simple
fisherman/real
fisherman/z
omf/thefuck
omf/grc
@ -192,11 +176,11 @@ omf/grc
Aquest procediment només instal·la complements i dependències. Per esborrar complements, fes anar `fisher rm` al seu lloc.
### 7. On puc trobar una llista de complements de fish?
### On puc trobar una llista de complements de fish?
Busca dins de l'[organització] o fes anar la busqueda [en línia] per descobrir contingut.
### 8. Que es un complement?
### Que es un complement?
Un complement es:
@ -206,7 +190,7 @@ Un complement es:
3. un retall, p.e., un o mes arxius *.fish* dins un directori anomenat *conf.d* que es evaluat per fish a l'arrencada de la consola de comandes.
### 9. Com puc llistar complements com dependencies del meu complement?
### Com puc llistar complements com dependencies del meu complement?
Crea un nou arxiu *fishfile* a l'arrel del teu i escriu a dins les dependències del teu complement.

View file

@ -4,16 +4,16 @@
[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]: https://github.com/fish-shell/fish-shell
[fisherman]: http://fisherman.sh
[en línea]: http://fisherman.sh/#search
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish plugin manager
# [fisherman]
fisherman es un gestor de paquetes para [fish-shell].
fisherman es un gestor de paquetes para [fish].
## Prestaciones
@ -42,13 +42,13 @@ curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
Instalar paquetes.
```
fisher simple
fisher real
```
Instalar desde múltiples fuentes.
```
fisher z fzf omf/{grc,thefuck}
fisher z fzf edc/bass omf/thefuck
```
Instalar desde URLs.
@ -66,7 +66,7 @@ fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
Instalar desde un directorio.
```sh
fisher ~/my_aliases
fisher ~/plugin
```
Edita el archivo fishfile y ejecuta `fisher` para aplicar los cambios.
@ -82,8 +82,8 @@ Muestra que tienes instalado actualmente.
```ApacheConf
fisher ls
@ my_aliases # este paquete esta en un directorio
* simple # este paquete es el tema actual
@ plugin # este paquete esta en un directorio
* real # este paquete es el tema actual
bass
fzf
grc
@ -112,7 +112,7 @@ fisher up bass z fzf thefuck
Elimina paquetes.
```
fisher rm simple
fisher rm thefuck
```
Elimina todos los paquetes.
@ -129,7 +129,7 @@ fisher help z
## FAQ
### 1. ¿Qué versión de fish es necesaria?
### ¿Qué versión de fish es necesaria?
fisherman fue diseñado para fish >= 2.3.0. Si tienes la versión 2.2.0 y no puedes actualizarla por algún motivo, añade este código en el archivo `~/.config/fish/config.fish` para poder ejecutar [snippets](#8-qué-es-un-paquete).
@ -139,7 +139,7 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. ¿Cómo hago fish mi consola de comandos por defecto?
### ¿Cómo hago fish mi consola de comandos por defecto?
Añade fish a la lista de consolas de comandos en */etc/shells*.
@ -148,7 +148,7 @@ echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
### 3. ¿Cómo puedo desinstalar fisherman?
### ¿Cómo puedo desinstalar fisherman?
Ejecuta
@ -162,11 +162,11 @@ o
npm un -g fisherman
```
### 4. ¿Es fisherman compatible con paquetes y temas de oh my fish?
### ¿Es fisherman compatible con paquetes y temas de oh my fish?
Sí.
### 5. ¿Dónde guarda fisherman sus cosas?
### ¿Dónde guarda fisherman sus cosas?
fisherman mismo esta en el archivo *~/.config/fish/functions/fisher.fish*.
@ -174,14 +174,14 @@ El caché y la configuración en *~/.cache/fisherman* y *~/.config/fisherman* re
El archivo fishfile en *~/.config/fish/fishfile*.
### 6. ¿Qué es el archivo fishfile y cómo lo uso?
### ¿Qué es el archivo fishfile y cómo lo uso?
El archivo fishfile *~/.config/fish/fishfile* contiene todos los paquetes que están instalados.
Puedes dejar que fisherman se encargue de este archivo automáticamente, o incluir los paquetes que necesitas y ejecutar `fisher` para aplicar los cambios.
```
fisherman/simple
fisherman/real
fisherman/z
omf/thefuck
omf/grc
@ -189,11 +189,11 @@ omf/grc
Este comando solo instala paquetes y sus dependencias. Para borrar paquetes, usa `fisher rm`.
### 7. ¿Dónde consigo un listado de paquetes para fish?
### ¿Dónde consigo un listado de paquetes para fish?
Dirígete a la [organización] o usa la búsqueda [en línea] para descubrir contenido.
### 8. ¿Qué es un paquete?
### ¿Qué es un paquete?
Un paquete es:
@ -203,7 +203,7 @@ Un paquete es:
3. un snippet, es decir, uno o más archivos *.fish* en un directorio llamado *conf.d* que son ejecutados por fish al iniciar la sesión.
### 9. ¿Cómo puedo añadir dependencias a mi plugin?
### ¿Cómo puedo añadir dependencias a mi plugin?
Crea un archivo *fishfile* en la carpeta raíz de tu plugin y incluye los paquetes en el.

View file

@ -4,16 +4,16 @@
[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]: https://github.com/fish-shell/fish-shell
[fisherman]: http://fisherman.sh
[ウェブサイト]: http://fisherman.sh/#search
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish plugin manager
# [fisherman]
fisherman とは [fish-shell]のための並列処理パッケージマネージャーです。
fisherman とは [fish]のための並列処理パッケージマネージャーです。
## 理由
@ -40,13 +40,13 @@ curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
プラグインをインストール:
```
fisher simple
fisher real
```
様々な所からもインストール:
```
fisher z fzf omf/{grc,thefuck}
fisher z fzf edc/bass omf/thefuck
```
URL からインストール:
@ -64,7 +64,7 @@ fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
ディレクトリをインストール:
```sh
fisher ~/my_aliases
fisher ~/plugin
```
vundleのように 「fishfile」というファイルにプラグインたちを追加して `fisher` でインストール:
@ -80,8 +80,8 @@ fisher
```ApacheConf
fisher ls
@ my_aliases # ローカルディレクトリ
* simple # 現在のテーマ
@ plugin # ローカルディレクトリ
* real # 現在のテーマ
bass
fzf
grc
@ -104,7 +104,7 @@ fisher up bass z fzf thefuck
プラグインを削除:
```
fisher rm simple
fisher rm thefuck
```
すべてのプラグインを削除:
@ -121,7 +121,7 @@ fisher help z
## FAQ
### 1. fishの必要なバージョンとは
### fishの必要なバージョンとは
fish >= 2.3.0 が必要です。まだ 2.2.0 を使っているのならば [snippets](#8-プラグインとは) の対応のため次のコードを `~/.config/fish/config.fish` に追記してください。
@ -131,7 +131,7 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. フィッシュシェルをデフォルトのシェルにするには?
### フィッシュシェルをデフォルトのシェルにするには?
システムの */etc/shells* ファイルに、fish を追加:
@ -140,7 +140,7 @@ echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
### 3. fishermanを削除する方法とは
### fishermanを削除する方法とは
```fish
fisher self-uninstall
@ -152,22 +152,22 @@ fisher self-uninstall
npm un -g fisherman
```
### 4. oh-my-fishのプラグインとテーマに対応ですか
### oh-my-fishのプラグインとテーマに対応ですか
対応してます
### 5. fishermanのファイル等は、どこに保存されますか
### fishermanのファイル等は、どこに保存されますか
fisherman 自体は *~/.config/fish/functions/fisher.fish* に作成されます。そしてキャシュは*~/.cache/fisherman*に、コンフィグディレクトリは *~/.config/fisherman* に。fishfileは*~/.config/fish/fishfile*に保存されます
### 6. fishfileとは
### fishfileとは
fishfile*~/.config/fish/fishfile*)に現在インストールされているプラグインが書かれています。
fisherman で自動的にこのファイルを更新するか、手動でプラグインを追加して `fisher`を入力してインストールすることも可能です。
```
fisherman/simple
fisherman/real
fisherman/z
omf/thefuck
omf/grc
@ -175,11 +175,11 @@ omf/grc
この仕組はプラグインと、そのプラグインが依存しているものをインストールすることができます。プラグインを削除するために、`fisher rm`を使ってください。
### 7. フィッシュシェルのプラグインはどこにありますか?
### フィッシュシェルのプラグインはどこにありますか?
fisherman の [organization] や [ウェブサイト] 等で、プラグインを検索できます。
### 8. プラグインとは?
### プラグインとは?
プラグインとは
@ -189,7 +189,7 @@ fisherman の [organization] や [ウェブサイト] 等で、プラグイン
3. スニペット。つまり、1以上の*.fish*ファイルを*conf.d*といディレクトリに。こちらのファイルがフィッシュシェルがスタートする際に実行されます。
### 9. 自分のプラグインを、他のプラグインのデペンデンシーにしたい場合は?
### 自分のプラグインを、他のプラグインのデペンデンシーにしたい場合は?
プラグイン root ディレクトリの *fishfile* 編集してそのプラグインを追加してください。

View file

@ -4,16 +4,16 @@
[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]: https://github.com/fish-shell/fish-shell
[fisherman]: http://fisherman.sh
[online]: http://fisherman.sh/#search
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish plugin manager
# [fisherman]
fisherman은 [fish-shell]을 위한 병렬 처리 플러그인 매니저 입니다.
fisherman은 [fish]을 위한 병렬 처리 플러그인 매니저 입니다.
## 왜 fisherman을 사용해야 하죠?
@ -40,13 +40,13 @@ curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
플러그인 설치:
```
fisher simple
fisher real
```
여러 출처로 부터 한꺼번에 설치:
```
fisher z fzf omf/{grc,thefuck}
fisher z fzf edc/bass omf/thefuck
```
URL를 통해 설치:
@ -64,7 +64,7 @@ fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
로컬 디렉토리로 부터 설치:
```sh
fisher ~/my_aliases
fisher ~/plugin
```
플러그인 패키지 관리 파일로 정의하고 `fisher` 명령어로 변경사항을 적용:
@ -80,8 +80,8 @@ fisher
```ApacheConf
fisher ls
@ my_aliases # 로컬 디렉토리 설치 플러그인
* simple # 현재 사용되고 있는 프롬프트 스타일 플러그인
@ plugin # 로컬 디렉토리 설치 플러그인
* real # 현재 사용되고 있는 프롬프트 스타일 플러그인
bass
fzf
grc
@ -104,7 +104,7 @@ fisher up bass z fzf thefuck
플러그인 삭제:
```
fisher rm simple
fisher rm thefuck
```
모든 플러그인 삭제:
@ -121,7 +121,7 @@ fisher help z
## 자주묻는 질문과 답변
### 1. 필요로하는 fish shell 버전은?
### 필요로하는 fish shell 버전은?
fisherman은 fish shell 버전 2.3.0 이상부터 지원합니다. 만약 2.2.0을 사용하고 있다면 [코드조각](#8-플러그인이-뭐죠?) 지원을 위하여 아래의 코드를 `~/.config/fish/config.fish`에 추가해 주세요.
@ -131,7 +131,7 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. 어떻게 fish를 기본 shell로 지정하나요?
### 어떻게 fish를 기본 shell로 지정하나요?
*/etc/shells* 파일에 있는 shell 목록에 fish를 추가하고, 기본 shell로 지정합니다.
@ -140,7 +140,7 @@ echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
### 3. fisherman을 삭제하고 싶어요.
### fisherman을 삭제하고 싶어요.
```fish
fisher self-uninstall
@ -152,26 +152,26 @@ fisher self-uninstall
npm un -g fisherman
```
### 4. fisherman은 oh my fish 패키지 관리자의 테마, 플러그인과 호환 되나요?
### fisherman은 oh my fish 패키지 관리자의 테마, 플러그인과 호환 되나요?
네.
### 5. fisherman은 어디에 파일을 두나요?
### fisherman은 어디에 파일을 두나요?
fisherman 자체는 *~/.config/fish/functions/fisher.fish* 입니다.
캐쉬와 플러그인 관리 파일은 각각 *~/.cache/fisherman*과 *~/.config/fisherman*을 관례로 사용합니다.
캐쉬와 플러그인 관리 파일은 각각 *~/.cache/fisherman* *~/.config/fisherman* 을 관례로 사용합니다.
fishfile은 *~/.config/fish/fishfile*에 위치합니다.
fishfile은 *~/.config/fish/fishfile* 에 위치합니다.
### 6. fishfile이 뭐죠? 어떻게 사용하나요?
### fishfile이 뭐죠? 어떻게 사용하나요?
fishfile은 *~/.config/fish/fishfile* 위치하며 모든 설치 플러그인의 목록이 담겨있습니다.
fisherman 명령어를 통해 플러그인을 설치/제거하면 자동으로 fishfile이 관리됩니다. 혹은, fishfile에 직접 플러그인을 추가하고 `fisher` 명령어를 입력하면 변경사항이 적용됩니다.
```
fisherman/simple
fisherman/real
fisherman/z
omf/thefuck
omf/grc
@ -179,23 +179,23 @@ omf/grc
이 방식은 설치나 이가 빠진 의존성에만 작동 합니다. 플러그인을 삭제하려면, `fisher rm`명령어를 사용하세요.
### 7. 어디서 플러그인을 찾을 수 있나요?
### 어디서 플러그인을 찾을 수 있나요?
fisherman의 [organization] 페이지를 살펴보거나 [online] 플러그인 목록에서 찾아보세요.
### 8. 플러그인이 뭐죠?
### 플러그인이 뭐죠?
플러그인은:
1. 최상단 혹은 최상단에 위치한 *functions* 디렉토리에 담긴 *.fish*파일이 기능으로 작동하는 디렉토리 혹은 git 저장소
1. 최상단 혹은 최상단에 위치한 *functions* 디렉토리에 담긴 *.fish* 파일이 기능으로 작동하는 디렉토리 혹은 git 저장소
2. 테마 혹은 프롬프트. 예: *fish_prompt.fish*이거나 *fish_right_prompt.fish* 혹은 두 파일 전부
2. 테마 혹은 프롬프트. 예: *fish_prompt.fish* 이거나 *fish_right_prompt.fish* 혹은 두 파일 전부
3. 코드 조각. 예: fish shell 시작시 불러들이게 되는 *conf.d* 디렉토리 안에 위치 한 *.fish* 파일들
### 9. 플러그인 제작시 의존성을 명시하는 방법이 있나요?
### 플러그인 제작시 의존성을 명시하는 방법이 있나요?
작성하는 플러그인 최상단 디렉토리에 *fishfile*를 만들고 의존성을 나열하세요.
작성하는 플러그인 최상단 디렉토리에 *fishfile* 를 만들고 의존성을 나열하세요.
```fish
owner/repo

View file

@ -4,30 +4,16 @@
[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
[fish]: https://github.com/fish-shell/fish-shell
[fisherman]: http://fisherman.sh
[online]: http://fisherman.sh/#search
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish plugin manager
# [fisherman]
fisherman é um gestor de plugins para [fish-shell].
## 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
fisherman é um gestor de plugins para [fish].
## Instalação
@ -42,13 +28,13 @@ curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
Instalar um plugin.
```
fisher simple
fisher real
```
Instalar através de múltiplas fontes.
```
fisher z fzf omf/{grc,thefuck}
fisher z fzf edc/bass omf/thefuck
```
Instalar através de URLs.
@ -66,7 +52,7 @@ fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
Instalar através de uma pasta local.
```sh
fisher ~/my_aliases
fisher ~/plugin
```
Edite o ficheiro fishfile e execute `fisher` para aplicar as alterações
@ -82,8 +68,8 @@ Mostrar os plugins instalados actualmente.
```ApacheConf
fisher ls
@ my_aliases # este plugin é uma pasta local
* simple # este plugin é o Tema da consola
@ plugin # este plugin é uma pasta local
* real # este plugin é o Tema da consola
bass
fzf
grc
@ -93,12 +79,8 @@ fisher ls
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.
@ -116,7 +98,7 @@ fisher up bass z fzf thefuck
Remover plugins.
```
fisher rm simple
fisher rm thefuck
```
Remover todos os plugins instalados.
@ -133,7 +115,7 @@ fisher help z
## FAQ
### 1. Qual é a versão da fish necessária?
### 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).
@ -143,7 +125,7 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. Como faço para tornar fish a minha consola predefinida?
### 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.
@ -152,16 +134,16 @@ echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
### 3. Como faço para desinstalar fisherman?
### Como faço para desinstalar fisherman?
```fish
fisher self-uninstall
```
### 4. O fisherman é compatível com os plugins e temas do oh my fish?
### O fisherman é compatível com os plugins e temas do oh my fish?
Sim.
### 5. Onde é que o fisherman guarda as suas coisas?
### Onde é que o fisherman guarda as suas coisas?
O fisherman é guardado no ficheiro *~/.config/fish/functions/fisher.fish*.
@ -169,14 +151,14 @@ A cache e a configuração é guardada nos ficheiros *~/.cache/fisherman* e *~/.
O ficheiro fishfile é guardado em *~/.config/fish/fishfile*.
### 6. O que é o ficheiro fishfile e como é que eu o utilizo?
### 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/real
fisherman/z
omf/thefuck
omf/grc
@ -184,11 +166,11 @@ omf/grc
Este comando apenas instalas plugins e suas dependências. Para desinstalar um plugin, tem que executar `fisher rm <nome-do-plugin>`.
### 7. Onde consigo ver os plugins disponíveis para instalação?
### 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?
### O que é um plugin?
Um plugin é:
@ -198,7 +180,7 @@ Um plugin é:
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?
### 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.

View file

@ -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]: https://github.com/fish-shell/fish-shell
[fisherman]: https://github.com/fisherman.sh
[fishfile]: #6-Что-такое-fishfile-и-как-я-могу-его-использовать
[организации]: https://github.com/fisherman
@ -12,23 +12,9 @@
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish plugin manager
# [fisherman]
fisherman это параллельный менеджер плагинов для [fish-shell].
## Достоинства fisherman
* Не нужно настраивать
* Нет внешних зависимостей
* Не влияет на время запуска оболочки
* Можно использовать в интерактивном режиме или через [fishfile]
* Плагины устанавливаются и обновляются в параллельном режиме
* Только необходимые функции: установка, обновление, удаление, список и справка
fisherman это параллельный менеджер плагинов для [fish].
## Установка
@ -43,13 +29,13 @@ curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
Установка отдельного плагина.
```
fisher simple
fisher real
```
Установка из нескольких источников.
```
fisher z fzf omf/{grc,thefuck}
fisher z fzf edc/bass omf/thefuck
```
Установка по ссылке URL.
@ -67,7 +53,7 @@ fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
Установка из локального каталога.
```sh
fisher ~/my_aliases
fisher ~/plugin
```
Отредактируйте [fishfile] и запустите `fisher`, чтобы изменения вступили в силу.
@ -81,8 +67,8 @@ fisher
```ApacheConf
fisher ls
@ my_aliases # этот плагин представляет собой локальный каталог
* simple # этот плагин является текущим оформлением командной строки
@ plugin # этот плагин представляет собой локальный каталог
* real # этот плагин является текущим оформлением командной строки
bass
fzf
grc
@ -94,10 +80,6 @@ fisher ls
```
fisher ls-remote
...
spin roach git_util pwd_info
submit flash pyenv host_info
...
```
Обновление всего сразу.
@ -115,7 +97,7 @@ fisher up bass z fzf thefuck
Удаление плагинов.
```
fisher rm simple
fisher rm thefuck
```
Удаление всех плагинов.
@ -132,7 +114,7 @@ fisher help z
## Часто задаваемые вопросы
### 1. Какая версия fish необходима?
### Какая версия fish необходима?
fisherman был разработан для fish >= 2.3.0. Если вы используете 2.2.0, добавьте следующий код в ваш `~/.config/fish/config.fish` для поддержки [cниппетов](#8-Что-такое-плагин).
@ -142,7 +124,7 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. Как сделать fish основной командной оболочкой?
### Как сделать fish основной командной оболочкой?
Добавьте fish в список командных оболочек */etc/shells* и сделайте её оболочкой по умолчанию.
@ -151,17 +133,17 @@ echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
### 3. Как мне удалить fisherman?
### Как мне удалить fisherman?
```fish
fisher self-uninstall
```
### 4. Совместим ли fisherman с темами и плагинами oh my fish?
### Совместим ли fisherman с темами и плагинами oh my fish?
Да.
### 5. Где fisherman хранит данные?
### Где fisherman хранит данные?
Скрипт fisherman находится в *~/.config/fish/functions/fisher.fish*.
@ -169,14 +151,14 @@ fisher self-uninstall
fishfile сохраняется в *~/.config/fish/fishfile*.
### 6. Что такое fishfile и как я могу его использовать?
### Что такое fishfile и как я могу его использовать?
В *~/.config/fish/fishfile* хранится список всех установленных плагинов.
fisherman обновляет этот файл автоматически, но вы также можете добавить плагины в список вручную и запустить `fisher`, чтобы эти изменения вступили в силу.
```
fisherman/simple
fisherman/real
fisherman/z
omf/thefuck
omf/grc
@ -184,11 +166,11 @@ omf/grc
Этот механизм только устанавливает плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте `fisher rm`.
### 7. Где я могу найти список плагинов для fish?
### Где я могу найти список плагинов для fish?
Используйте поиск по Github [организации] или [онлайн] поиск на сайте.
### 8. Что такое плагин?
### Что такое плагин?
Плагином является:
@ -198,7 +180,7 @@ omf/grc
3. сниппет, т.е. один или несколько *.fish* файлов в директории *conf.d*, которые загружаются при запуске fish
### 9. Как я могу объявить зависимости моего плагина?
### Как я могу объявить зависимости моего плагина?
Создайте новый *fishfile* в корне вашего проекта со списком зависимостей.

View file

@ -4,28 +4,16 @@
[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]: https://github.com/fish-shell/fish-shell
[fisherman]: http://fisherman.sh
[online]: http://fisherman.sh/#search
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish plugin manager
# [fisherman]
fisherman 是一款零配置,并发的 [fish-shell] 插件管理器。
##为什么使用fisherman
* 零配置
* 没有其他依赖
* 不影响 shell 启动速度
* 类似 [vundle](https://github.com/VundleVim/Vundle.vim) 的交互下载功能
* 实现了最核心的功能: 安装、更新、移除和查询插件
fisherman 是一款零配置,并发的 [fish] 插件管理器。
## 安装
@ -35,23 +23,18 @@ fisherman 是一款零配置,并发的 [fish-shell] 插件管理器。
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
```
如果你仍然在使用 fisherman 1.5 并且想轻松升级到 2.0以上, 可以执行以下命令
```sh
curl -L git.io/fisher-up-me | fish
```
## 功能
安装插件。
```
fisher simple
fisher real
```
从多个源安装插件。
```
fisher z fzf omf/{grc,thefuck}
fisher z fzf edc/bass omf/thefuck
```
从 URL 安装插件。
@ -69,7 +52,7 @@ fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
从本地目录安装插件。
```sh
fisher ~/my_aliases
fisher ~/plugin
```
使用 [vundle](https://github.com/VundleVim/Vundle.vim) 的方式安装插件,编辑你的 fishfile 并运行 `fisher` 去安装插件。
@ -85,8 +68,8 @@ fisher
```ApacheConf
fisher ls
@ my_aliases # 该插件是一个本地插件
* simple # 该插件是当前的命令行提示符插件
@ plugin # 该插件是一个本地插件
* real # 该插件是当前的命令行提示符插件
bass
fzf
grc
@ -96,13 +79,6 @@ fisher ls
列出远程插件。
```
fisher ls-remote
...
spin roach git_util pwd_info
submit flash pyenv host_info
...
```
更新所有。
@ -119,7 +95,7 @@ fisher up bass z fzf thefuck
移除指定的插件。
```
fisher rm simple
fisher rm thefuck
```
移除所有的插件。
@ -136,7 +112,7 @@ fisher help z
## 常见疑问解答
### 1. fish 的版本要求多少?
### fish 的版本要求多少?
fisherman 要求 2.3.0 及以上版本的 fish。如果正在使用 2.2.0 版本,你可以写入以下[代码片段](#8-什么是一个插件)到你的 `~/.config/fish/config.fish`
@ -146,7 +122,7 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. 如何让 fish 作为我默认的 shell ?
### 如何让 fish 作为我默认的 shell ?
Add fish to the list of login shells in */etc/shells* and make it your default shell.
把 fish 加入到 */etc/shells* 并令 fish 成为默认 shell。
@ -156,7 +132,7 @@ echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
### 3. 如何卸载 fisherman
### 如何卸载 fisherman
运行以下命令。
@ -164,24 +140,24 @@ chsh -s /usr/local/bin/fish
fisher self-uninstall
```
### 4. fisherman 兼容已有的 fish 主题和插件吗?
### fisherman 兼容已有的 fish 主题和插件吗?
是的。
### 5. fisherman 把数据放到哪里了?
### fisherman 把数据放到哪里了?
fisherman 的位置在 *~/.config/fish/functions/fisher.fish*
缓存和插件配置被分别存在 *~/.cache/fisherman**~/.config/fisherman*
fishfile 位置在 *~/.config/fish/fishfile*
### 6. 什么是 fishfile 以及如何使用它?
### 什么是 fishfile 以及如何使用它?
fishfile *~/.config/fish/fishfile* 列出了所有已安装的插件。
fisherman 安装插件时,会自动写入这个文件,或者你可以手动写入你想装的插件,然后运行 `fisher` 来安装插件
```
fisherman/simple
fisherman/real
fisherman/z
omf/thefuck
omf/grc
@ -189,11 +165,11 @@ omf/grc
这个文件只会记录插件和一些依赖。如果你想卸载插件,可以使用 `fisher rm`来替代。
### 7. 去哪里可以找到插件?
### 去哪里可以找到插件?
看看这个 [organization] 或者使用这个 [online] 来搜索。
### 8. 什么是一个插件?
### 什么是一个插件?
一个插件是:
@ -203,7 +179,7 @@ omf/grc
3. 一些代码片段,比如一个或多个在 *conf.d*目录下的 *.fish* 文件,并且它们会在 shell 启动时执行。
### 9. 如何把这些插件作为我自己插件的依赖?
### 如何把这些插件作为我自己插件的依赖?
在项目的顶层目录创建一个新的 *fishfile* 文件,并写下你的依赖。

View file

@ -737,7 +737,7 @@ function __fisher_plugin_enable -a path
if test -e "$target" -a ! -L "$target"
set -l backup_target "$fish_config/$dir/copy-$base"
__fisher_log info "Backup @$base@..." $__fisher_stderr
__fisher_log info "Save old @$base@" $__fisher_stderr
command mv "$target" "$backup_target" ^ /dev/stderr
end
@ -2023,7 +2023,7 @@ function __fisher_self_uninstall -a yn
set -e fisher_version
set -e fisher_spinners
__fisher_log okay "Arrr! So long and thanks for all the fish cap!" $__fisher_stderr
__fisher_log info "Done." $__fisher_stderr
set -l funcs (functions -a | command grep __fisher)
@ -2068,7 +2068,7 @@ function __fisher_man_page_write
# .
# .nf
#
# fisher simple
# fisher real
# .
# .fi
# .
@ -2136,7 +2136,7 @@ function __fisher_man_page_write
#
# fisher ls
# @ plugin # a local directory
# * simple # the current prompt
# * real # the current prompt
# bass
# fzf
# tab
@ -2192,7 +2192,7 @@ function __fisher_man_page_write
# .
# .nf
#
# fisher rm simple
# fisher rm thefuck
# .
# .fi
# .