pull/445/head 2.6.0
Jorge Bucaran 8 years ago
parent 4ee6995c65
commit d31d68daeb
No known key found for this signature in database
GPG Key ID: E54BA3C0E646DB30

@ -86,8 +86,8 @@ See what's installed.
```ApacheConf
fisher ls
@ my_aliases # this plugin is a local directory
* simple # this plugin is the current prompt
@ my_aliases # this is a local directory
* simple # this is the current prompt
bass
fzf
grc
@ -95,7 +95,7 @@ fisher ls
z
```
See what you can install.
See everything available.
```
fisher ls-remote
@ -135,7 +135,9 @@ fisher help z
### 1. What is the required fish version?
fisherman works best in fish >= 2.3.0. If you are using 2.2.0, append the following code to your `~/.config/fish/config.fish` for [snippet](#8-what-is-a-plugin) support.
\>=2.2.0.
For [snippet](#8-what-is-a-plugin) support, upgrade to 2.3.0 or append the following code to your *~/.config/fish/config.fish*.
```fish
for file in ~/.config/fish/conf.d/*.fish
@ -145,7 +147,7 @@ end
### 2. How do I use fish as my default shell?
Add fish to the list of login shells in `/etc/shells` and make it your default shell.
Add fish to the list of login shells in */etc/shells* and make it your default shell.
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
@ -164,15 +166,15 @@ Yes.
### 5. Where does fisherman put stuff?
fisherman is saved to `~/.config/fish/functions/fisher.fish`.
fisherman is saved to *~/.config/fish/functions/fisher.fish*.
The cache and configuration is created in `~/.cache/fisherman` and `~/.config/fisherman` respectively.
The cache and configuration is created in *~/.cache/fisherman* and *~/.config/fisherman* respectively.
The fishfile is saved to `~/.config/fish/fishfile`.
The fishfile is saved to *~/.config/fish/fishfile*.
### 6. What is a fishfile and how do I use it?
The fishfile `~/.config/fish/fishfile` lists all the installed plugins.
The fishfile *~/.config/fish/fishfile* lists all the installed plugins.
You can let fisherman take care of this file for you automatically, or write in the plugins you want and run `fisher` to satisfy the changes.
@ -185,7 +187,7 @@ omf/grc
This mechanism only installs plugins and missing dependencies. To remove a plugin, use `fisher rm` instead.
### 7. Where can I find a list of fish plugins?
### 7. Where can I find the list of fish plugins?
Browse the [organization] or use the [online] search to discover content.
@ -193,18 +195,18 @@ Browse the [organization] or use the [online] search to discover content.
A plugin is:
1. a directory or git repo with a function `.fish` file either at the root level of the project or inside a `functions` directory
1. a directory or git repo with a function *.fish* file either at the root level of the project or inside a *functions* directory
2. a theme or prompt, i.e, a `fish_prompt.fish`, `fish_right_prompt.fish` or both files
2. a theme or prompt, i.e, a *fish_prompt.fish*, *fish_right_prompt.fish* or both files
3. a snippet, i.e, one or more `.fish` files inside a directory named `conf.d` that are evaluated by fish at the start of the shell
3. a snippet, i.e, one or more *.fish* files inside a directory named *conf.d* that are evaluated by fish at the start of the shell
### 9. How can I list plugins as dependencies to my plugin?
Create a new `fishfile` file at the root level of your project and write in the plugin dependencies.
Create a new *fishfile* file at the root level of your project and write in the plugin dependencies.
```fish
owner/repo
https://github.com/owner/repo
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
```

