Merge pull request #2107 from MottiniMauro/patch-1

Update libraries index.md (es)

Author: gfvcastro

es/libraries/index.md

@@ -4,114 +4,105 @@ title: "Bibliotecas"
 lang: es
 ---
 
-{% include out-of-date.html %}
+Como la mayoría de los lenguajes de programación, Ruby aprovecha un amplio conjunto de bibliotecas.
+{: .summary}
+
+Casi todas estas bibliotecas se lanzan en forma de **gema**, una biblioteca o aplicación empaquetada que se puede instalar con una herramienta llamado [**RubyGems**] [1].
+
+RubyGems es un sistema de empaquetado de Ruby diseñado para facilitar la creación, el intercambio y la instalación de bibliotecas (de alguna manera, es un sistema de empaquetado similar a `apt-get`, pero dirigido a Ruby).
+Ruby viene con RubyGems por defecto desde la versión 1.9, las versiones anteriores de Ruby requieren que RubyGems esté [instalado a mano] [2].
 
-Existen fascinantes, útiles y variadas bibliotecas para Ruby, muchas
-disponibles como un conveniente archivo *gem*. Otras bibliotecas son
-liberadas como directorios comprimidos (.zip o .tar.gz) de código
-fuente. Veamos cómo encontrar e instalar bibliotecas para que puedas
+Otras bibliotecas se publican como directorios archivados (.zip o .tar.gz) de **código fuente**. Los procesos de instalación pueden variar, pero normalmente un archivo `README` o `INSTALL` se encuentra disponible con instrucciones.
+
+Veamos cómo encontrar e instalar bibliotecas para que puedas
 utilizarlas.
-{: .summary}
 
-### Encontrando bibliotecas
+### Buscando bibliotecas
 
-[**RubyGems**][1] es la herramienta preferida por la comunidad para
-distribuir código. Por lo general, las gemas tienen enlaces hacia la
-documentación e información sobre los desarrolladores, así que es un
-buen punto de partida para comenzar a explorar el mundo Ruby.
+El lugar principal donde se alojan las bibliotecas es [**RubyGems.org**] [1], un repositorio público de gemas que se pueden buscar e instalar en su máquina.
+Puede buscar gemas utilizando el sitio web RubyGems, o utilizando el comando `gem`.
 
-Muchos proyectos utilizan [**GitHub**][2] para albergar sus
-repositorios. Puedes explorar el sitio para conocer más sobre cada
-librería y para colaborar.
+Usando `gem search -r`, puedes buscar en el repositorio de RubyGems. Por ejemplo, `gem search -r rails` devolverá una lista de gemas relacionadas con Rails. Con la opción `--local` (`-l`), se realiza una búsqueda local de tus gemas instaladas localmente.
+Para instalar una gema, use `gem install [gem]`. Parar listar sus gemas instaladas se utilizan `gem list`. Para obtener más información sobre el comando `gem`, vea más abajo o diríjase a [RubyGems’ docs] [3].
 
-[**RubyForge**][3] cayó en desuso en los últimos años y ya no es una
-fuente confiable. Antes de RubyGems y GitHub, era el mejor lugar para
-buscar librerías de Ruby. Un buen lugar para navegar es su [mapa de
-software][4], donde se alistan las bibliotecas por tópico. (Si terminas
-creando tus propias bibliotecas, puedes [registrar][5] tu proyecto en
-RubyForge para obtener acceso gratuito a Subversion, espacio web y
-listas de correo).
+Existes ademas otras fuentes de bibliotecas.
+[**GitHub**] [5] es el repositorio principal de contenido relacionado con Ruby. La mayoría de las veces, el código fuente de la gema se alojará en GitHub, publicándose también como una gema en RubyGems.org.
 
-Otro sitio que cayó en desuso es el [**Ruby Application Archive**][6] (o
-RAA). Se trata de un directorio de software Ruby de todo tipo,
-categorizado por su funcionalidad. En este momento, la categoría [Base
-de Datos][7] (Database) tiene la mayor cantidad de items, liderando
-sobre [Red][8] (Net) por 1. [HTML][9] y [XML][10] también son populares.
-Incluso hay 4 items sobre [Física][11].
+[**The Ruby Toolbox**] [6] es un proyecto que facilita la exploración de proyectos de código abierto de Ruby.
+Tiene categorías para varias tareas de desarrollo, recopila mucha información sobre los proyectos y califica los proyectos según su popularidad en RubyGems.org y GitHub.
+Esto hace que sea fácil encontrar una gema que resuelva un problema particular, como frameworks web, herramientas de documentación y bibliotecas de calidad de código.
 
-### Usando RubyGems
+### Unas palabras más sobre RubyGems
 
