Commits

Manuel Kaufmann committed 2f2dbe2

Spanish translation updated

Updated up to 3.5 and development version but there are some
paragraphs missing.

Comments (0)

Files changed (8)

docs/source/command_ref.rst

 
 Sintaxis::
 
-    mkvirtualenv [options] ENVNAME
+    mkvirtualenv [-a project_path] [-i package] [-r requirements_file] [virtualenv options] ENVNAME
 
-Todas las opciones de línea de comandos son pasados directamente a
-``virtualenv``. El nuevo entorno es automáticamente activado luego de su
-inicialización.
+Todas las opciones de línea de comandos excepto ``-a``, ``-i``,
+``-r``, y ``-h`` son pasados directamente a ``virtualenv``. El nuevo
+entorno es automáticamente activado luego de su inicialización.
 
 ::
 
     mynewenv
     (mynewenv)$ 
 
+La opción ``-a`` puede ser usada para asociar un directorio de
+proyecto existente con el nuevo entorno.
+
+La opción ``-i`` puede ser usada para instalar uno o más paquetes
+(repitiendo la opción) luego que el entorno sea creado.
+
+La opción ``-r`` puede ser usada para especificar un archivo de texto
+con la lista de paquetes a ser instalados. El valor del argumento es
+pasado a ``pip -r`` para que sean instalados.
+
 .. seealso::
 
    * :ref:`scripts-premkvirtualenv`
    * :ref:`scripts-postmkvirtualenv`
+   * `requirements file format`_
+
+.. _requirements file format: http://www.pip-installer.org/en/latest/requirement-format.html
+
+.. _command-mktmpenv:
+
+mktmpenv
+--------
+
+Crea un nuevo virtualenv en el directorio ``WORKON_HOME``.
+
+Sintaxis::
+
+    mktmpenv [VIRTUALENV_OPTIONS]
+
+Un nombre único es generado para el virtualenv.
+
+::
+
+    $ mktmpenv
+    Using real prefix '/Library/Frameworks/Python.framework/Versions/2.7'
+    New python executable in 1e513ac6-616e-4d56-9aa5-9d0a3b305e20/bin/python
+    Overwriting 1e513ac6-616e-4d56-9aa5-9d0a3b305e20/lib/python2.7/distutils/__init__.py 
+    with new content
+    Installing distribute...............................................
+    ....................................................................
+    .................................................................done.
+    This is a temporary environment. It will be deleted when deactivated.
+    (1e513ac6-616e-4d56-9aa5-9d0a3b305e20) $
+
+.. _command-lsvirtualenv:
+
+lsvirtualenv
+------------
+
+Lista todos los entornos.
+
+Sintaxis::
+
+    lsvirtualenv [-b] [-l] [-h]
+
+-b
+  Modo breve, deshabilita la salida verbosa.
+-l
+  Modo largo, habilita la salida verbosa.  Por defecto.
+-h
+  Imprime la ayuda de lsvirtualenv.
+
+.. seealso::
+
+   * :ref:`scripts-get_env_details`
+
+.. _command-showvirtualenv:
+
+showvirtualenv
+--------------
+
+Muestra los detalles de un virtualenv.
+
+Syntax::
+
+    showvirtualenv [env]
+
+.. seealso::
+
+   * :ref:`scripts-get_env_details`
+
+.. _command-rmvirtualenv:
 
 rmvirtualenv
 ------------
 cpvirtualenv
 ------------
 
-Duplica un entorno, dentro de WORKON_HOME.
+Duplica un entorno virtualenv existente. El entorno de origen puede
+ser un entorno manejado con virtualenvwrapper o uno externo creado en
+otro lugar.
 
 Sintaxis::
 
-    cpvirtualenv ENVNAME TARGETENVNAME
+    cpvirtualenv ENVNAME [TARGETENVNAME]
 
 .. note::
 
-   El entorno creado por la operación de copia es hecho `reubicable
-   <http://virtualenv.openplans.org/#making-environments-relocatable>`__.
+   El nombre de entorno de destino es necesario para duplicar un
+   entorno existente en WORKON_HOME. Sin embargo, éste puede ser
+   omitido para importar entornos externos. Si se omite, el nuevo
+   entorno tendrá el mismo nombre que el original.
+
 
 ::
 
 Controlar los entornos activos
 ==============================
 
+.. _command-workon:
+
 workon
 ------
 
 entorno.
 
 *Basado en una contribución de James Bennett y Jannis Leidel.*
