[IMP] installation

docs/_templates/hacks.html

@@ -1,7 +1,7 @@
 <!-- Alabaster (krTheme++) Hacks -->
 <aside id="python27">
-    Python 3, the new best practice, is here to stay.
-    Python 2 will retire in only <time></time> months!
+    Python 3, las nuevas mejoras prácticas, están aquí para quedarse.
+    Python 2 se retirará en sólo <time></time> meses!
 </aside>
 
 <!-- Python 2 Death Clock™ -->
@@ -42,4 +42,4 @@
     var s = document.getElementsByTagName('script')[0];
     s.parentNode.insertBefore(t, s);
   })();
-</script>
+</script>

docs/_templates/sidebarintro.html

@@ -5,39 +5,39 @@
 </p>
 
 <p>
-  This opinionated guide exists to provide both novice and expert Python developers a best practice handbook to the installation, configuration, and usage of Python on a daily basis.
+  Esta obstinada guía existe para entregar a ambos, novatos y expertos desarrolladores de Python una guía de mejores prácticas para la instalación, configuracióñ, y uso de Python adiario.
 </p>
 
 
 
-<h3>Stay Informed</h3>
-<p>Receive updates on new releases and upcoming projects.</p>
+<h3>Permanece Informado</h3>
+<p>Recibe actualizaciones sobre nuevos lanzamientos y próximos proyectos.</p>
 
 <p><iframe src="http://ghbtns.com/github-btn.html?user=kennethreitz&type=follow&count=false"
   allowtransparency="true" frameborder="0" scrolling="0" width="200" height="20"></iframe></p>
 
 <p><a href="https://twitter.com/kennethreitz" class="twitter-follow-button" data-show-count="false">Follow @kennethreitz</a> <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script></p>
 
-<p><a href="http://tinyletter.com/kennethreitz">Join Mailing List</a>.</p>
-<p><a href="https://saythanks.io/to/kennethreitz">Say Thanks!</a></p>
+<p><a href="http://tinyletter.com/kennethreitz">Únete a la lista de correo</a>.</p>
+<p><a href="https://saythanks.io/to/kennethreitz">Di gracias!</a></p>
 
 <a href="http://www.datacamp.com/?utm_source=python_guide&utm_campaign=display">
 <img src="{{ pathto('_static/ad.png', 1) }}" alt="">
 </a>
 
 <hr>
 
-<h3>O'Reilly Book</h3>
+<h3>Libro de O'Reilly</h3>
 
-<p>This guide is now available in tangible book form!</p>
+<p>Esta guía ahora esta disponible como libro impreso! (en inglés)</p>
 
 <a href="https://www.amazon.com/Hitchhikers-Guide-Python-Practices-Development/dp/1491933178/ref=as_li_ss_il?ie=UTF8&linkCode=li2&tag=bookforkind-20&linkId=804806ebdacaf3b56567347f3afbdbca" target="_blank"><img border="0" src="https://ws-na.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=1491933178&Format=_SL160_&ID=AsinImage&MarketPlace=US&ServiceVersion=20070822&WS=1&tag=bookforkind-20" ></a><img src="//ir-na.amazon-adsystem.com/e/ir?t=bookforkind-20&l=li2&o=1&a=1491933178" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />
 
-<p>All proceeds are being directly donated to the <a href="https://djangogirls.org">DjangoGirls</a> organization.</p>
+<p>Todos los ingresos son directamente donados  a la organización <a href="https://djangogirls.org">DjangoGirls</a>.</p>
 
-<h3>Other Projects</h3>
+<h3>Otros Proyectos</h3>
 
-<p>More <a href="http://kennethreitz.org/">Kenneth Reitz</a> projects:</p>
+<p>Más proyectos de <a href="http://kennethreitz.org/">Kenneth Reitz</a>:</p>
 <ul>
     <li><a href="http://wsl-guide.org/">wsl-guide.org</a></li>
     <li><a href="http://edmsynths.com/">edmsynths.com</a></li>