@ -146,7 +146,7 @@ end
### 2. 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.
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.
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
@ -171,15 +171,15 @@ Si.
### 5. On deixa fisherman les seves coses?
fisherman es guarda al directori `~/.config/fish/functions/fisher.fish`.
fisherman es guarda al directori *~/.config/fish/functions/fisher.fish*.
La caché i configuracions són creades dins de `~/.cache/fisherman` i `~/.config/fisherman` respectivament.
La caché i configuracions són creades dins de *~/.cache/fisherman* i *~/.config/fisherman* respectivament.
El arxiu fishfile es guarda a `~/.config/fish/fishfile`.
El arxiu fishfile es guarda a *~/.config/fish/fishfile*.
### 6. Que és un arxiu fishfile i com el faig anar?
El arxiu fishfile `~/.config/fish/fishfile` llista tots els complements instal·lats.
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.
@ -200,18 +200,18 @@ Busca dins de l'[organització] o fes anar la busqueda [en línia] per descobrir
Un complement es:
1. un directori o repositori de git amb una funció dins d'un arxiu `.fish` ja be a l'arrel del projecte o dins d'un directori `functions`
1. un directori o repositori de git amb una funció dins d'un arxiu *.fish* ja be a l'arrel del projecte o dins d'un directori *functions*
2. un tema o prompt, p.e., un `fish_prompt.fish`, `fish_right_prompt.fish` o ambdós
2. un tema o prompt, p.e., un *fish_prompt.fish*, *fish_right_prompt.fish* o ambdós
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.
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?
Crea un nou arxiu `fishfile` a l'arrel del teu i escriu a dins les dependències del teu complement.
Crea un nou arxiu *fishfile* a l'arrel del teu i escriu a dins les dependències del teu complement.
```fish
owner/repo
https://github.com/owner/repo
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
```

@ -141,7 +141,7 @@ end
### 2. ¿Cómo hago fish mi consola de comandos por defecto?
Añade fish a la lista de consolas de comandos en `/etc/shells`.
Añade fish a la lista de consolas de comandos en */etc/shells*.
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
@ -168,15 +168,15 @@ Sí.
### 5. ¿Dónde guarda fisherman sus cosas?
fisherman mismo esta en el archivo `~/.config/fish/functions/fisher.fish`.
fisherman mismo esta en el archivo *~/.config/fish/functions/fisher.fish*.
El caché y la configuración en `~/.cache/fisherman` y `~/.config/fisherman` respectivamente.
El caché y la configuración en *~/.cache/fisherman* y *~/.config/fisherman* respectivamente.
El archivo fishfile en `~/.config/fish/fishfile`.
El archivo fishfile en *~/.config/fish/fishfile*.
### 6. ¿Qué es el archivo fishfile y cómo lo uso?
El archivo fishfile `~/.config/fish/fishfile` contiene todos los paquetes que están instalados.
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.
@ -197,18 +197,18 @@ Dirígete a la [organización] o usa la búsqueda [en línea] para descubrir con
Un paquete es:
1. un directorio o repositorio de git con una función / archivo `.fish` bien sea en el directorio raíz del proyecto o en un directorio llamado `functions`.
1. un directorio o repositorio de git con una función / archivo *.fish* bien sea en el directorio raíz del proyecto o en un directorio llamado *functions*.
2. un tema o prompt, es decir, `fish_prompt.fish`, `fish_right_prompt.fish` o ambos.
2. un tema o prompt, es decir, *fish_prompt.fish*, *fish_right_prompt.fish* o ambos.
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.
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?
Crea un archivo `fishfile` en la carpeta raíz de tu plugin y incluye los paquetes en el.
Crea un archivo *fishfile* en la carpeta raíz de tu plugin y incluye los paquetes en el.
```fish
owner/repo
https://github.com/owner/repo
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
```

@ -133,7 +133,7 @@ end
### 2. フィッシュシェルをデフォルトのシェルにするには?
システムの `/etc/shells` ファイルに、fish を追加:
システムの */etc/shells* ファイルに、fish を追加:
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
@ -158,11 +158,11 @@ npm un -g fisherman
### 5. fishermanのファイル等は、どこに保存されますか
fisherman 自体は `~/.config/fish/functions/fisher.fish` に作成されます。そしてキャシュは`~/.cache/fisherman`に、コンフィグディレクトリは `~/.config/fisherman` に。fishfileは`~/.config/fish/fishfile`に保存されます
fisherman 自体は *~/.config/fish/functions/fisher.fish* に作成されます。そしてキャシュは*~/.cache/fisherman*に、コンフィグディレクトリは *~/.config/fisherman* に。fishfileは*~/.config/fish/fishfile*に保存されます
### 6. fishfileとは
fishfile`~/.config/fish/fishfile`)に現在インストールされているプラグインが書かれています。
fishfile*~/.config/fish/fishfile*)に現在インストールされているプラグインが書かれています。
fisherman で自動的にこのファイルを更新するか、手動でプラグインを追加して `fisher`を入力してインストールすることも可能です。
@ -183,18 +183,18 @@ fisherman の [organization] や [ウェブサイト] 等で、プラグイン
プラグインとは
1. 普通のディレクトリや、gitレポジトリのrootに、`.fish`ファイルの関数、それか、`functions`ディレクトリに。
1. 普通のディレクトリや、gitレポジトリのrootに、*.fish*ファイルの関数、それか、*functions*ディレクトリに。
2. テーマ。つまり、`fish_prompt.fish`か`fish_right_prompt.fish`か両方。
2. テーマ。つまり、*fish_prompt.fish*か*fish_right_prompt.fish*か両方。
3. スニペット。つまり、1以上の`.fish`ファイルを`conf.d`といディレクトリに。こちらのファイルがフィッシュシェルがスタートする際に実行されます。
3. スニペット。つまり、1以上の*.fish*ファイルを*conf.d*といディレクトリに。こちらのファイルがフィッシュシェルがスタートする際に実行されます。
### 9. 自分のプラグインを、他のプラグインのデペンデンシーにしたい場合は?
プラグイン root ディレクトリの `fishfile` 編集してそのプラグインを追加してください。
プラグイン root ディレクトリの *fishfile* 編集してそのプラグインを追加してください。
```fish
owner/repo
https://github.com/owner/repo
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
```

