Spanish translation for Documentation (#724)

This commit is contained in:
Victorhck 2020-02-17 05:22:59 +01:00 committed by GitHub
parent 6b2ce5ca80
commit 6adc397b75
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
8 changed files with 470 additions and 1 deletions

View File

@ -13,6 +13,7 @@ Oh My Fish provides core infrastructure to allow you to install packages which e
> <a href="docs/zh-CN/README.md">🇨🇳</a>
> <a href="docs/uk-UA/README.md">🇺🇦</a>
> <a href="docs/pt-BR/README.md">🇧🇷</a>
> <a href="docs/es-ES/README.md">🇪🇸</a>
<br>

94
docs/es-ES/FAQ.md Normal file
View File

@ -0,0 +1,94 @@
<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="128px" height="128px"/>
<img align="left" width="0" height="128px"/>
# FAQ
> La documentación de Oh My Fish&nbsp;&bull;&nbsp;También disponible en
> <a href="../en-US/FAQ.md">🇺🇸</a>
> <a href="../ru-RU/FAQ.md">🇷🇺</a>
> <a href="../zh-CN/FAQ.md">🇨🇳</a>
> <a href="../uk-UA/FAQ.md">🇺🇦</a>
> <a href="../pt-BR/FAQ.md">🇧🇷</a>
<br>
Gracias por dedicar tiempo para leer este apartado de preguntas frecuentes (FAQ). Siéntete libre de crear un nuevo _issue_ si su pregunta no está respondida
en este documento.
## ¿Qué es Oh My Fish y por qué lo quiero?
Oh My Fish es un _framework_ para [Fishshell](http://fishshell.com/). Le ayudará a gestionar su configuración, los temas y paquetes.
## ¿Qué necesito conocer para utilizar Oh My Fish?
_Nada_. Puede instalar Oh My Fish y seguir utilizando Fish de manera normal. Cuando este listo para aprender más simplemente escriba en la línea de comandos `omf help`.
## ¿Qué son los paquetes Oh My Fish?
Los paquetes Oh My Fish son temas o complementos escritos en fish que expanden las funcionalidades principales de la _shell_, ejecutan código durante la
inicialización, añaden auto completado para las utilidades más conocidas, etc.
## ¿Qué tipos de paquetes Oh My Fish existen?
Existen aproximadamente 3 tipos de paquetes:
1. Utilidades de configuración. Por ejemplo [`pkg-pyenv`](https://github.com/oh-my-fish/pkg-pyenv) comprueba si `pyenv` existe en su sistema y ejecuta
`(pyenv init - | psub)` por usted durante el arranque.
2. Temas. Echa un vistazo a nuestra [galería de temas](https://github.com/oh-my-fish).
3. Utilidades tradicionales para la _shell_. Por ejemplo [`pkg-copy`](https://github.com/oh-my-fish/pkg-copy), una utilidad de portapapeles compatible con
sistemas Linux and OSX.
## ¿Qué hace Oh My Fish exactamente?
+ Ejecuta `$OMF_CONFIG/before.init.fish` si está disponible.
+ Carga de manera automática los paquetes y temas instalados en la ruta `$OMF_PATH/`.
+ Carga de manera automática su ruta de configuración. `~/.config/omf` de manera predeterminada, pero configurable mediante `$OMF_CONFIG`.
+ Carga de manera automática cualquier directorio `functions` de las rutas `$OMF_PATH` y `$OMF_CONFIG`
+ Ejecuta `$OMF_CONFIG/init.fish` si está disponible.
## ¿Cómo puedo actualizar una instalación de Oh My Fish ya existente?
> :warning: Recuerde realizar primero una copia de seguridad de sus archivos de configuración (o _dotfiles_) y otros datos importantes.
```
curl -L github.com/oh-my-fish/oh-my-fish/raw/master/bin/install | sh
```
Ahora puede eliminar con seguridad `$fish_path`.
```fish
rm -rf "$fish_path"
```
## ¿Cómo utilizo fish como mi _shell_ predeterminada?
Añada Fish a `/etc/shells`:
```sh
echo "/usr/local/bin/fish" | sudo tee -a /etc/shells
```
Haga que Fish sea su _shell_ predeterminada:
```sh
chsh -s /usr/local/bin/fish
```
Para volver a tener como predeterminada la _shell_ que utilizaba anteriormente:
> En el siguiente comando sustituya `/bin/bash` con `/bin/tcsh` o `/bin/zsh` según sea lo apropiado en su caso.
```sh
chsh -s /bin/bash
```

144
docs/es-ES/Packages.md Normal file
View File

@ -0,0 +1,144 @@
<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="128px" height="128px"/>
<img align="left" width="0" height="128px"/>
# Paquetes
> La documentación de Oh My Fish&nbsp;&bull;&nbsp;También disponible en
> <a href="../en-US/Packages.md">🇺🇸</a>
> <a href="../ru-RU/Packages.md">🇷🇺</a>
> <a href="../zh-CN/Packages.md">🇨🇳</a>
> <a href="../uk-UA/Packages.md">🇺🇦</a>
> <a href="../pt-BR/Packages.md">🇧🇷</a>
<br>
# Creando
Para aprender en la creación de paquetes, vamos a crear un nuevo paquete que mostrará un comando `hello_world` para su _shell_. Los nombres de los paquetes
solo pueden contener letras minúsculas y guiones para separar palabras.
Oh My Fish puede crear el esqueleto de una estructura de un paquete para usted. Para ello utilice el comando `omf new`:
```fish
$ omf new plugin hello_world
```
> Utilice `omf new theme my_theme_name` para crear un nuevo tema.
La utilidad cambia el directorio actual al paquete recién creado:
```
$ ls -l
README.md
init.fish
functions/hello_world.fish
completions/hello_world.fish
```
>Proporcione siempre una descripción de cómo funciona su paquete en un archivo `README.md`.
>Lea más sobre [auto completado](http://fishshell.com/docs/current/commands.html#complete) y tenga en cuenta el incluirlo para sus utilidades cuando sea
>aplicable.
`functions/hello_world.fish` define una única función:
```fish
function hello_world -d "Prints hello world"
echo "Hello World!"
end
```
Cada función en su paquete debe ser declarada en su propio archivo en el directorio `functions`. Esto es necesario para el mecanismo de carga automática de
fish, que carga funciones bajo demanda, evitando funciones no utilizadas durante el tiempo de arranque.
Tenga en cuenta que fish no tiene un ámbito privado, así que si necesita dividir su paquete en funciones, evite conflictos de nombres utilizando como
prefijo de las funciones algo único, como el nombre dle paquete (por ejemplo: `hello_world_print_help`). Para evitar el contaminado de nombres de comandos,
considere utilizar como prefijo de funciones privadas dos guiones bajos (e.g. `__function_name_print_help`).
# Hooks
Oh My Fish ofrece un sistema de "hooks" que le permite escribir scripts para su paquete que son ejecutados cuando ocurre otro evento interesante. Los
paquetes puede utilizar estos _hooks_ para ofrecer una instalación avanzada, una gestión de recursos personalizada, etc. Los _hooks_ son scripts normales de
Fish nombrados después del evento por el que son lanzados. La mayoría de _hooks_ se encuentran en un directorio `hooks` dentro del directorio del proyecto
del paquete.
>Los _hooks_ que son llamados después del tiempo de arranque (`init.fish` y `key_bindings.fish`) pueden ralentizar el arranque de la _shell_. ¡Asegúrese de
>evitar utilizar código lento en el proceso de arranque! También, si su paquete no necesita de un archivo hook, asegúrese de eliminarlo.
El directorio de trabajo dentro de un hook está siempre establecido en la raíz del directorio del paquete. Los hooks Oh My Fish actualmente admitidos están
listados a continuación:
## `init`
El hook `init` se ejecuta la primera vez que la shell se carga. Los scripts que utilicen este hook deberían estar ubicados en `init.fish` en la raíz del
directorio del paquete.
Dentro de este hook, puede acceder a tres variables relacionadas con el paquete:
* `$package`: Nombre del paquete
* `$path`: Ruta de instalación del paquete
* `$dependencies`: Dependencias del paquete
Por ejemplo, con un script `init.fish` que contenga el siguiente código:
```fish
echo "hello_world initialized"
```
verá la línea `hello_world initialized` en la parte superior de la terminal cuando sea abierta por primera vez.
Utilice este hook para modificar el entorno, cargar recursos, cargar de manera automática funciones, etc. Si su paquete no exporta ninguna función, todavía
puede utilizar este evento para añadir funcionalidades a su paquete, o de manera dinámica crear funciones.
## `key_bindings`
Si su paquete o sistema utiliza atajos de teclado, asegúrese de establecerlos en el hook `key_bindings`. El script del atajo de teclado debe estar ubicado
en `key_bindings.fish` en la raíz del directorio del paquete. En este hook puede utilizar libremente el comando [`bind`][fish-bind] para definir los atajos
de teclado personalizados.
>¡Los temas también pueden definir atajos de teclado! Oh My Fish volverá a cargar los atajos de teclado cuando cambie entre los temas.
## `install`
El hook `install` es lanzado cuando un paquete es instalado por primera vez. Los scripts para este hook deberán estar ubicados en `hooks/install.fish`.
Dentro de este hook, puede acceder a dos variables relacionadas con el paquete:
* `$package`: Nombre del paquete
* `$path`: Ruta de instalación del paquete
Este hook es útil para descargar recursos adicionales, configurar submódulos de Git o instalar dependencias de terceros como scripts de Bash.
## `update`
Como puede haber adivinado, el hook `update` es lanzado por un paquete después de haber sido actualizado. Los scripts para este hook deberán estar ubicados en `hooks/update.fish`.
Dentro de este hook, puede acceder a dos variables relacionadas con el paquete:
* `$package`: Nombre del paquete
* `$path`: Ruta de instalación del paquete
Este hook es útil para actualizar submódulos de Git o para comprobar si existen nuevas versiones para dependencias de terceros.
## `uninstall`
El hook `uninstall` será lanzado antes de que un paquete sea eliminado mediante `omf remove <pkg>`. Los scripts para este hook deberán estar ubicados en `hooks/uninstall.fish`.
Dentro de este hook, puede acceder a dos variables relacionadas con el paquete:
* `$package`: Nombre del paquete
* `$path`: Ruta de instalación del paquete
Los paquetes pueden utilizar este hook para limpiar recursos personalizados, etc.
> Nota: para mantener la compatibilidad con versiones anteriores, los hooks uninstall también serán ejecutados si están ubicados en `uninstall.fish` en la
> raíz del paquete.
# Hágalo público
El registro oficial de paquetes públicos es gestionado en el repositorio [oh-my-fish/packages-main](https://github.com/oh-my-fish/packages-main). Vea el
archivo README de ese repositorio para encontrar instrucciones de cómo añadir su paquete a la base de datos oficial de paquetes.
[fish-bind]: http://fishshell.com/docs/current/commands.html#bind
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls

227
docs/es-ES/README.md Normal file
View File

@ -0,0 +1,227 @@
<img src="https://cdn.rawgit.com/oh-my-fish/oh-my-fish/e4f1c2e0219a17e2c748b824004c8d0b38055c16/docs/logo.svg" align="left" width="192px" height="192px"/>
<img align="left" width="0" height="192px" hspace="10"/>
> El _framework_ de <a href="http://fishshell.com">Fishshell</a>
[![MIT License](https://img.shields.io/badge/license-MIT-007EC7.svg?style=flat-square)](/LICENSE) [![Fish Shell Version](https://img.shields.io/badge/fish-≥v2.2.0-007EC7.svg?style=flat-square)](http://fishshell.com) [![Travis Build Status](http://img.shields.io/travis/oh-my-fish/oh-my-fish.svg?style=flat-square)](https://travis-ci.org/oh-my-fish/oh-my-fish) [![Slack Status](https://oh-my-fish-slack.herokuapp.com/badge.svg)](https://oh-my-fish-slack.herokuapp.com)
Oh My Fish ofrece la infraestructura básica para permitirle instalar paquetes que extiendan o modifiquen el aspecto de su _shell_. Es rápido, extensible y
sencillo de utilizar.
> También disponible en&nbsp;
> <a href="../en-US/FAQ.md">🇺🇸</a>
> <a href="docs/ru-RU/README.md">🇷🇺</a>
> <a href="docs/zh-CN/README.md">🇨🇳</a>
> <a href="docs/uk-UA/README.md">🇺🇦</a>
> <a href="docs/pt-BR/README.md">🇧🇷</a>
<br>
## Índice de contenidos
* [Instalación](#instalación)
* [Comenzando (descripciones de los comandos)](#comenzando)
* [Avanzado](#avanzado)
* [Inicio](#inicio)
* [Archivos de configuración (Dotfiles)](#dotfiles)
* [Creando paquetes](#creando-paquetes)
## Instalación
Puede comenzar de inmediate con la configuración predeterminada ejecutando lo siguiente en su terminal:
```fish
curl -L https://get.oh-my.fish | fish
```
Esto descargará el script instalador y comenzará la instalación. De manera alternativa, puede descargar el instalador y personalizar su instalación:
```fish
curl -L https://get.oh-my.fish > install
fish install --path=~/.local/share/omf --config=~/.config/omf
```
Puede verificar la integridad del instalador descargado comprobando el script con esta [suma de verificación](bin/install.sha256):
```
434264c56e3a7bb74733d9b293d72403c404e0a0bded3e632433d391d302504e install
```
También puede insatalar Oh My Fish mediante Git o con un archivo tarball descargado desde la [página de publicaciones][releases]:
```fish
# with git
$ git clone https://github.com/oh-my-fish/oh-my-fish
$ cd oh-my-fish
$ bin/install --offline
# with a tarball
$ curl -L https://get.oh-my.fish > install
$ fish install --offline=omf.tar.gz
```
Ejecute `install --help` para obtener una lista completa de opciones de instalación que puede personalizar.
#### Requisitos
- **fish** shell, versión 2.2 o posterior
- **git**, versión 1.9.5 o posterior
#### Problemas conocidos
- Debido a un error de regresión en fish 2.6 con algunos emuladores de terminal, los prompts a la derecha hace que la shell no se pueda utilizar.
El tema OMF's `default` ofrece un prompt a la derecha, así que es necesario utilizar untema alternativo hasta que se publique una solción.
(ver [#541](https://github.com/oh-my-fish/oh-my-fish/issues/541))
## Comenzando
Oh My Fish incluye una pequeña utilidad `omf` para extraer e instalar nuevos paquetes y temas.
#### `omf update` _`[omf]`_ _`[<paquete>...]`_
Actualiza Oh My Fish, todos los paquetes de los repositorios y todos los paquetes instalados.
- Cuando es llamado sin argumentos, actualiza el núcleo y todos los paquetes instalados.
- Puede escoger actualizar sólo el núcleo, ejecutando `omf update omf`.
- Para una actualización selectiva de paquetes, escriba solo los paquetes que desea actualizar. Debería incluir "omf" en la lista para actualizar también el
núcleo.
#### `omf install` _`[<nombre>|<url>]`_
Instala uno _o más_ paquetes.
- Puede instalar paquetes directamente con la URL mediante `omf install URL`
- Cuando es ejecutado sin argumentos, instala paquetes perdios desde [bundle](#dotfiles).
#### `omf repositories` _`[list|add|remove]`_
Gestiona los paquetes de los repositorios instalados por el usuario. Los paquetes de los repositorios son de donde los paquetes provienen utilizando
comandos como `omf install`. De manera predeterminada el [repositorio oficial](https://github.com/oh-my-fish/packages-main) está siempre instalado y
disponible.
#### `omf list`
Lista los paquetes instalados.
#### `omf theme` _`<tema>`_
Aplica un tema. Para listar los temas disponibles, escriba `omf theme`. También puede [previsualizar los temas disponibles](../Themes.md) antes de
instalarlos.
#### `omf remove` _`<nombre>`_
Elimina un tema o paquete.
> Los paquetes pueden utilizar _hooks_ al desinstalarlos, así que una limpieza de recursos personalizado puede ejecutarse cuando se desinstalen. Ver
> [Desinstalar](/docs/es-ES/Packages.md#uninstall) para más información.
#### `omf reload`
Vuelve a cargar Oh My Fish y todos los complementos utilizando `exec` para reemplazar el proceso shell actual con uno nuevo.
> Este comando intenta ser lo más seguro posible, mitigando efectos colaterales cauados por `exec` y prevenir la recarga en el caso de procesos en segundo
> plano.
#### `omf new plugin | theme` _`<nombre>`_
Crea un esqueleto para un nuevo complemento o tema.
> Esto crea un nuevo directorio en `$OMF_CONFIG/{pkg | themes}/` con una plantilla.
#### `omf search` _`-t|--theme / -p|--package`_ _`<nombre>`_
Busca en la base de datos de Oh My Fish un paquete en concreto, tema o ambos. También soporta una búsqueda menos explícita, así que si no está seguro del
nombre simplemente ejecute `omf search simple`.
#### `omf channel`
Obtiene o cambia el canal de actualización.
De manera predeterminada existen dos canales: el canal `stable` ofrece actualizaciones estables con las versión más recientes de Oh My Fish, y `dev` que
ofrece los últimos cambios en desarrollo. El canal de actualización actual determina a qué versión de `omf update` se actualizará.
#### `omf doctor`
Utilizar para diagnosticar un error antes de [abrir un _issue_][omf-issues-new].
#### `omf destroy`
Desinstala Oh My Fish.
## Avanzado
El instalador de Oh My Fish añade un fragmento a los archivos de configuración de fish del usuario (`~/.config/fish/conf.d/`) que llama al código de
arranque de OMF.
Tenga en cuenta que los scripts en ese directorio se ofrecen en el orden en el que el sistema de archivos los ve, y quizás puede ser necesario añadir un
prefijo a su script con números para ordenarlos.
Por ejemplo: `a_script.fish` tendrá preferencia sobre el fragmento `omf.fish`.
Así que si `a_script.fish` depende de complementos gestionados por OMF, considere renombrar el archivo del script a `xx_a_script.fish`.
De manera similar, para asegurarse que un script se ejecuta antes de `omf.fish`, debería añadirle el prefijo `00_`.
De manera alternativa también se puede utilizar `~/.config/omf/before.init.fish`.
### Inicio
Cada vez que abre una nueva shell, el código de inicio inicializa la ruta de instalación y la ruta de configuración de Oh My Fish (`~/.config/omf` de manera
predeterminada), ejecutando el script [`init.fish`](init.fish) posteriormente, que carga de manera automática los paquetes, temas y sus ficheros
personalizados de inicio.
Para más información puede consultar la sección de preguntas frecuentes [FAQ](FAQ.md#qué-hace-oh-my-fish-exactamente).
### Archivos de configuración (Dotfiles)
El directorio `$OMF_CONFIG` representa el estado del usuario de Oh My Fish. Es el perfecto candidato para ser añadido a sus archivos de configuración o
_dotfiles_ y/o añadirlo a un control de versiones como puede ser Git. Allí se pueden encontrar tres archivos importantes:
- __`theme`__ - El tema actual
- __`bundle`__ - Lista de los temas/paquetes actualmente instalados
- __`channel`__ - El canal desde el cual OMF descarga las actualizaciones (estable / dev)
Y puede crear o personalizar esos archivos especiales:
- __`init.fish`__ - Script personalizado que se ejecuta después del arranque de la shell
- __`before.init.fish`__ - Script personalizado que se ejecuta antes del arranque de la shell
- __`key_bindings.fish`__ - Atajos de teclado personalizados donde puede utilizar el comando `bind` de manera libre
#### Configurando variables en `init.fish`
Uno de los usos más comunes utilizados en `init.fish` es la definición de variables. Seguramente, para variables que necesitan estar disponible en cualquier
sesión de la shell. Para conseguir esto, es necesario definirlas de manera global. Por ejemplo:
```fish
# Los desarrolladore de Golang quizás necesitan esto
set -xg GOPATH $HOME/gocode
# En cambio los desarrolladores de Python
set -xg PYTHONDONTWRITEBYTECODE 1
```
#### Acerca de bundle
Cada vez que un paquete/tema es instalado o eliminado, el archivo `bundle` es actualizado. También puedes editarlo manualmente y después ejecutar `omf
install` para tomar en cuenta los cambios realizados. Por favor tenga en cuenta que mientras que los paquetes/temas añadidos a _bundle_ son automáticamente
instalados, un paquete/tema eliminado de _bundle_ no es eliminado de la instalación del usuario.
#### Versiones antiguas de fish
En fish 2.2, no existe el directorio `conf.d`, así que el código de inicio tiene que ser ubicado en el archivo de configuración de fish (`~/.config/fish/config.fish`).
Es altamente recomendado que los comandos personalizados de inicio estén en el archivo `init.fish` en vez de en `~/.config/fish/config.fish`, ya que esto le
permite mantener todo el directorio `$OMF_CONFIG` bajo un servicio de control de versiones.
Si necesita ejecutar comandos de inicio que sean ejecutados *antes* de que Oh My Fish comience a cargar complementos, ubiquelos en `before.init.fish`. Si no
está seguro, normalmente es mejor poner las cosas en `init.fish`.
## Creando paquetes
Oh My Fish utiliza una avanzada y bien definida arquitectura de desarrollo de complementos, incluyendo _hooks_ de inicialización/instalación, carga
automática de funciones. [Ver la documentación de paquetes](Packages.md) para más detalles.
[fishshell]: http://fishshell.com
[colaboradores]: https://github.com/oh-my-fish/oh-my-fish/graphs/contributors
[omf-pulls-link]: https://github.com/oh-my-fish/oh-my-fish/pulls
[omf-issues-new]: https://github.com/oh-my-fish/oh-my-fish/issues/new
[publicaciones]: https://github.com/oh-my-fish/oh-my-fish/releases

View File

@ -14,7 +14,7 @@ O Oh My Fish fornece infra-estrutura básica para permitir que você instale pac
> <a href="../ru-RU/README.md">🇷🇺</a>
> <a href="../zh-CN/README.md">🇨🇳</a>
> <a href="../uk-UA/README.md">🇺🇦</a>
> <a href="../es-ES/README.md">🇪🇸</a>
<br>

View File

@ -12,6 +12,7 @@ Oh My Fish обеспечивает базовую инфраструктуру,
> <a href="../zh-CN/README.md">🇨🇳</a>
> <a href="../uk-UA/README.md">🇺🇦</a>
> <a href="../pt-BR/README.md">🇧🇷</a>
> <a href="../es-ES/README.md">🇪🇸</a>
<br>

View File

@ -12,6 +12,7 @@ Oh My Fish надає базову інфраструктуру, щоб забе
> <a href="../zh-CN/README.md">🇨🇳</a>
> <a href="../ru-RU/README.md">🇷🇺</a>
> <a href="../pt-BR/README.md">🇧🇷</a>
> <a href="../es-ES/README.md">🇪🇸</a>
<br>

View File

@ -12,6 +12,7 @@ Oh My Fish 提供核心基础设施的配置,允许每个人可以轻松安装
> <a href="../ru-RU/README.md">🇷🇺</a>
> <a href="../uk-UA/README.md">🇺🇦</a>
> <a href="../pt-BR/README.md">🇧🇷</a>
> <a href="../es-ES/README.md">🇪🇸</a>
<br>