@@ -50,29 +50,30 @@ <h3>Other Projects</h3>
     <li><a href="http://docs.python-tablib.org/en/latest/">Tablib: Tabular Datasets</a></li>
 </ul>
 
-<h3>Contributors</h3>
+<h3>Contribuyentes</h3>
 <p>
-  This guide is the result of the collaboration of
-  <a href="https://github.com/kennethreitz/python-guide/graphs/contributors">hundreds of people</a>
-  around the world, and your contributions
-  <a href="http://docs.python-guide.org/en/latest/notes/contribute/">are welcome</a>!
+  Esta guía es el resultado de la colaboración de
+  <a href="https://github.com/kennethreitz/python-guide/graphs/contributors">cientos de personas</a>
+  alrededor del mundo, y tus contribuciones
+  <a href="http://docs.python-guide.org/en/latest/notes/contribute/">son bienvenidas</a>!
 </p>
 
 
-<h3>Useful Links</h3>
+<h3>Links de Ayuda</h3>
 <ul>
-  <li><a href="http://python-guide.org/">The Guide Website</a></li>
-  <li><a href="http://github.com/kennethreitz/python-guide">The Guide @ GitHub</a></li>
+  <li><a href="http://python-guide.org/">El sitio web</a></li>
+  <li><a href="http://github.com/kennethreitz/python-guide">La guía @ GitHub</a></li>
   <li><a href="http://github.com/kennethreitz/python-guide/issues">Issue Tracker</a></li>
-  <li><a href="https://media.readthedocs.org/pdf/python-guide/latest/python-guide.pdf">The Guide as a PDF</a></li>
+  <li><a href="https://media.readthedocs.org/pdf/python-guide/latest/python-guide.pdf">La Guía como PDF</a></li>
 </ul>
 
-<h3>Translations</h3>
+<h3>Traducciones</h3>
 <ul>
   <li><a href="http://docs.python-guide.org/en/latest/">English</a></li>
   <li><a href="https://python-guide-fr.readthedocs.io/fr/latest/">French</a></li>
   <li><a href="https://pythonguidecn.readthedocs.io/zh/latest/">Chinese</a></li>
   <li><a href="http://python-guideja.readthedocs.io/ja/latest/">Japanese</a></li>
   <li><a href="https://python-guide-kr.readthedocs.io/ko/latest/">Korean</a></li>
   <li><a href="http://python-guide-pt-br.readthedocs.io/pt_BR/latest/">Brazilian Portuguese</a></li>
+  <li><a href="http://python-guide-es.readthedocs.io/">Latin American Spanish</a></li>
 </ul>

docs/_templates/sidebarlogo.html

@@ -5,37 +5,37 @@
 </p>
 
 <p>
-  This opinionated guide exists to provide both novice and expert Python developers a best practice handbook to the installation, configuration, and usage of Python on a daily basis.
+  Esta obstinada guía existe para entregar a ambos, novatos y expertos desarrolladores de Python una guía de mejores prácticas para la instalación, configuracióñ, y uso de Python adiario.
 </p>
 
 
-<h3>Get Updates</h3>
-<p>Receive updates on new releases and upcoming projects.</p>
+<h3>Recibe Actualizaciones</h3>
+<p>Recibe actualizaciones sobre nuevos lanzamientos y próximos proyectos.</p>
 
 <p><iframe src="http://ghbtns.com/github-btn.html?user=kennethreitz&type=follow&count=false"
   allowtransparency="true" frameborder="0" scrolling="0" width="200" height="20"></iframe></p>
 
 <p><a href="https://twitter.com/kennethreitz" class="twitter-follow-button" data-show-count="false">Follow @kennethreitz</a> <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script></p>
-<p><a href="https://saythanks.io/to/kennethreitz">Say Thanks!</a></p>
-<p><a href="http://tinyletter.com/kennethreitz">Join Mailing List</a>.</p>
+<p><a href="https://saythanks.io/to/kennethreitz">Di gracias!</a></p>
+<p><a href="http://tinyletter.com/kennethreitz">Únete a la lista de correo</a>.</p>
 
 <a href="http://www.datacamp.com/?utm_source=python_guide&utm_campaign=display">