@ -133,7 +133,7 @@ end
### 2. 어떻게 fish를 기본 shell로 지정하나요?
`/etc/shells` 파일에 있는 shell 목록에 fish를 추가하고, 기본 shell로 지정합니다.
*/etc/shells* 파일에 있는 shell 목록에 fish를 추가하고, 기본 shell로 지정합니다.
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
@ -158,15 +158,15 @@ npm un -g fisherman
### 5. fisherman은 어디에 파일을 두나요?
fisherman 자체는 `~/.config/fish/functions/fisher.fish` 입니다.
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은 `~/.config/fish/fishfile` 위치하며 모든 설치 플러그인의 목록이 담겨있습니다.
fishfile은 *~/.config/fish/fishfile* 위치하며 모든 설치 플러그인의 목록이 담겨있습니다.
fisherman 명령어를 통해 플러그인을 설치/제거하면 자동으로 fishfile이 관리됩니다. 혹은, fishfile에 직접 플러그인을 추가하고 `fisher` 명령어를 입력하면 변경사항이 적용됩니다.
@ -187,18 +187,18 @@ fisherman의 [organization] 페이지를 살펴보거나 [online] 플러그인
플러그인은:
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` 파일들
3. 코드 조각. 예: fish shell 시작시 불러들이게 되는 *conf.d* 디렉토리 안에 위치 한 *.fish* 파일들
### 9. 플러그인 제작시 의존성을 명시하는 방법이 있나요?
작성하는 플러그인 최상단 디렉토리에 `fishfile`를 만들고 의존성을 나열하세요.
작성하는 플러그인 최상단 디렉토리에 *fishfile*를 만들고 의존성을 나열하세요.
```fish
owner/repo
https://github.com/owner/repo
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
```

@ -145,7 +145,7 @@ 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.
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
@ -163,15 +163,15 @@ Sim.
### 5. Onde é que o fisherman guarda as suas coisas?
O fisherman é guardado no ficheiro `~/.config/fish/functions/fisher.fish`.
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.
A cache e a configuração é guardada nos ficheiros *~/.cache/fisherman* e *~/.config/fisherman* respectivamente.
O ficheiro fishfile é guardado em `~/.config/fish/fishfile`.
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.
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.
@ -192,18 +192,18 @@ Visite a [organização] ou use a pesquisa [online] para descobrir os plugins di
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`.
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.
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.
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.
Crie um ficheiro *fishfile* na raiz do seu projecto e adicione ao ficheiros as dependências.
```fish
owner/repo
https://github.com/owner/repo
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
```