+
+.. _command-toggleglobalsitepackages:
+
+toggleglobalsitepackages
+------------------------
+
+Controla si el virtualenv activo tendrá acceso a los paquetes en el
+directorio ``site-packages`` global de Python.
+
+Sintaxis::
+
+    toggleglobalsitepackages [-q]
+
+Muestra el nuevo estado del virtualenv. Usa la opción ``-q`` para
+apagar la salida por pantalla.
+
+::
+
+    $ mkvirtualenv env1
+    New python executable in env1/bin/python
+    Installing distribute.............................................
+    ..................................................................
+    ..................................................................
+    done.
+    (env1)$ toggleglobalsitepackages
+    Disabled global site-packages
+    (env1)$ toggleglobalsitepackages
+    Enabled global site-packages
+    (env1)$ toggleglobalsitepackages -q
+    (env1)$
+
+=========================================
+Administración de directorios de proyecto
+=========================================
+
+.. seealso::
+
+   :ref:`project-management`
+
+.. _command-mkproject:
+
+mkproject
+---------
+
+Crea un nuevo virtualenv en WORKON_HOME y el directorio del proyecto
+en PROJECT_HOME.
+
+Sintaxis::
+
+    mkproject [-t template] [virtualenv_options] ENVNAME
+
+La opción template puede repetirse varias veces para utilizar
+diferentes templates en la creación del proyecto. Los templates son
+aplicados en el orden mencionados en la línea de comandos. Todas las
+otras opciones son pasadas a ``mkvirtualenv`` para crear un virtualenv
+con el mismo nombre que el proyecto.
+
+::
+
+    $ mkproject myproj
+    New python executable in myproj/bin/python
+    Installing distribute.............................................
+    ..................................................................
+    ..................................................................
+    done.
+    Creating /Users/dhellmann/Devel/myproj
+    (myproj)$ pwd
+    /Users/dhellmann/Devel/myproj
+    (myproj)$ echo $VIRTUAL_ENV
+    /Users/dhellmann/Envs/myproj
+    (myproj)$ 
+
+.. seealso::
+
+  * :ref:`scripts-premkproject`
+  * :ref:`scripts-postmkproject`
+
+setvirtualenvproject
+--------------------
+
+Asocia un virtualenv existente a un proyecto existente.
+
+Sintaxis::
+
+  setvirtualenvproject [virtualenv_path project_path]
+
+Los argumentos de ``setvirtualenvproject`` son paths absolutos hacia el
+virtualenv y el directorio del proyecto. Una asociación es hecha para
+que cuando ``workon`` active el virtualenv también active el proyecto.
+
+::
+
+    $ mkproject myproj
+    New python executable in myproj/bin/python
+    Installing distribute.............................................
+    ..................................................................
+    ..................................................................
+    done.
+    Creating /Users/dhellmann/Devel/myproj
+    (myproj)$ mkvirtualenv myproj_new_libs
+    New python executable in myproj/bin/python
+    Installing distribute.............................................
+    ..................................................................
+    ..................................................................
+    done.
+    Creating /Users/dhellmann/Devel/myproj
+    (myproj_new_libs)$ setvirtualenvproject $VIRTUAL_ENV $(pwd)
+
+Cuando ningún argumento es pasado, se asume el virtualenv y el
+directorio activo.
+
+Cualquier número de virtualenvs puede referirse al mismo directorio de
+proyecto, haciendo fácil cambiar entre versiones de Python o otras
+dependencias necesarias para testing.
+
+.. _command-cdproject:
+
+cdproject
+---------
+
+Cambia el directorio de trabajo actual al especificado como directorio
+del proyecto para el virtualenv activo.
+
+Sintaxis::
+
+  cdproject

docs/source/extensions.rst

 Debajo se listan algunas de las extensiones disponibles para usar con
 virtualenvwrapper.
 
-.. _extensions-user_scripts:
-
-project
-=======
-
-La extensión project_ agrega la gestión del desarrollo de directorios con
-plantillas para virtualenvwrapper.
-
-bitbucket
----------
-
-La plantilla de proyecto bitbucket_ crea un directorio de trabajo y
-automáticamente clona el repositorio desde BitBucket. Requiere project_
-
-.. _project: http://www.doughellmann.com/projects/virtualenvwrapper.project/
-
-.. _bitbucket: http://www.doughellmann.com/projects/virtualenvwrapper.bitbucket/
-
 emacs-desktop
 =============
 
 
 .. _emacs-desktop: http://www.doughellmann.com/projects/virtualenvwrapper-emacs-desktop/
 
+.. _extensions-user_scripts:
+
 user_scripts
 ============
 
 habilitada por default. Implementa la característica de script de personalización
 de usuarios descrita en :ref:`scripts`.
 
+
+vim-virtualenv
+==============
+
+`vim-virtualenv`_ es una extensión de Jeremey Cantrell para controlar
+los virtualenvs desde adentro de vim. Cuando es usado en conjunto con
+virtualenvwrapper, vim-virtualenv identifica el virtualenv a activar
+basándose en el nombre del archivo que está siendo editado.
+
+.. _vim-virtualenv: https://github.com/jmcantrell/vim-virtualenv
+
+.. _extensions-templates:
+
+Templates
+=========
+
+Debajo hay una lista de algunos de los templates disponibles para ser usados
+:ref:`command-mkproject`.
+
+.. _templates-bitbucket:
+
+bitbucket
+---------
+
+La extensión de bitbucket_ clona automáticamente un repositorio
+mercurial desde el proyecto bitbucket especificado.
+
+.. _bitbucket: http://www.doughellmann.com/projects/virtualenvwrapper.bitbucket/
+
+.. _templates-django:
+
+django
+------
+
+La extensión django_ crea automáticamente un nuevo proyecto Django.
+
+.. _django: http://www.doughellmann.com/projects/virtualenvwrapper.django/
+
+.. seealso::
+
+   * :ref:`developer-templates`

docs/source/history.rst

 Release History
 ===============
 