-<img src="{{ pathto('_static/ad.png', 1) }}" alt="">
+  <img src="{{ pathto('_static/ad.png', 1) }}" alt="">
 </a>
 
 <hr>
 
-<h3>O'Reilly Book</h3>
+<h3>Libro de O'Reilly</h3>
 
-<p>This guide is now available in tangible book form!</p>
+<p>Esta guía ahora esta disponible como libro impreso! (en inglés)</p>
 
 <a href="https://www.amazon.com/Hitchhikers-Guide-Python-Practices-Development/dp/1491933178/ref=as_li_ss_il?ie=UTF8&linkCode=li2&tag=bookforkind-20&linkId=804806ebdacaf3b56567347f3afbdbca" target="_blank"><img border="0" src="https://ws-na.amazon-adsystem.com/widgets/q?_encoding=UTF8&ASIN=1491933178&Format=_SL160_&ID=AsinImage&MarketPlace=US&ServiceVersion=20070822&WS=1&tag=bookforkind-20" ></a><img src="//ir-na.amazon-adsystem.com/e/ir?t=bookforkind-20&l=li2&o=1&a=1491933178" width="1" height="1" border="0" alt="" style="border:none !important; margin:0px !important;" />
 
-<p>All proceeds are being directly donated to the <a href="https://djangogirls.org">DjangoGirls</a> organization.</p>
+<p>Todos los ingresos son directamente donados  a la organización <a href="https://djangogirls.org">DjangoGirls</a>.</p>
 
 
 
-<h3>Other Projects</h3>
+<h3>Otros Proyectos</h3>
 
 <p>More <a href="http://kennethreitz.org/">Kenneth Reitz</a> projects:</p>
 <ul>
@@ -50,12 +50,13 @@ <h3>Other Projects</h3>
     <li><a href="http://docs.python-tablib.org/en/latest/">Tablib: Tabular Datasets</a></li>
 </ul>
 
-<h3>Translations</h3>
+<h3>Traducciones</h3>
 <ul>
   <li><a href="http://docs.python-guide.org/en/latest/">English</a></li>
   <li><a href="https://python-guide-fr.readthedocs.io/fr/latest/">French</a></li>
   <li><a href="https://pythonguidecn.readthedocs.io/zh/latest/">Chinese</a></li>
   <li><a href="http://python-guideja.readthedocs.io/ja/latest/">Japanese</a></li>
   <li><a href="https://python-guide-kr.readthedocs.io/ko/latest/">Korean</a></li>
   <li><a href="http://python-guide-pt-br.readthedocs.io/pt_BR/latest/">Brazilian Portuguese</a></li>
+  <li><a href="http://python-guide-es.readthedocs.io/">Latin American Spanish</a></li>
 </ul>

docs/contents.rst.inc

@@ -22,19 +22,19 @@ Nuevo con Python? Vamos a configurar correctamente tu ambiente Python.
     starting/install/linux
 
 
-- Using Virtualenvs with Pipenv:
+- Usando Virtualenvs con Pipenv:
 
 .. toctree::
     :maxdepth: 2
 
     dev/virtualenvs
 
 
-Python Development Environments
--------------------------------
+Ambientes de Desarrollo de Python
+---------------------------------
 
-This part of the guide focus on the Python development environment,
-and the best-practice tools that are available for writing Python code.
+Esta parte de la guía se enfoca en el ambiente de desarrollo de Python,
+y las mejoras prácticas que estan disponibles para escribir código Python.
 
 .. toctree::
    :maxdepth: 2

docs/dev/virtualenvs.rst

@@ -1,39 +1,39 @@
 .. _virtualenvironments-ref:
 
-Pipenv & Virtual Environments
-=============================
+Pipenv & Ambientes Virtuales
+============================
 
 .. image:: https://farm5.staticflickr.com/4290/35294660055_42c02b2316_k_d.jpg
 