@ -144,7 +144,7 @@ end
### 2. Как сделать fish основной командной оболочкой?
Добавьте fish в список командных оболочек `/etc/shells` и сделайте её оболочкой по умолчанию.
Добавьте fish в список командных оболочек */etc/shells* и сделайте её оболочкой по умолчанию.
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
@ -163,15 +163,15 @@ fisher self-uninstall
### 5. Где fisherman хранит данные?
Скрипт fisherman находится в `~/.config/fish/functions/fisher.fish`.
Скрипт fisherman находится в *~/.config/fish/functions/fisher.fish*.
Кэш и настройки плагинов создаются в `~/.cache/fisherman` и `~/.config/fisherman` соответственно.
Кэш и настройки плагинов создаются в *~/.cache/fisherman* и *~/.config/fisherman* соответственно.
fishfile сохраняется в `~/.config/fish/fishfile`.
fishfile сохраняется в *~/.config/fish/fishfile*.
### 6. Что такое fishfile и как я могу его использовать?
В `~/.config/fish/fishfile` хранится список всех установленных плагинов.
В *~/.config/fish/fishfile* хранится список всех установленных плагинов.
fisherman обновляет этот файл автоматически, но вы также можете добавить плагины в список вручную и запустить `fisher`, чтобы эти изменения вступили в силу.
@ -192,18 +192,18 @@ omf/grc
Плагином является:
1. каталог или git репозиторий с файлом `.fish` либо на корневом уровне проекта, либо в директории `functions`
1. каталог или git репозиторий с файлом *.fish* либо на корневом уровне проекта, либо в директории *functions*
2. тема или оформление командной строки, т.е. `fish_prompt.fish`, `fish_right_prompt.fish` или оба файла
2. тема или оформление командной строки, т.е. *fish_prompt.fish*, *fish_right_prompt.fish* или оба файла
3. сниппет, т.е. один или несколько `.fish` файлов в директории `conf.d`, которые загружаются при запуске fish
3. сниппет, т.е. один или несколько *.fish* файлов в директории *conf.d*, которые загружаются при запуске fish
### 9. Как я могу объявить зависимости моего плагина?
Создайте новый `fishfile` в корне вашего проекта со списком зависимостей.
Создайте новый *fishfile* в корне вашего проекта со списком зависимостей.
```fish
owner/repo
https://github.com/owner/repo
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
```

@ -148,8 +148,8 @@ end
### 2. 如何让 fish 作为我默认的 shell ?
Add fish to the list of login shells in `/etc/shells` and make it your default shell.
把 fish 加入到 `/etc/shells` 并令 fish 成为默认 shell。
Add fish to the list of login shells in */etc/shells* and make it your default shell.
把 fish 加入到 */etc/shells* 并令 fish 成为默认 shell。
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
@ -170,13 +170,13 @@ fisher self-uninstall
### 5. fisherman 把数据放到哪里了?
fisherman 的位置在 `~/.config/fish/functions/fisher.fish`
缓存和插件配置被分别存在 `~/.cache/fisherman``~/.config/fisherman`
fishfile 位置在 `~/.config/fish/fishfile`
fisherman 的位置在 *~/.config/fish/functions/fisher.fish*
缓存和插件配置被分别存在 *~/.cache/fisherman**~/.config/fisherman*
fishfile 位置在 *~/.config/fish/fishfile*
### 6. 什么是 fishfile 以及如何使用它?
fishfile `~/.config/fish/fishfile` 列出了所有已安装的插件。
fishfile *~/.config/fish/fishfile* 列出了所有已安装的插件。
fisherman 安装插件时,会自动写入这个文件,或者你可以手动写入你想装的插件,然后运行 `fisher` 来安装插件
@ -197,18 +197,18 @@ omf/grc
一个插件是:
1. 一个目录或者一个在项目根目录有 `.fish` 文件或者 `functions` 目录的git仓库
1. 一个目录或者一个在项目根目录有 *.fish* 文件或者 *functions* 目录的git仓库
2. 一个主题或者命令行提示符,比如 `fish-prompt.fish`, `fish_right_prompt.fish`
2. 一个主题或者命令行提示符,比如 `fish-prompt.fish`, *fish_right_prompt.fish*
3. 一些代码片段,比如一个或多个在 `conf.d`目录下的 `.fish` 文件,并且它们会在 shell 启动时执行。
3. 一些代码片段,比如一个或多个在 *conf.d*目录下的 *.fish* 文件,并且它们会在 shell 启动时执行。
### 9. 如何把这些插件作为我自己插件的依赖?
在项目的顶层目录创建一个新的 `fishfile` 文件,并写下你的依赖。
在项目的顶层目录创建一个新的 *fishfile* 文件,并写下你的依赖。
```fish
owner/repo
https://github.com/owner/repo
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
https://gist.github.com/owner/c256586044fea832e62f02bc6f6daf32
```

Loading…
Cancel
Save