This commit is contained in:
Jorge Bucaran 2016-04-27 01:18:44 +09:00
commit 95dea2204a
No known key found for this signature in database
GPG key ID: E54BA3C0E646DB30
7 changed files with 324 additions and 82 deletions

View file

@ -13,6 +13,7 @@
[日本語]: docs/jp-JA
[한국어]: docs/ko-KR
[Русский]: docs/ru-RU
[Català]: docs/ca-ES
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
@ -21,7 +22,7 @@
fisherman is a concurrent plugin manager for the [fish shell].
Read this document in another language: [Español], [日本語], [简体中文], [한국어], [Русский].
Read this document in another language: [Español], [日本語], [简体中文], [한국어], [Русский], [Català].
## Why?

227
docs/ca-ES/README.md Normal file
View file

@ -0,0 +1,227 @@
[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
[organització]: https://github.com/fisherman
[fish shell]: https://github.com/fish-shell/fish-shell
[fisherman]: http://fisherman.sh
[en línia]: http://fisherman.sh/#search
[English]: ../../README.md
[Español]: docs/es-ES
[简体中文]: docs/zh-CN
[日本語]: docs/jp-JA
[한국어]: docs/ko-KR
[Русский]: docs/ru-RU
[Català]: docs/ca-ES
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish shell plugin manager
fisherman es un gestor de complements concurrent per a la consola de comandes [fish shell].
Llegeix aquest document en un altre llenguatge: [English], [Español], [日本語], [简体中文], [한국어], [Русский].
## Per que?
* Sense configuració
* Sense dependencies externes
* No afecta als temps d'arrencada de la consola de comandes
* Fes-la anar interactivament o _a la_ vundle
* Només l'essencial, instal·lar, actualitzar, esborrar, llistar i ajuda
## Instal·la
Amb curl.
```sh
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
```
Amb npm.
```
npm i -g 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
```
Instal·la des de múltiples fonts.
```
fisher z fzf omf/{grc,thefuck}
```
Instal·la des de una URL.
```
fisher https://github.com/edc/bass
```
Instal·la des de un gist.
```
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
```
Instal·la des de un directori local.
```sh
fisher ~/my_aliases
```
Fes-lo anar a la vundle. Edita el teu arxiu fishfile i executa `fisher` per a aplicar els canvis.
> [Que és un arxiu fishfile i com el faig anar?](#6-que-és-un-arxiu-fishfile-i-com-el-faig-anar)
```sh
$EDITOR fishfile # afegeix complements
fisher
```
Fes un cop d'ull al que tens instal·lat.
```
fisher ls
@ my_aliases # aquest complement esta dins un directori local
* simple # aquest complement es el tema actual
bass
fzf
grc
thefuck
z
```
Actualitza-ho tot.
```
fisher up
```
Actualitza alguns complements.
```
fisher up bass z fzf thefuck
```
Esborra alguns complements.
```
fisher rm simple
```
Esborra tots els complements.
```
fisher ls | fisher rm
```
Aconsegueix ajuda.
```
fisher help z
```
## FAQ
### 1. 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).
```fish
for file in ~/.config/fish/conf.d/*.fish
source $file
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.
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
chsh -s /usr/local/bin/fish
```
### 3. Com des-instal·lo fisherman?
```fish
fisher self-uninstall
```
o
```
npm un -g fisherman
```
### 4. És fisherman compatible amb els temes i complements de oh my fish?
Si.
### 5. On deixa fisherman les seves coses?
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.
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.
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/z
omf/thefuck
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?
Busca dins de l'[organització] o fes anar la busqueda [en línia] per descobrir contingut.
### 8. Que es un complement?
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`
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.
### 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.
```fish
owner/repo
https://github.com/dude/sweet
https://gist.github.com/bucaran/c256586044fea832e62f02bc6f6daf32
```

View file

@ -13,23 +13,24 @@
[日本語]: ../jp-JA
[Русский]: ../ru-RU
[한국어]: ../ko-KR
[Català]: ../ca-ES
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
# [fisherman] - fish shell plugin manager
fisherman es un gestionador de paquetes para el [fish shell] de procesamiento en paralelo.
fisherman es un gestor de paquetes para la consola de comandos [fish shell] con procesamiento en paralelo.
Lee este documento en otro idioma: [English], [日本語], [简体中文], [한국어], [Русский].
Lee este documento en otro idioma: [English], [日本語], [简体中文], [한국어], [Русский], [Català].
## Motivo
## Por que?
* Sin configuración
* Sin dependencias externas
* No influye en el tiempo de inicio de la sesión
* No afecta al tiempo de inicio de la sesión
* Se puede utilizar de manera interactiva o _a la_ vundle
@ -49,52 +50,52 @@ Via npm.
npm i -g fisherman
```
## Uso
## Modo de uso
Instala paquetes.
Instalar paquetes.
```
fisher simple
```
Instala de múltiples fuentes.
Instalar desde múltiples fuentes.
```
fisher z fzf omf/{grc,thefuck}
```
Instala URLs.
Instalar desde URLs.
```
fisher https://github.com/edc/bass
```
Instala gists.
Instalar desde gists.
```
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
```
Instala un directorio.
Instalar desde un directorio.
```sh
fisher ~/my_aliases
```
A la vundle. Edita el fishfile y entra `fisher` para satisfacer los cambios.
A la vundle. Edita el archivo fishfile y ejecuta `fisher` para aplicar los cambios.
> [¿Qué es el fishfile y cómo lo utilizo?](#6-qué-es-el-fishfile-y-cómo-lo-uso)
> [¿Qué es el archivo fishfile y cómo lo utilizo?](#6-qué-es-el-fishfile-y-cómo-lo-uso)
```sh
$EDITOR fishfile # añade paquetes
$EDITOR fishfile # añade los paquetes como dependencias
fisher
```
Muestra que es instalado actualmente.
Muestra que tienes instalado actualmente.
```
fisher ls
@ my_aliases # este paquete es un directorio
@ my_aliases # este paquete esta en un directorio
* simple # este paquete es el tema actual
bass
fzf
@ -103,7 +104,7 @@ fisher ls
z
```
Actualiza todo.
Actualizalo todo.
```
fisher up
@ -135,9 +136,9 @@ fisher help z
## FAQ
### 1. ¿Qué versión de fish se requiere?
### 1. ¿Qué versión de fish es necesaria?
fisherman fue diseñado para fish >= 2.3.0. Si estás en 2.2.0 y no puedes actualizarte por algún motivo, añade este código a `~/.config/fish/config.fish` para poder ejecutar [snippets](#8-qué-es-un-paquete).
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).
```fish
for file in ~/.config/fish/conf.d/*.fish
@ -145,9 +146,9 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. ¿Cómo hago fish mi shell por defecto?
### 2. ¿Cómo hago fish mi consola de comandos por defecto?
Añade fish a la lista de login shells in `/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
@ -156,13 +157,13 @@ chsh -s /usr/local/bin/fish
### 3. ¿Cómo puedo desinstalar fisherman?
Entra
Ejecuta
```fish
fisher self-uninstall
```
or
o
```fish
npm un -g fisherman
@ -172,19 +173,19 @@ npm un -g fisherman
Sí.
### 5. ¿Dónde guarda fisherman las cosas?
### 5. ¿Dónde guarda fisherman sus cosas?
fisherman mismo va en `~/.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 fishfile en `~/.config/fish/fishfile`.
El archivo fishfile en `~/.config/fish/fishfile`.
### 6. ¿Qué es el fishfile y cómo lo uso?
### 6. ¿Qué es el archivo fishfile y cómo lo uso?
El fishfile `~/.config/fish/fishfile` registra 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 ingresar los paquetes que requieres y entrar `fisher` para satisfacer los cambios.
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
@ -193,25 +194,25 @@ omf/thefuck
omf/grc
```
Este mecanismo solo instala paquetes y dependecias necesarias. Para remover paquetes, usa `fisher rm`.
Este comando solo instala paquetes y sus dependencias. Para borrar paquetes, usa `fisher rm`.
### 7. ¿Dónde consigo las lista de paquetes para fish?
### 7. ¿Dónde consigo un listado de paquetes para fish?
Diríjete a la [organización] o usa la búsqueda [en línea] para descrubir contenido.
Dirígete a la [organización] o usa la búsqueda [en línea] para descubrir contenido.
### 8. ¿Qué es un paquete?
Un paquete es:
1. un directorio o repositorio de git con una función / archivo `.fish` bien sea en el nivel 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.
3. un snippet, es decir, uno o más archivos `.fish` en un directorio llamado `conf.d` que son ejecutados por fish al inicio de 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 `fishfile` en el nivel raíz de tu proyecto y escribe los paquetes.
Crea un archivo `fishfile` en la carpeta raíz de tu plugin y incluye los paquetes en el.
```fish
owner/repo

View file

@ -13,6 +13,7 @@
[简体中文]: ../zh-CN
[Русский]: ..//ru-RU
[한국어]: ../ko-KR
[Català]: ../ca-ES
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
@ -21,7 +22,7 @@
fisherman とは フィッシュシェルのための並列処理パッケージマネージャーです。
翻訳: [English], [Español], [简体中文], [한국어], [Русский].
翻訳: [English], [Español], [简体中文], [한국어], [Русский], [Català].
## 理由

View file

@ -13,6 +13,7 @@
[简体中文]: ../zh-CN
[日本語]: ../jp-JA
[Русский]: ../ru-RU
[Català]: ../ca-ES
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
@ -21,7 +22,7 @@
fisherman은 [fish shell]을 위한 병렬 처리 플러그인 매니저 입니다.
다른 언어로 읽기: [English], [Español], [日本語], [简体中文], [Русский].
다른 언어로 읽기: [English], [Español], [日本語], [简体中文], [Русский], [Català].
## 왜 fisherman을 사용해야 하죠?

View file

@ -14,6 +14,7 @@
[日本語]: ../jp-JA
[Русский]: ../ru-RU
[한국어]: ../ko-KR
[Català]: ../ca-ES
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
@ -22,37 +23,43 @@
fisherman это параллельный менеджер плагинов для [fish shell].
Прочитать этот документ на другом языке: [English], [Español], [日本語], [简体中文], [한국어].
Прочитать этот документ на другом языке: [English], [Español], [日本語], [简体中文], [한국어], [Català].
## Почему?
## Достоинства fisherman
* Нет конфигурации
* Не нужно настраивать
* Нет внешних зависимостей
* Не влияет на время старта оболочки
* Не влияет на время запуска оболочки
* Использовать его в интерактивном режиме или _a la_ vundle
* Можно использовать в интерактивном режиме или а-ля vundle
* Только самое необходимое: установить, обновить, удалить, список и помощь
* Только необходимые функции: установка, обновление, удаление, список установленного и справка
## Установка
C curl.
Используя curl:
```sh
curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
```
C npm.
Используя npm:
```sh
npm i -g fisherman
```
Если вы ещё используете версию 1.5 и хотите обновиться до >2.0 без особых хлопот:
```
curl -L git.io/fisher-up-me | fish
```
## Использование
Установите плагин.
Установка отдельного плагина.
```
fisher simple
@ -64,39 +71,39 @@ fisher simple
fisher z fzf omf/{grc,thefuck}
```
Установить из URL.
Установка по ссылке URL.
```
fisher https://github.com/edc/bass
```
Установить из gist.
Установка из gist.
```
fisher https://gist.github.com/username/1f40e1c6e0551b2666b2
```
Установить из локального каталога.
Установка из локального каталога.
```sh
fisher ~/my_aliases
```
Использовать в интерактивном-режиме. Редактировать fishfile и запустить `fisher`, чтобы удовлетворить изменения.
Использование в интерактивном-режиме. Отредактируйте fishfile и запустите `fisher`, чтобы изменения вступили в силу.
> [Что такое fishfile и как я могу его использовать?](#6-Что-такое-fishfile-и-как-я-могу-его-использовать)
```sh
$EDITOR fishfile # добавить плагины
$EDITOR fishfile # добавьте плагины
fisher
```
Посмотреть, что установлено.
Просмотр установленных плагинов.
```
fisher ls
@ my_aliases # этот плагин представляет собой локальный каталог
* simple # этот плагин является текущим приглашением
* simple # этот плагин является текущим оформлением командной строки
bass
fzf
grc
@ -104,31 +111,31 @@ fisher ls
z
```
Обновить все.
Обновление всего сразу.
```
fisher up
```
Обновление некоторых плагинов.
Обновление отдельных плагинов.
```
fisher up bass z fzf thefuck
```
Удалить плагины.
Удаление плагинов.
```
fisher rm simple
```
Удалить все плагины.
Удаление всех плагинов.
```
fisher ls | fisher rm
```
Получить помощь.
Справка по плагину.
```
fisher help z
@ -138,7 +145,7 @@ fisher help z
### 1. Какая версия fish необходима?
fisherman был построен для рыб >= 2.3.0. Если вы используете 2.2.0, добавьте следующий код в ваш `~/.config/fish/config.fish` для [сниппет](#8-Что-такое-плагин) поддержки.
fisherman был разработан для fish >= 2.3.0. Если вы используете 2.2.0, добавьте следующий код в ваш `~/.config/fish/config.fish` для поддержки [cниппетов](#8-Что-такое-плагин).
```fish
for file in ~/.config/fish/conf.d/*.fish
@ -146,9 +153,9 @@ for file in ~/.config/fish/conf.d/*.fish
end
```
### 2. Как мне установить fish на ОС х?
### 2. Как сделать fish основной командной оболочкой?
Add fish to the list of login shells in `/etc/shells` and make it your default shell.
Добавьте fish в список командных оболочек `/etc/shells` и сделайте её оболочкой по умолчанию.
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
@ -157,8 +164,6 @@ chsh -s /usr/local/bin/fish
### 3. Как мне удалить fisherman?
Запустить
```fish
fisher self-uninstall
```
@ -169,23 +174,23 @@ fisher self-uninstall
npm un -g fisherman
```
### 4. Совместим fisherman с oh my fish темами и плагины?
### 4. Совместим ли fisherman с темами и плагинами oh my fish?
Да.
### 5. Почему так положил 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` выводит список всех установленных плагинов.
В `~/.config/fish/fishfile` хранится список всех установленных плагинов.
Вы можете позволить fisherman сохранить этот файл для вас автоматически, или оставить в плагины и запустить `fisher`, чтобы удовлетворить эти изменения.
fisherman обновляет этот файл автоматически, но вы также можете добавить плагины в список вручную и запустить `fisher`, чтобы эти изменения вступили в силу.
```
fisherman/simple
@ -194,25 +199,25 @@ omf/thefuck
omf/grc
```
Этот механизм устанавливает только плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте `fisher rm` вместо этого.
Этот механизм только устанавливает плагины и отсутствующие зависимости. Чтобы удалить плагин, используйте `fisher rm`.
### 7. Где я могу найти список fish плагинов?
### 7. Где я могу найти список плагинов для fish?
Используя поиск в [организации] или [онлайн] поиск для изучения содержимого.
Используйте поиск по Github [организации] или [онлайн] поиск на сайте.
### 8. Что такое плагин?
Плагин является:
Плагином является:
1. каталог или git repo с функцией `.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. Как я могу получит список плагинов в качестве зависимостей для моего плагина?
### 9. Как я могу объявить зависимости моего плагина?
Создать новый файл `fishfile` в корневом каталоге вашего проекта и записи в зависимости плагин.
Создайте новый `fishfile` в корне вашего проекта со списком зависимостей.
```fish
owner/repo

View file

@ -13,6 +13,7 @@
[日本語]: ../jp-JA
[Русский]: ../ru-RU
[한국어]: ../ko-KR
[Català]: ../ca-ES
[![Build Status][travis-badge]][travis-link]
[![Slack][slack-badge]][slack-link]
@ -21,13 +22,13 @@
fisherman 是一款零配置,并发的 [fish shell] 插件管理器。
选择不同语言版本的文档: [Español], [日本語], [English], [한국어], [Русский]。
选择不同语言版本的文档: [Español], [日本語], [English], [한국어], [Русский], [Català]
##为什么使用fisherman
* 零配置
* 依赖
* 没有其他依赖
* 不影响 shell 启动速度
@ -45,10 +46,15 @@ curl -Lo ~/.config/fish/functions/fisher.fish --create-dirs git.io/fisherman
使用npm。
```
```sh
npm i -g fisherman
```
如果你仍然在使用 fisherman 1.5 并且想轻松升级到 2.0以上, 可以执行以下命令
```sh
curl -L git.io/fisher-up-me | fish
```
## 功能
安装插件。