-This tutorial walks you through installing and using Python packages.
+Este tutorial te llevará a traves de la instalación y uso de paquetes Python.
 
-It will show you how to install and use the necessary tools and make strong
-recommendations on best practices. Keep in mind that Python is used for a great
-many different purposes, and precisely how you want to manage your dependencies
-may change based on how you decide to publish your software. The guidance
-presented here is most directly applicable to the development and deployment of
-network services (including web applications), but is also very well suited to
-managing development and testing environments for any kind of project.
+Te va a mostrar como instalar y usar las herramientas necesarias y hacerte fuertes
+recomendaciones en las mejores prácticas. Ten en cuenta que Python es usado para grandes
+y diferentes propósitos, y precisamente cómo deseas manejar tus dependencias
+puede cambiar basado en como decides publicar tu software. La guía
+presentada está directamente aplicada al desarrollo y despliegue de
+servicios de red (incluyendo aplicaciones web), pero también esta muy adecuada para
+administrar ambientes de prueba y desarrollo para cualquier tipo de proyecto.
 
-.. Note:: This guide is written for Python 3, however, these instructions
-    should work fine on Python 2.7—if you are still using it, for some reason.
+.. Note:: Esta guía está escrita para Python 3, aunque, estas instrucciones
+    deberían trabajar bien en Python 2.7—si aún lo estas usando, por alguna razón.
 
 
-Make sure you've got Python & pip
+Asegúrate que tienes Python & pip
 ---------------------------------
 
-Before you go any further, make sure you have Python and that it's available
-from your command line. You can check this by simply running:
+Antes de ir más lejos, asegurate que tienes Python y que está disponible
+desde tu línea de comandos. Puedes revisar esto sólo ejecutando:
 
 .. code-block:: bash
 
     $ python --version
 
-You should get some output like ``3.6.2``. If you do not have Python, please
-install the latest 3.x version from `python.org`_ or refer to the
-`Installing Python`_ section of this guide.
+Debes obtener algún resultado como ``3.6.2``. Si no tienes Python, por favor
+instala la última versión desde `python.org`_ o refierete a la sección
+`Instalando Python`_ de esta guía.
 
-.. Note:: If you're newcomer and you get an error like this:
+.. Note:: Si eres novato y tienes un error como este:
 
     .. code-block:: python
 
@@ -42,38 +42,38 @@ install the latest 3.x version from `python.org`_ or refer to the
           File "<stdin>", line 1, in <module>
         NameError: name 'python' is not defined
 
-    It's because this command is intended to be run in a *shell* (also called
-    a *terminal* or *console*). See the Python for Beginners
-    `getting started tutorial`_ for an introduction to using your operating
-    system's shell and interacting with Python.
+    Es porque este comando esta tratando de ser ejecutado en una *shell* (también llamada
+    *terminal* o *consola*). Mira la sección Para Novatos
+    `getting started tutorial`_ para una introducción de cómo usar tu shell
+    del sistema operativo e interactuar con Python.
 
-Additionally, you'll need to make sure you have :ref:`pip` available. You can
-check this by running:
+Además, necesitarás asegurarte que tienes :ref:`pip` disponible. Puedes
+revisar esto ejecutando:
 
 .. code-block:: bash
 
     $ pip --version
 
-If you installed Python from source, with an installer from `python.org`_, or
-via `Homebrew`_ you should already have pip. If you're on Linux and installed
-using your OS package manager, you may have to `install pip <https://pip.pypa.io/en/stable/installing/>`_ separately.
+Si instalaste Python desde la fuente, con un instalador desde `python.org`_, o
+vía `Homebrew`_ ya deberías tener pip. Si estas usando Linux e instalaste
+usando tu manejador de paquetes del sistema operativo, talves tengas que `instalar pip <https://pip.pypa.io/en/stable/installing/>`_ por separado.
 
 .. _getting started tutorial: https://opentechschool.github.io/python-beginners/en/getting_started.html#what-is-python-exactly
 .. _python.org: https://python.org
 .. _Homebrew: https://brew.sh
 .. _Installing Python: http://docs.python-guide.org/en/latest/starting/installation/
 
 