+dev
+
+  - Switch to stevedore_ for plugin management
+  - mkvirtualenv_help should use ``$VIRTUALENVWRAPPER_PYTHON`` instead
+    of calling ``virtualenv`` directly (:bbissue:`148`).
+  - Fix issue with lazy-loader code under zsh (:bbissue:`144`).
+  - Fix issue with ``noclobber`` option under zsh
+    (:bbissue:`137`). Fix based on patch from :bbuser:`rob_b`.
+
+.. _stevedore: http://pypi.python.org/pypi/stevedore
+
+3.5
+
+  - Rewrite :ref:`command-cpvirtualenv` to use `virtualenv-clone`_
+    instead of making the new environment relocatable. Contributed by
+    Justin Barber (:bbuser:`barberj`). This also resolves a problem
+    with cpvirtualenv not honoring the ``--no-site-packages`` flag
+    (:bbissue:`102`).
+  - Update docs with link to `virtualenvwrapper-win`_ port by David
+    Marble.
+  - Use ``command`` to avoid functions named the same as common
+    utilities. (:bbissue:`119`)
+
+.. _virtualenv-clone: http://pypi.python.org/pypi/virtualenv-clone
+.. _virtualenvwrapper-win: http://pypi.python.org/pypi/virtualenvwrapper-win 
+
+
+3.4
+
+  - Add :ref:`install-lazy-loader` option.
+
+3.3
+
+  - Clean up file permissions and remove shebangs from scripts not
+    intended to be executed on the command line. (contributed by
+    :bbuser:`ralphbean`)
+  - Worked on some brittle tests.
+  - Received updates to Japanese translation of the documentation from
+    :bbuser:`t2y`.
+  - Fix the test script and runner so the user's ``$WORKON_HOME`` is
+    not erased if they do not have some test shells installed.
+    (big thanks to :bbuser:`agriffis`).
+  - If the hook loader is told to list plugins but is not given a hook
+    name, it prints the list of core hooks.
+  - Merge several fixes for path and variable handling for MSYS users
+    from :bbuser:`bwanamarko`. Includes a fix for :bbissue:`138`.
+  - Change :ref:`command-mkvirtualenv` so it catches both ``-h`` and
+    ``--help``.
+  - Fix some issues with the way temporary files are used for hook
+    scripts. (contributed by :bbuser:`agriffis`)
+  - Allow relative path to requirements file with
+    :ref:`command-mkvirtualenv` and ``-r`` option. (:bbuser:`barberj`)
+  - Make whitespace consistent. (:bbuser:`agriffis`)
+
+3.2
+
+  - Make ``project_dir`` a local variable so that
+    :ref:`command-cdproject` does not interfere with other variables
+    the user might have set. (contributed by :bbuser:`slackorama`)
+  - Fix typo in documentation reported by Nick Martin.
+  - Change trove classifier for license "MIT" to reflect the license
+    text presented in the documentation. *This does not indicate a
+    change in the license, just a correction to the expression of that
+    intent. See :ref:`license`* (contributed by :bbuser:`ralphbean` as
+    fix for :bbissue:`134`)
+  - Extend :ref:`command-rmvirtualenv` to allow removing more than one
+    environment at a time. (contributed by :bbuser:`ciberglo`)
+  - Change the definition of
+    ``virtualenvwrapper_get_site_packages_dir`` to ask ``distutils``
+    for the ``site-packages`` directory instead of trying to build the
+    path ourselves in the shell script. This should resolve
+    :bbissue:`112` and improve support for Python interpreters other
+    than C Python. Thanks to Carl Meyer and Dario Bertini for their
+    contributions toward the fix.
+
+3.1
+
+  - Fix a problem with activation hooks when associating a new
+    virtualenv with an existing project directory. (:bbissue:`122`)
+  - Fix a problem with :ref:`command-add2virtualenv` and paths
+    containing "special" characters such as ``&``. (:bbissue:`132`)
+
+3.0.1
+
+  - Fix some packaging issues that made it more difficult to run the
+    tests directly from the sdist package. (:bbissue:`126`)
+
+3.0
+
+  - Add Python 3 support, thanks in large part to the efforts of
+    Daniel Kraus (:bbuser:`dakra`). Tested under Python 2.6, 2.7, and
+    3.2.
+
+2.11.1
+
+  - Remove the initialization shortcut because it breaks tab
+    completion in sub-shell environments like screen and
+    tmux. (:bbissue:`121`)
+
+2.11
+
+  - Add ``-a`` option to :ref:`command-mkvirtualenv` to associate a
+    new virtualenv with an existing project directory. Contributed by
+    Mike Fogel (:bbuser:`mfogel`).
+  - Drops support for Python 2.4 and 2.5. The tools may still work,
+    but I no longer have a development environment set up for testing
+    them, so I do not officially support them.
+  - Shortcut initialization if it has run before.
+  - Set hook log file permissions to be group-writable. (:bbissue:`62`
+    reported by :bbuser:`hedgeddown`)
+  - Add ``VIRTUALENVWRAPPER_PROJECT_FILENAME`` variable so the
+    ``.project`` file used to link a virtualenv to a project can be
+    renamed to avoid conflicts with other tools. (:bbissue:`120`
+    reported by :bbuser:`arthuralvim`)
+
+2.10.1
+
+  - Changed arguments to :ref:`command-mktmpenv` so it always creates
+    an environment name for you. (:bbissue:`114` reported by
+    :bbuser:`alex_gaynor`)
+
+2.10
+
+  - Incorporated patch to add ``-d`` option to
+    :ref:`command-add2virtualenv`, contributed by :bbuser:`miracle2k`.
+  - Add ``-i`` option to :ref:`command-mkvirtualenv`.
+  - Add :ref:`command-mktmpenv` command for creating temporary
+    environments that are automatically removed when they are
+    deactivated.
+  - Fixed a problem with hook_loader that prevented it from working
+    under Python 2.5 and 2.4.
+  - Fix a problem with the way template names were processed under
+    zsh. (:bbissue:`111`)
+
+2.9
+
+  - Change the shell function shell definition syntax so that ksh will
+    treat typeset-declared variables as local. No kidding.
+  - Merge the "project directory" features of the
+    ``virtualenvwrapper.project`` plugin into the main project, adding
+    :ref:`command-mkproject`, :ref:`command-cdproject`, and
+    :ref:`command-setvirtualenvproject` commands.
+  - Add ``-r`` option to :ref:`command-mkvirtualenv` to install
+    dependencies using a pip requirements file.
+
+2.8
+
+  - Use VIRTUALENVWRAPPER_VIRTUALENV in `cpvirtualenv` (:bbissue:`104`).
+  - Add support for `MSYS <http://www.mingw.org/wiki/MSYS>`_
+    environment under Windows. Contributed by Axel
+    H. (:bbuser:`noirbizarre`).
+
+2.7.2
+
+  - Move setup code for tab completion later in the startup code so
+    all of the needed variables are configured. (:bbissue:`97`)
+  - Expand tab completion for zsh to work for all commands.
+
+2.7.1
+
+  - When testing for WORKON_HOME during startup, dereference any
+    symlink to make sure it is a directory.
+  - Set VIRTUALENVWRAPPER_HOOK_DIR and VIRTUALENV_WRAPPER_LOG DIR in
+    virtualenvwrapper_initialize after WORKON_HOME is set
+    (:bbissue:`94`).
+  - Update the :ref:`install-basic` instructions to be more explicit
+    about needing to install virtualenvwrapper globally (or at least
+    outside of a virtualenv).
+
+2.7
+
+  - Fix problem with space in WORKON_HOME path (:bbissue:`79`).
+  - Fix problem with argument processing in lsvirtualenv under zsh
+    (:bbissue:`86`). Thanks to Nat Williams (:bbuser:`natw`) for the
+    bug report and patch.
+  - If WORKON_HOME does not exist, create it. Patch from Carl Karsten
+    (:bbuser:`CarlFK`). Test updates based on patches from Matt Austin
+    (:bbuser:`maafy6`) and Hugo Lopes Tavares (:bbuser:`hltbra`).
+  - Merge in contributions from Paul McLanahan (:bbuser:`pmclanahan`)
+    to fix the test harness to ensure that the test scripts are
+    actually running under the expected shell.
+  - Merge in new shell command :ref:`command-toggleglobalsitepackages`
+    from Paul McLanahan (:bbuser:`pmclanahan`). The new command
+    changes the configuration of the active virtualenv to enable or
+    disable the global ``site-packages`` directory.
+  - Fixed some tests that were failing under ksh on Ubuntu 10.10.
+  - Document the :ref:`VIRTUALENVWRAPPER_VIRTUALENV
+    <variable-VIRTUALENVWRAPPER_VIRTUALENV>` variable.
+  - Implement suggestion by Van Lindberg to have
+    :ref:`VIRTUALENVWRAPPER_HOOK_DIR
+    <variable-VIRTUALENVWRAPPER_HOOK_DIR>` and
+    :ref:`VIRTUALENVWRAPPER_LOG_DIR
+    <variable-VIRTUALENVWRAPPER_LOG_DIR>` variables to control the
+    locations of hooks and logs.
+  - Enabled tab completion for :ref:`command-showvirtualenv`
+    (:bbissue:`78`).
+  - Fixed a problem with running :ref:`command-rmvirtualenv` from
+    within the environment being removed (:bbissue:`83`).
+  - Removed use of -e option in calls to grep for better portability
+    (:bbissue:`85`).
+
+2.6.3
+
+  - Hard-code the version information in the setup.py and conf.py
+    scripts. This still doesn't work for http://readthedocs.org, since
+    the doc build needs the sphinxcontrib.bitbucket extension, but
+    will make it easier to transition the docs to another site later.
+
+2.6.2
+
+  - Attempted to make the doc build work with http://readthedocs.org.
+  - Merged in `Japanese translation of the documentation
+    <http://www.doughellmann.com/docs/virtualenvwrapper/ja/>`__ from
+    Tetsuya Morimoto.
+  - Incorporate a suggestion from Ales Zoulek to let the user specify
+    the virtualenv binary through an environment variable
+    (:ref:`VIRTUALENVWRAPPER_VIRTUALENV <variable-VIRTUALENVWRAPPER_VIRTUALENV>`).
+
+2.6.1
+
+  - Fixed virtualenvwrapper_get_python_version (:bbissue:`73`).
+
+2.6
+
+  - Fixed a problem with hook script line endings under Cygwin
+    (:bbissue:`68`).
+  - Updated documentation to include a list of the compatible shells
+    (:ref:`supported-shells`) and Python versions
+    (:ref:`supported-versions`) (:bbissue:`70`).
+  - Fixed installation dependency on virtualenv (:bbissue:`60`).
+  - Fixed the method for determining the Python version so it works
+    under Python 2.4 (:bbissue:`61`).
+  - Converted the test infrastructure to use `tox
+    <http://codespeak.net/tox/index.html>`_ instead of home-grown
+    scripts in the Makefile.
+
+2.5.3
+
+  - Point release uploaded to PyPI during outage on doughellmann.com.
+
+2.5.2
+
+  - Apply patch from Zach Voase to fix :ref:`command-lsvirtualenv`
+    under zsh. Resolves :bbissue:`64`.
+
+2.5.1
+
+  - Make :ref:`command-workon` list brief environment details when run
+    without argument, instead of full details.
+
+2.5
+
+  - Add :ref:`command-showvirtualenv` command.  Modify
+    :ref:`command-lsvirtualenv` to make verbose output the default.
+
+2.4
+
+  - Add :ref:`command-lsvirtualenv` command with ``-l`` option to run
+    :ref:`scripts-get_env_details` hook instead of always running it
+    when :ref:`command-workon` has no arguments.
+
+2.3
+
+  - Added ``get_env_details`` hook.
+
+2.2.2
+
+  - Integrate Fred Palmer's patch to escape more shell commands to
+    avoid aliases.  Resolves :bbissue:`57`.
+  - Fix a problem with egrep argument escaping (:bbissue:`55`).
+  - Fix a problem with running mkvirtualenv without arguments (:bbissue:`56`).
+
+2.2.1
+
+  - Escape ``which`` calls to avoid aliases. Resolves :bbissue:`46`.
+  - Integrate Manuel Kaufmann's patch to unset GREP_OPTIONS before
+    calling grep.  Resolves :bbissue:`51`.
+  - Escape ``$`` in regex to resolve :bbissue:`53`.
+  - Escape ``rm`` to avoid issues with aliases and resolve
+    :bbissue:`50`.
+
+2.2
+
+  - Switched hook loader execution to a form that works with Python
+    2.4 to resolve :bbissue:`43`.
+  - Tested under Python 2.7b1.  See :bbissue:`44`.
+  - Incorporated performance improvements from David Wolever.  See
+    :bbissue:`38`.
+  - Added some debug instrumentation for :bbissue:`35`.
+
+2.1.1
+
+  - Added `Spanish translation for the documentation
+    <http://www.doughellmann.com/docs/virtualenvwrapper/es/>`__ via
+    Manuel Kaufmann's fork at
+    http://bitbucket.org/humitos/virtualenvwrapper-es-translation/
+  - Fixed improper use of python from ``$PATH`` instead of the
+    location where the wrappers are installed.  See :bbissue:`41`.
+  - Quiet spurrious error/warning messages when deactivating a
+    virtualenv under zsh.  See :bbissue:`42`.
+
 2.1
 
   - Add support for ksh.  Thanks to Doug Latornell for doing the
     research on what needed to be changed.
   - Test import of virtualenvwrapper.hook_loader on startup and report
     the error in a way that should help the user figure out how to fix