-Mientras que el instalador de Windows incluye RubyGems, muchos sistemas
-operativos no lo hacen. Aprende cómo instalar RubyGems aquí debajo si
-estos comandos no te funcionan.
+Daremos una revisión rápida del comando `gem` para su uso diario.
+[Documentación más detallada] [7] se encuentra disponible, cubriendo todos sus aspectos.
 
-#### Buscando gemas
+#### Buscando entre las gemas disponibles
 
-El comando **search** puede ser usado para buscar gemas con determinado
-nombre. Para buscar la palabra “html” en el nombre de una gema:
+El comando **search** se puede usar para buscar gemas utilizando una string.
+Las gemas cuyos nombres comiencen con la string especificada se listarán en la devolución.
+Por ejemplo, para buscar las gemas relacionadas con “html”:
 
 {% highlight sh %}
-$ gem search html --remote
+$ gem search -r html
 
 *** REMOTE GEMS ***
 
 html-sample (1.0, 1.1)
 {% endhighlight %}
 
-(*La opción `--remote` / `-r` indica que estamos buscando entre las gemas
-oficiales de RubyForge*).
+La bandera `--remote` /` -r` indica que queremos inspeccionar el
+repositorio oficial de RubyGems.org.
+Con la bandera `--local` /` -l` realizarías una búsqueda local entre tus gemas instaladas.
 
 #### Instalando una gema
 
-Una vez que sabes qué gema te gustaría **instalar**\:
+Una vez que sepa qué gema le gustaría **instalar**, por ejemplo, el popular framework Ruby on Rails:
 
 {% highlight sh %}
-$ gem install html-sample
+$ gem install rails
 {% endhighlight %}
 
-Incluso puedes instalar una versión específica de la biblioteca
-utilizando la opción `--version`.
+Incluso puede instalar solo una versión específica de la biblioteca, usando la bandera `--version` /` -v`:
 
 {% highlight sh %}
-$ gem install html-sample --version 1.0
+$ gem install rails --version 5.0
 {% endhighlight %}
 
-#### Alistando todas las gemas
+#### Listado de todas las gemas
+
+Para una **lista** de todas las gemas instaladas localmente:
 
-Para obtener una **lista** completa de las gemas en RubyForge:
+{% highlight sh %}
+$ gem list
+{% endhighlight %}
+
+Para obtener una lista (muy larga) de todas las gemas disponibles en RubyGems.org:
 
 {% highlight sh %}
-$ gem list --remote
+$ gem list -r
 {% endhighlight %}
 
-Para alistar sólo las gemas que tienes instaladas, quita la
-opción—remote.
+#### ¡Ayuda!
+
+Para acceder a la documentación disponible dentro de su terminal:
 
 {% highlight sh %}
-$ gem list
+$ gem help
 {% endhighlight %}
 
-Para obtener más información sobre el uso de RubyGems, estudia [la
-documentación oficial][12] que incluye ejemplos de cómo usar gemas en
-tus programas Ruby.
+Por ejemplo, `gem help commands` es muy útiles ya que lista de todos los comandos de `gem`.
 
-### Cómo instalar RubyGems
+#### Crear tus propias gemas
 
-Para instalar RubyGems, sigue las instrucciones que se detallan en
-[https://rubygems.org/pages/download][13].
+RubyGems.org tiene [varias guías] [3] sobre este tema. También es posible que desee investigar [Bundler] [9], una herramienta que le ayuda a administrar las dependencias de una aplicación y se puede usar junto con RubyGems.
 
 
 
 [1]: https://rubygems.org/
-[2]: https://github.com/
-[3]: http://rubyforge.org/
-[4]: http://rubyforge.org/softwaremap/trove_list.php
-[5]: http://rubyforge.org/register/
-[6]: http://raa.ruby-lang.org/
-[7]: http://raa.ruby-lang.org/cat.rhtml?category_major=Library;category_minor=Database
-[8]: http://raa.ruby-lang.org/cat.rhtml?category_major=Library;category_minor=Net
-[9]: http://raa.ruby-lang.org/cat.rhtml?category_major=Library;category_minor=HTML
-[10]: http://raa.ruby-lang.org/cat.rhtml?category_major=Library;category_minor=XML
-[11]: http://raa.ruby-lang.org/cat.rhtml?category_major=Library;category_minor=Physics
-[12]: http://guides.rubygems.org
-[13]: https://rubygems.org/pages/download
+[2]: https://rubygems.org/pages/download/
+[3]: http://guides.rubygems.org/
+[5]: https://github.com/
+[6]: https://www.ruby-toolbox.com/
+[7]: http://guides.rubygems.org/command-reference/
+[9]: http://bundler.io/