From 59000414e82d98299e9a4d40f6fee19b32a69f3c Mon Sep 17 00:00:00 2001 From: Jorge Bucaran Date: Sat, 14 May 2016 14:17:27 +0900 Subject: [PATCH] Docs. --- README.md | 20 ++++---------- docs/ca-ES/README.md | 54 ++++++++++++++------------------------ docs/es-ES/README.md | 38 +++++++++++++-------------- docs/jp-JA/README.md | 38 +++++++++++++-------------- docs/ko-KR/README.md | 48 +++++++++++++++++----------------- docs/pt-PT/README.md | 58 ++++++++++++++--------------------------- docs/ru-RU/README.md | 56 ++++++++++++++------------------------- docs/zh-CN/README.md | 62 ++++++++++++++------------------------------ fisher.fish | 10 +++---- 9 files changed, 149 insertions(+), 235 deletions(-) diff --git a/README.md b/README.md index 951429e..5976444 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/docs/ca-ES/README.md b/docs/ca-ES/README.md index 4077d15..23dd941 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]: 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. diff --git a/docs/es-ES/README.md b/docs/es-ES/README.md index e5cbcfa..1fb32e4 100644 --- a/docs/es-ES/README.md +++ b/docs/es-ES/README.md @@ -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. diff --git a/docs/jp-JA/README.md b/docs/jp-JA/README.md index dd1e36e..209f258 100644 --- a/docs/jp-JA/README.md +++ b/docs/jp-JA/README.md @@ -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* 編集してそのプラグインを追加してください。 diff --git a/docs/ko-KR/README.md b/docs/ko-KR/README.md index 1b3b025..8e69dd5 100644 --- a/docs/ko-KR/README.md +++ b/docs/ko-KR/README.md @@ -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 diff --git a/docs/pt-PT/README.md b/docs/pt-PT/README.md index 077f631..bff06f6 100644 --- a/docs/pt-PT/README.md +++ b/docs/pt-PT/README.md @@ -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 `. -### 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. diff --git a/docs/ru-RU/README.md b/docs/ru-RU/README.md index 0665e25..dc864cd 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]: 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* в корне вашего проекта со списком зависимостей. diff --git a/docs/zh-CN/README.md b/docs/zh-CN/README.md index ec682a4..ef68550 100644 --- a/docs/zh-CN/README.md +++ b/docs/zh-CN/README.md @@ -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* 文件，并写下你的依赖。 diff --git a/fisher.fish b/fisher.fish index e00e254..993f647 100644 --- a/fisher.fish +++ b/fisher.fish @@ -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 # .