Skip to content

Revisión de installation.md y render-function.md #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 18 additions & 18 deletions src/v2/guide/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,29 +11,29 @@ ro_gz_size: "17.14"

### Notas de compatibilidad

Vue **no** está soportado en IE8 ni versiones anteriores, porque utiliza características de ECMAScript 5 que son irreproducibles en ellos. Sin embargo soporta todos los [navegadores compatibles con ECMAScript 5](http://caniuse.com/#feat=es5).
Vue **no** da soporte a IE8 ni versiones anteriores, ya que utiliza características de ECMAScript 5 que son irreproducibles en ellos. Sin embargo, soporta todos los [navegadores compatibles con ECMAScript 5](http://caniuse.com/#feat=es5).

### Notas de lanzamiento

Se pueden encontrar notas de lanzamiento detalladas para cada versión en [GitHub](https://github.com/vuejs/vue/releases).

## Versión independiente

Simplemente descargala e incluyela con una etiqueta script. `Vue` se registrará como una variable global.
Sencillamente descárgala e inclúyela con una etiqueta script. `Vue` se registrará como una variable global.

<p class="tip">No utilices la versión minificada durante el desarrollo. ¡Perderás todas las advertencias para los errores comunes!</p>
<p class="tip">No utilices la versión minificada durante el desarrollo. ¡Te perderás todas las advertencias para los errores más comunes!</p>

<div id="downloads">
<a class="button" href="/js/vue.js" download>Versión de desarrollo</a><span class="light info">Con todas las advertencias y el modo depuración.</span>
<a class="button" href="/js/vue.js" download>Versión de desarrollo</a><span class="light info">Con todas las advertencias y en modo de depuración.</span>

<a class="button" href="/js/vue.min.js" download>Versión de producción</a><span class="light info">Advertencias eliminadas, {{gz_size}}kb min+gzip</span>
</div>

### CDN

Recomendación: [unpkg](https://unpkg.com/vue/dist/vue.js), el cual contendrá la última versión apenas haya sido publicada en npm. También puedes explorar el código fuente del paquete npm en [unpkg.com/vue/](https://unpkg.com/vue/).
Recomendación: [unpkg](https://unpkg.com/vue/dist/vue.js), el cual contiene la última versión disponible, apenas se haya publicado en npm. También puedes explorar el código fuente del paquete npm en [unpkg.com/vue/](https://unpkg.com/vue/).

También se encuentra disponible en [jsdelivr](//cdn.jsdelivr.net/vue/{{vue_version}}/vue.js) o [cdnjs](//cdnjs.cloudflare.com/ajax/libs/vue/{{vue_version}}/vue.js), pero estos dos servicios pueden tardar algún tiempo en sincronizar, por lo que la última versión puede no estar disponible todavía.
También se encuentra disponible en [jsdelivr](//cdn.jsdelivr.net/vue/{{vue_version}}/vue.js) o [cdnjs](//cdnjs.cloudflare.com/ajax/libs/vue/{{vue_version}}/vue.js), pero éstos dos servicios pueden tardar algún tiempo en sincronizarse, por lo que la última versión puede no estar disponible todavía.

## NPM

Expand All @@ -45,15 +45,15 @@ $ npm install vue
```
### Versión independiente vs. versión _Runtime-only_

Hay dos versiones disponibles, la independiente y la _runtime-only_. La diferencia es que la primera incluye un **compilador de plantillas** y la última no.
Hay dos versiones disponibles: la independiente y la _runtime-only_. La diferencia entre ellas está en que la primera incluye un **compilador de plantillas** y la última no.

El compilador de plantillas es responsable de compilar plantillas de Vue en funciones de renderizado de JavaScript puro. Si deseas utilizar la opción `template`, entonces necesitas el compilador.
El compilador de plantillas es el responsable de compilar las plantillas de Vue en funciones de renderizado de JavaScript puro. Si deseas utilizar la opción `template`, entonces necesitarás el compilador.

- La versión independiente incluye el compilador y soporta la opción `template`. **También depende de la presencia de APIs del navegador, por lo que no puedes usarlo para renderizado del lado servidor.**
- La versión independiente incluye el compilador y brinda soporte a la opción `template`. **También depende de la presencia de las APIs del navegador, por lo que no puedes usarlo para el renderizado del lado servidor.**

- La versión _runtime-only_ no incluye el compilador de plantillas y no soporta la opción `template`. Solo puedes utilizar la opción `render` cuando estás utilizando esta versión, pero funciona con componentes de un solo archivo, porque las plantillas de los componentes de un solo archivo son pre-compiladas en funciones `render` durante la etapa de construcción. La versión _runtime-only_ es aproximadamente 30% más liviana que la versión independiente, ocupando solo {{ro_gz_size}}kb min+gzip.
- La versión _runtime-only_ no incluye el compilador de plantillas y no brinda soporte a la opción `template`. Solo puedes utilizar la opción `render` cuando estés utilizando esta versión, pero funcionará con componentes de un solo archivo, ya que las plantillas con componentes de un solo archivo son pre-compiladas en funciones `render` durante su etapa de construcción. La versión _runtime-only_ es aproximadamente 30% más liviana que la versión independiente, ocupando tan solo {{ro_gz_size}}kb min+gzip.

Por defecto, el paquete NPM exporta la versión **runtime-only**. Para utilizar la versión independiente, añade el siguiente alias en tu archivo de configuración de Webpack:
De forma predeterminada, el gestor NPM exporta la versión **runtime-only**. Para utilizar la versión independiente, añade el siguiente alias a tu archivo de configuración de Webpack:

``` js
resolve: {
Expand All @@ -71,17 +71,17 @@ Para Browserify, puedes añadir un alias a tu archivo package.json:
},
```

<p class="tip">No realices un `import Vue from 'vue/dist/vue.js'` - dado que algunas herramientas en bibliotecas de terceros pueden también importar vue y podría causar que la aplicación intente cargar ambas versiones al mismo tiempo, conduciendo a errores.</p>
<p class="tip">No realices un `import Vue from 'vue/dist/vue.js'` - dado que algunas herramientas en librerías de terceros pueden también importar vue, lo que podría causar que la aplicación intente cargar ambas versiones al mismo tiempo, conduciendo con ello a errores.</p>

### Ambientes CSP

Algunos ambientes, como las aplicaciones de Google Chrome, imponen las Políticas de Seguridad de Contenido (CSP por sus siglas en inglés), las cuales prohiben el uso de `new Function()` para la evaluación de expresiones. La versión independiente depende de esta característica para compilar plantillas, por lo que no es posible utilizarla en estos ambientes.
En algunos ambientes, como las aplicaciones de Google Chrome, imponen las Políticas de Seguridad de Contenido (CSP por sus siglas en inglés), las cuales prohíben el uso de `new Function()` para la evaluación de expresiones. La versión independiente depende de ésta característica para compilar las plantillas, por lo que no es posible utilizarla en estos ambientes.

Por otro lado, la versión _runtime-only_ es completamente compatible con CSP. Cuando utilices la versión _runtime-only_ [Webpack + vue-loader](https://github.com/vuejs-templates/webpack-simple) o [Browserify + vueify](https://github.com/vuejs-templates/browserify-simple), tus plantillas serán pre-compiladas en funciones `render` las cuales funcionan perfectamente en ambientes CSP.
Por otro lado, la versión _runtime-only_ es completamente compatible con CSP. Cuando utilices la versión _runtime-only_ [Webpack + vue-loader](https://github.com/vuejs-templates/webpack-simple) o [Browserify + vueify](https://github.com/vuejs-templates/browserify-simple), tus plantillas serán precompiladas en funciones `render` las cuales funcionan perfectamente en ambientes CSP.

## CLI

Vue.js provee una [CLI oficial](https://github.com/vuejs/vue-cli) para estructurar rápidamente Aplicaciones de una Sola Página (SPA por sus siglas en inglés). Provee configuraciones _todo-en-uno_ para un flujo de trabajo frontend moderno. Solo toma unos minutos estar preparado para el desarrollo con: recarga en caliente, _lint-on-save_ y versiones listas para producción:
Vue.js provee una [CLI oficial](https://github.com/vuejs/vue-cli) para estructurar rápidamente Aplicaciones de una Sola Página (SPA por sus siglas en inglés), así como provee configuraciones _todo-en-uno_ para un flujo de trabajo frontend moderno. Tomará solo unos minutos estar preparado para desarrollar aplicaciones con: _hot-reload_, _lint-on-save_ y versiones listas para producción:

``` bash
# Instala vue-cli
Expand All @@ -94,11 +94,11 @@ $ npm install
$ npm run dev
```

<p class="tip">La _CLI_ asume un conocimiento previo de Node.js y las herramientas de trabajo asociadas. Si eres principiante con Vue o las herramientas de desarrollo front-end, te recomendamos fervientemente leer <a href="./">la guía</a> sin ninguna herramienta de desarrollo previo a usar la _CLI_.</p>
<p class="tip">La _CLI_ asume un conocimiento previo de Node.js y las herramientas de trabajo asociadas. Si eres principiante con Vue o las herramientas de desarrollo frontend, te recomendamos fervientemente leer <a href="./">la guía</a> sin ninguna herramienta de desarrollo previo antes de usar la _CLI_.</p>

## Versión desarrollo
## Versión de desarrollo

**Importante**: los archivos construidos dentro de la carpeta `/dist` de GitHub son compiladas solo durante lanzamientos. Para utilizar el código fuente más reciente de Vue en GitHub, ¡tendrás que construirlo tú mismo!
**Importante**: los archivos construidos dentro de la carpeta `/dist` de GitHub son compilados solo durante los lanzamientos. Para utilizar el código fuente más reciente de Vue en GitHub, ¡tendrás que construirlo tú mismo!

``` bash
git clone https://github.com/vuejs/vue.git node_modules/vue
Expand Down
Loading