-Installing Pipenv
+Instalando Pipenv
 -----------------
 
-:ref:`Pipenv` is a dependency manager for Python projects. If you're familiar
-with Node.js' `npm`_ or Ruby's `bundler`_, it is similar in spirit to those
-tools. While :ref:`pip` can install Python packages, Pipenv is recommended as
-it's a higher-level tool that simplifies dependency management for common use
-cases.
+:ref:`Pipenv` es un manejador de dependencias para proyectos Python. Si estas familiarizado
+con Node.js' `npm`_ o `bundler`_ de Ruby, es similiar en el espíritu de estas
+herramientas. Mientras :ref:`pip` puede instalar paquetes Python, Pipenv es recomendado como
+una herramienta de lato nivel que simplifica la gestión de dependencias como casos de uso
+común.
 
-Use ``pip`` to install Pipenv:
+Usa ``pip`` para instalar Pipenv:
 
 .. code-block:: python
 
@@ -107,7 +107,7 @@ Use ``pip`` to install Pipenv:
 .. _modifying ~/.profile: https://stackoverflow.com/a/14638025
 .. _Control Panel: https://msdn.microsoft.com/en-us/library/windows/desktop/bb776899(v=vs.85).aspx
 
-Installing packages for your project
+Instalando Paquetes para tu Proyecto
 ------------------------------------
 
 Pipenv manages dependencies on a per-project basis. To install packages,
@@ -155,8 +155,8 @@ when you share your project with others. You should get output similar to this
 .. _Requests: https://python-requests.org
 
 
-Using installed packages
-------------------------
+Usando Paquetes Instalados
+--------------------------
 
 Now that Requests is installed you can create a simple ``main.py`` file to
 use it:
@@ -186,15 +186,15 @@ your script. It's also possible to spawn a new shell that ensures all commands
 have access to your installed packages with ``$ pipenv shell``.
 
 
-Next steps
-----------
+Siguientes Pasos
+----------------
 
 Congratulations, you now know how to install and use Python packages! ✨ 🍰 ✨
 
 
 
-Lower level: virtualenv
-=======================
+Un nivel más bajo: virtualenv
+=============================
 
 `virtualenv <http://pypi.python.org/pypi/virtualenv>`_ is a tool to create
 isolated Python environments. virtualenv creates a folder which contains all the
@@ -214,8 +214,9 @@ Test your installation
 
    $ virtualenv --version
 
-Basic Usage
-~~~~~~~~~~~
+
+Uso Básico
+~~~~~~~~~~
 
 1. Create a virtual environment for a project:
 
@@ -280,7 +281,7 @@ After a while, though, you might end up with a lot of virtual environments
 littered across your system, and its possible you'll forget their names or
 where they were placed.
 
-Other Notes
+Otras Notas
 ~~~~~~~~~~~
 
 Running ``virtualenv`` with the option ``--no-site-packages`` will not
@@ -341,8 +342,8 @@ To install (make sure **virtualenv** is already installed):
 
 In Windows, the default path for WORKON_HOME is %USERPROFILE%\Envs
 
-Basic Usage
-~~~~~~~~~~~
+Uso Básico
+~~~~~~~~~~
 
 1. Create a virtual environment:
 
@@ -385,7 +386,7 @@ can quickly switch between environments.
 
    $ rmvirtualenv venv
 
-Other useful commands
+Otros comandos útiles
 ~~~~~~~~~~~~~~~~~~~~~
 
 ``lsvirtualenv``

docs/starting/install/win.rst

@@ -86,5 +86,5 @@ Para empezar a usarlo y ver más imformación: :ref:`Virtual Environments <virtu
 
 --------------------------------
 
-Esta página es una mezcla de `another guide <http://www.stuartellis.eu/articles/python-development-windows/>`_,
+Esta página es una mezcla de `otra guía <http://www.stuartellis.eu/articles/python-development-windows/>`_,
 que esta disponible bajo la misma licencia.