-    it (issue #33).
+    it (:bbissue:`33`).
   - Update :ref:`command-mkvirtualenv` documentation to include the
     fact that a new environment is activated immediately after it is
-    created (issue #30).
+    created (:bbissue:`30`).
   - Added hooks around :ref:`command-cpvirtualenv`.
   - Made deactivation more robust, especially under ksh.
   - Use Python's ``tempfile`` module for creating temporary filenames
 
 2.0.2
 
-  - Fixed issue #32, making virtualenvwrapper.user_scripts compatible
+  - Fixed :bbissue:`32`, making virtualenvwrapper.user_scripts compatible
     with Python 2.5 again.
 
 2.0.1
 
-  - Fixed issue #29, to use a default value for ``TMPDIR`` if it is
-    not set in the user's shell environment.
+  - Fixed :bbissue:`29`, to use a default value for ``TMPDIR`` if it
+    is not set in the user's shell environment.
 
 2.0
 
 
   - Fix a problem with error messages showing up during init for users
     with the wrappers installed site-wide but who are not actually
-    using them.  See issue #26.
+    using them.  See :bbissue:`26`.
   - Split up the tests into multiple files.
   - Run all tests with all supported shells.
 
 1.24
 
   - Resolve a bug with the preactivate hook not being run properly.
-    Refer to issue #21 for complete details.
+    Refer to :bbissue:`21` for complete details.
 
 1.23
 
   - Resolve a bug with the postmkvirtualenv hook not being run
-    properly.  Refer to issues #19 and #20 for complete details.
+    properly.  Refer to :bbissue:`19` and :bbissue:`20` for complete
+    details.
 
 1.22
 
 
 1.21
 
-  - Better protection of ``$WORKON_HOME`` does not exist when the wrapper script is sourced.
+  - Better protection of ``$WORKON_HOME`` does not exist when the
+    wrapper script is sourced.
 
 1.20
 
   - Incorporate lssitepackages feature from Sander Smits.
-  - Refactor some of the functions that were using copy-and-paste code to build path names.
+  - Refactor some of the functions that were using copy-and-paste code
+    to build path names.
   - Add a few tests.
 
 1.19
 
-  - Fix problem with add2virtualenv and relative paths. Thanks to Doug Latornell for the bug report James Bennett for the suggested fix.
+  - Fix problem with add2virtualenv and relative paths. Thanks to Doug
+    Latornell for the bug report James Bennett for the suggested fix.
 
 1.18.1
 
-  - Incorporate patch from Sascha Brossmann to fix a issue #15. Directory normalization was causing ``WORKON_HOME`` to appear to be a missing directory if there were control characters in the output of ``pwd``.
+  - Incorporate patch from Sascha Brossmann to fix a
+    :bbissue:`15`. Directory normalization was causing ``WORKON_HOME``
+    to appear to be a missing directory if there were control
+    characters in the output of ``pwd``.
 
 1.18
 
-  - Remove warning during installation if sphinxcontrib.paverutils is not installed. (#10)
+  - Remove warning during installation if sphinxcontrib.paverutils is
+    not installed. (:bbissue:`10`)
   - Added some basic developer information to the documentation.
   - Added documentation for deactivate command.
 
 
 1.16
 
-  - Merged in changes to ``cdvirtualenv`` from wam and added tests and docs.
-  - Merged in changes to make error messages go to stderr, also provided by wam.
+  - Merged in changes to ``cdvirtualenv`` from wam and added tests and
+    docs.
+  - Merged in changes to make error messages go to stderr, also
+    provided by wam.
 
 1.15
   - Better error handling in mkvirtualenv.
   - Remove bogus VIRTUALENV_WRAPPER_BIN variable.
 
 1.14
-  - Wrap the virtualenv version of deactivate() with one that lets us invoke
-    the predeactivate hooks.
-  - Fix virtualenvwrapper_show_workon_options for colorized versions of ls and
-    write myself a note so I don't break it again later.
-  - Convert test.sh to use true tests with `shunit2 <http://shunit2.googlecode.com/>`_
+  - Wrap the virtualenv version of deactivate() with one that lets us
+    invoke the predeactivate hooks.
+  - Fix virtualenvwrapper_show_workon_options for colorized versions
+    of ls and write myself a note so I don't break it again later.
+  - Convert test.sh to use true tests with `shunit2
+    <http://shunit2.googlecode.com/>`_
 
 1.13
-  - Fix issue #5 by correctly handling symlinks and limiting the list of envs to things 
-    that look like they can be activated.
+
+  - Fix :bbissue:`5` by correctly handling symlinks and limiting the
+    list of envs to things that look like they can be activated.
 
 1.12
-  - Check return value of virtualenvwrapper_verify_workon_home everywhere, thanks to 
-    Jeff Forcier for pointing out the errors.
+
+  - Check return value of virtualenvwrapper_verify_workon_home
+    everywhere, thanks to Jeff Forcier for pointing out the errors.
   - Fix instructions at top of README, pointed out by Matthew Scott.
   - Add cdvirtualenv and cdsitepackages, contributed by James Bennett.
   - Enhance test.sh.
 
 1.11
+
   - Optimize virtualenvwrapper_show_workon_options.
   - Add global postactivate hook.
 
 1.10
-  - Pull in fix for colorized ls from Jeff Forcier (b42a25f7b74a).
+
+  - Pull in fix for colorized ls from Jeff Forcier
+    (:bbchangeset:`b42a25f7b74a`).
 
 1.9
-  - Add more hooks for operations to run before and after creating or deleting environments based on changes from Chris Hasenpflug.
+
+  - Add more hooks for operations to run before and after creating or
+    deleting environments based on changes from Chris Hasenpflug.
 
 1.8.1
-  - Corrected a problem with change to mkvirtualenv that lead to release 1.8 by using an alternate fix proposed by James in comments on release 1.4.
+
+  - Corrected a problem with change to mkvirtualenv that lead to
+    release 1.8 by using an alternate fix proposed by James in
+    comments on release 1.4.
 
 1.8
-  - Fix for processing the argument list in mkvirtualenv from jorgevargas (BitBucket issue #1)
+
+  - Fix for processing the argument list in mkvirtualenv from
+    jorgevargas (:bbissue:`1`)
 
 1.7
+
   - Move to bitbucket.org for hosting
   - clean up TODO list and svn keywords
   - add license section below
 
 1.5
 
-  - Fix some issues with spaces in directory or env names.  They still don't really work with virtualenv, though.
+  - Fix some issues with spaces in directory or env names.  They still
+    don't really work with virtualenv, though.
   - Added documentation for the postactivate and predeactivate scripts.
 
 1.4
 
-  - Includes a new .pth management function based on work contributed by James Bennett and Jannis Leidel.
+  - Includes a new .pth management function based on work contributed
+    by James Bennett and Jannis Leidel.
 
 1.3.x
 

docs/source/index.rst

    install
    command_ref
    hooks
+   projects
    tips
    developers
    extensions
 <http://mathematism.com/2009/jul/30/presentation-pip-and-virtualenv/>`__
 mostrando las características de virtualenvwrapper.
 
+Manuel Kaufmann ha `traducido esta documentación al Español
+<http://virtualenvwrapper-docs-es.readthedocs.org/en/latest/>`__.
+
+Tetsuya Morimoto ha `traducido esta documentación al Japonés
+<http://virtualenvwrapper-docs-ja.readthedocs.org/en/latest/>`__.
+
+=======
+Soporte
+=======
+
+Únete al `Grupo de Google de virtualenvwrapper
+<http://groups.google.com/group/virtualenvwrapper/>`__ para discutir
+problemas y característas.
+
+Reporta problemas en el `bug tracker de BitBucket
+<http://bitbucket.org/dhellmann/virtualenvwrapper/>`__.
+
+Alias de shell
+==============
+
+Debido a que virtualenvwrapper es en su mayoría un script de shell,
+éste usa comandos de shell para muchas de sus acciones. Si tu entorno
+hace uso extendido de alias o otro tipo de customizaciones, quizás
+encuentres algunos problemas. Antes de reportar bugs en el bug
+tracker, por favor prueba *sin* tus alias habilitados. Si puedes
+identificar el alias que causa el problema, ayudará a hacer a
+virtualenv más robusto.
+
+.. _license:
+
 ========
 Licencia
 ========

docs/source/plugins.rst

 es agregado para las extensiones que retornan código shell en vez de tomar una
 acción directamente (ver :ref:`plugins-user-env`).
 
+.. _plugins-get_env_details:
+
+get_env_details
+===============
+
+Los ganchos ``virtualenvwrapper.get_env_details`` son ejecutados
+cuando ``workon`` es ejecutado sin argumentos y una lista de entornos
+virtuales es impresa en pantalla. El gancho es ejecutado una vez para
+cada entorno, luego de que el nombre sea impreso, y puede ser
+utilizado para mostrar información adicional sobre ese entorno.
+
 .. _plugins-initialize:
 
 initialize

docs/source/projects.rst

+.. _project-management:
+
+============================
+ Administración de proyectos
+============================
+
+El :term:`directorio de proyecto` está asociado con un virtualenv,
+pero generalmente contiene el código fuente que se encuentra bajo
+desarrollo en vez de los componentes necesarios instalados para
+desarrollar. Por ejemplo, el directorio de proyecto puede contener el
+código fuente obtenido de un sistema de control de versiones,
+información temporal creada para testing, archivos experimentales aún
+no commiteados, etc.
+
+Un directorio de proyecto es creado y asociado a un virtualenv cuando
+es ejecutado :ref:`command-mkproject` en vez de
+:ref:`command-mkvirtualenv`. Para asociar un directorio de proyecto
+existente a un virtualenv, usa :ref:`command-setvirtualenvproject`.
+
+Usar templates
+==============
+
+Un nuevo directorio de proyecto puede ser creado vacío o llenado
+usando una o más extensiones :term:`template`. Los templates deben ser
+especificados como argumentos al comando
+:ref:`command-mkproject`. Multiples valores pueden ser provistos para
+aplicar más de un template. Por ejemplo, para obtener un repositorio
+Mercurial de un proyecto de bitbucket y crear un nuevo sitio Django,
+se pueden combinar los templates :ref:`templates-bitbucket` y
+:ref:`templates-django`
+
+::
+
+    $ mkproject -t bitbucket -t django my_site
+
+.. seealso::
+
+   * :ref:`extensions-templates`
+   * :ref:`variable-PROJECT_HOME`
+   * :ref:`variable-VIRTUALENVWRAPPER_PROJECT_FILENAME`

docs/source/scripts.rst

 (permitiéndoles modificar su entorno de shell) o *ejecutados* como un programa externo
 en el momento apropiado.
 
+Los scripts aplicados globalmente para todos los entornos deben ser
+ubicados en el directorio llamado :ref:`VIRTUALENVWRAPPER_HOOK_DIR
+<variable-VIRTUALENVWRAPPER_HOOK_DIR>`. Los scripts locales deben ser
+ubicados en el directorio ``bin`` del virtualenv.
+
+.. _scripts-get_env_details:
+
+get_env_details
+===============
+
+  :Global/Local: ambos
+  :Argumento(s): env name
+  :Incluido/Ejecutado: ejecutado
+
+``$VIRTUALENVWRAPPER_HOOK_DIR/get_env_details`` es ejecutado cuando
+``workon`` es ejecutado sin argumentos y una lista de entornos
+virtuales es impresa en pantalla. El gancho es ejecutado una vez por
+entorno, luego de que el nombre sea impreso, y puede imprimir
+información adicional sobre ese entorno.
+
 .. _scripts-initialize:
 
 initialize
   :Argumento(s): ninguno
   :Incluido/Ejecutado: incluido
 
-``$WORKON_HOME/initialize`` es incluido cuando ``virtualenvwrapper.sh``
+``$VIRTUALENVWRAPPER_HOOK_DIR/initialize`` es incluido cuando ``virtualenvwrapper.sh``
 es cargado dentro de tu entorno. Usa este para ajustar configuraciones globales
 cuando virtualenvwrapper es habilitado.
 
   :Argumento(s): nombre de un nuevo virtualenv
   :Incluido/Ejecutado: ejecutado
 
-``$WORKON_HOME/premkvirtualenv`` es ejecutado como un programa externo luego que
+``$VIRTUALENVWRAPPER_HOOK_DIR/premkvirtualenv`` es ejecutado como un programa externo luego que
 de un entorno virtual es creado pero antes de que el entorno actual sea cambiado
 para apuntar al nuevo entorno. El directorio de trabajo actual para este script
 es ``$WORKON_HOME`` y el nombre del nuevo entorno es pasado como argumento al
   :Argumento(s): ninguno
   :Incluido/Ejecutado: incluido
 
-``$WORKON_HOME/postmkvirtualenv`` es incluido después de que un nuevo entorno es
-creado y activado.
+``$VIRTUALENVWRAPPER_HOOK_DIR/postmkvirtualenv`` es incluido después
+de que un nuevo entorno es creado y activado. Si la opción ``-a``
+<ruta_del_proyecto> es usada, el enlace hacia el directorio del
+proyecto es hecho antes de que el script sea incluido.
 
 .. _scripts-precpvirtualenv:
 
   :Argumento(s): nombre del entorno original, nombre del nuevo entorno
   :Incluido/Ejecutado: ejecutado
 
-``$WORKON_HOME/precpvirtualenv`` es ejecutado como un programa externo luego de
+``$VIRTUALENVWRAPPER_HOOK_DIR/precpvirtualenv`` es ejecutado como un programa externo luego de
 que un entorno es duplicado y hecho reubicable, pero antes de que
 ``premkvirtualenv`` sea ejecutado o se haya cambiado al nuevo entorno creado. El
 directorio de trabajo actual para este script es ``$WORKON_HOME`` y los nombres
   :Argumento(s): ninguno
   :Incluido/Ejecutado: incluido
 
-``$WORKON_HOME/postcpvirtualenv`` es incluido luego de que un nuevo entorno es
+``$VIRTUALENVWRAPPER_HOOK_DIR/postcpvirtualenv`` es incluido luego de que un nuevo entorno es
 creado y activado.
 
 .. _scripts-preactivate:
   :Argumento(s): nombre de entorno
   :Incluido/Ejecutado: ejecutado
 
-El script global ``$WORKON_HOME/preactivate`` es ejecutado antes de que el nuevo
+El script global ``$VIRTUALENVWRAPPER_HOOK_DIR/preactivate`` es ejecutado antes de que el nuevo
 entorno sea habilitado. El nombre de entorno es pasado como primer argumento.
 
 El gancho ``$VIRTUAL_ENV/bin/preactivate`` es ejecutado antes de que el nuevo
   :Incluido/Ejecutado: incluido
 
 
-El script global ``$WORKON_HOME/postactivate`` es incluido luego de que el nuevo
+El script global ``$VIRTUALENVWRAPPER_HOOK_DIR/postactivate`` es incluido luego de que el nuevo
 entorno sea habilitado. ``$VIRTUAL_ENV`` hace referencia al nuevo entorno al
 momento en el que se ejecuta el script.
 
 configuraciones en tu entorno. ``$VIRTUAL_ENV`` hace referencia al entorno viejo
 al momento de ejecutar este script.
 
-El script global ``$WORKON_HOME/predeactivate`` es incluido antes de que el
+El script global ``$VIRTUALENVWRAPPER_HOOK_DIR/predeactivate`` es incluido antes de que el
 entorno actual sea desactivado. ``$VIRTUAL_ENV`` hace referencia al entorno viejo
 al momento de ejecutar este script.
 
   :Argumento(s): nombre de entorno
   :Incluido/Ejecutado: ejecutado
 
-EL script ``$WORKON_HOME/prermvirtualenv`` es ejecutado como un programa externo
+EL script ``$VIRTUALENVWRAPPER_HOOK_DIR/prermvirtualenv`` es ejecutado como un programa externo
 antes de que el entorno sea eliminado. El path absoluto hacia el entorno es
 pasado como argumento al script.
 
   :Argumento(s): nombre de entorno
   :Incluido/Ejecutado: ejecutado
 
-El script ``$WORKON_HOME/postrmvirtualenv`` es ejecutado como un programa externo
+El script ``$VIRTUALENVWRAPPER_HOOK_DIR/postrmvirtualenv`` es ejecutado como un programa externo
 luego de que el entorno sea eliminado. El path absoluto hacia el directorio del
 entorno es pasado como argumento al script.
 
+.. _scripts-premkproject:
+
+premkproject
+============
+
+  :Global/Local: global
+  :Argumento(s): nombre del nuevo proyecto
+  :Incluido/Ejecutado: ejecutado
+
+``$WORKON_HOME/premkproject`` es ejecutado como un programa externo
+luego de que el entorno virtual es creado y luego de que el entorno
+actual es cambiado al nuevo entorno, pero antes de que el nuevo
+directorio de proyecto sea creado. El directorio de trabajo actual
+para el script es ``$PROJECT_HOME`` y el nombre del nuevo proyecto es
+pasado como argumento al script.
+
+.. _scripts-postmkproject:
+
+postmkproject
+=============
+
+  :Global/Local: global
+  :Argumento(s): ninguno
+  :Incluido/Ejecutado: incluido
+
+``$WORKON_HOME/postmkproject`` es incluido luego de que el nuevo
+entorno y directorio de proyecto son creados y el virtualenv es
+activado. El directorio de trabajo es el directorio del proyecto.

docs/source/tips.rst

 =================================================================
 
 `Justin Lily escribió un post
-<http://justinlilly.com/blog/2009/mar/28/virtualenv-wrapper-helper/>`__
+<http://justinlilly.com/python/virtualenv_wrapper_helper.html>`__
 sobre algún código que agrego a su entorno de shell para buscar en el directorio
 cada vez que se ejecuta ``cd``. Si este encuentra un archivo llamado ``.venv``,
 activa el entorno nombrado dentro. Una vez que se deja el directorio, el