Skip to content

Commit

Permalink
use id instead of name for anchor references in the guide
Browse files Browse the repository at this point in the history
  • Loading branch information
cebe committed Jan 25, 2015
1 parent 10ba056 commit 36bebbf
Show file tree
Hide file tree
Showing 257 changed files with 2,082 additions and 2,083 deletions.
20 changes: 10 additions & 10 deletions docs/guide-es/caching-data.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ if ($data === false) {
```


## Componentes de Caché <a name="cache-components"></a>
## Componentes de Caché <span id="cache-components"></span>

El almacenamiento de datos en caché depende de los llamados *cache components* (componentes de caché) los cuales
representan diferentes tipos de almacenamiento en caché, como por ejemplo en memoria, en archivos o en base de datos.
Expand Down Expand Up @@ -66,7 +66,7 @@ el código que utiliza la caché. Por ejemplo, podrías modificar la configuraci
> Nota: Puedes registrar múltiples componentes de aplicación de caché. El componente llamado `cache` es usado por defecto por muchas clases caché-dependiente (ej. [[yii\web\UrlManager]]).

### Almacenamientos de Caché Soportados <a name="supported-cache-storage"></a>
### Almacenamientos de Caché Soportados <span id="supported-cache-storage"></span>

Yii proporciona varios componentes de caché que pueden almacenar datos en diferentes medios. A continuación
se muestra un listado con los componentes de caché disponibles:
Expand All @@ -84,7 +84,7 @@ se muestra un listado con los componentes de caché disponibles:
> Nota: Puedes utilizar diferentes tipos de almacenamiento de caché en la misma aplicación. Una estrategia común es la de usar almacenamiento de caché en memoria para almacenar datos que son pequeños pero que son utilizados constantemente (ej. datos estadísticos), y utilizar el almacenamiento de caché en archivos o en base de datos para guardar datos que son grandes y utilizados con menor frecuencia (ej. contenido de página).

## API de Caché <a name="cache-apis"></a>
## API de Caché <span id="cache-apis"></span>

Todos los componentes de almacenamiento de caché provienen de la misma clase "padre" [[yii\caching\Cache]] y por lo tanto soportan la siguiente API:

Expand All @@ -111,7 +111,7 @@ $value2 = $cache['var2']; // equivalente a: $value2 = $cache->get('var2');
```


### Claves de Caché <a name="cache-keys"></a>
### Claves de Caché <span id="cache-keys"></span>

Cada elemento de datos almacenado en caché se identifica por una clave. Cuando se almacena un elemento de datos en la memoria caché, se debe especificar una clave. Más tarde, cuando se recupera el elemento de datos de la memoria caché, se debe proporcionar la clave correspondiente.

Expand Down Expand Up @@ -144,7 +144,7 @@ Cuando en un mismo almacenamiento en caché es utilizado por diferentes aplicaci
Para garantizar la interoperabilidad, deberían utilizarse sólo caracteres alfanuméricos.


### Caducidad de Caché <a name="cache-expiration"></a>
### Caducidad de Caché <span id="cache-expiration"></span>

Un elemento de datos almacenado en la memoria caché permanecerá en ella para siempre, a menos que sea removida de alguna manera debido a alguna directiva de caché (ej. el espacio de almacenamiento en caché está lleno y los datos más antiguos se eliminan). Para cambiar este comportamiento, podrías proporcionar un parámetro de caducidad al llamar [[yii\caching\Cache::set()|set()]] para guardar el elemento de datos. El parámetro nos indica por cuántos segundos el elemento se mantendrá válido en memoria caché. Cuando llames [[yii\caching\Cache::get()|get()]] para recuperar el elemento, si el tiempo de caducidad ha pasado, el método devolverá `false`, indicando que el elemento de datos no ha sido encontrado en la memoria caché. Por ejemplo,

Expand All @@ -161,7 +161,7 @@ if ($data === false) {
```


### Dependencias de Caché <a name="cache-dependencies"></a>
### Dependencias de Caché <span id="cache-dependencies"></span>

Además de configurar el tiempo de expiración, los datos almacenados en caché pueden también ser invalidados conforme a algunos cambios en la caché de dependencias. Por ejemplo, [[yii\caching\FileDependency]] representa la dependencia del tiempo de modificación del archivo. Cuando esta dependencia cambia, significa que el archivo correspondiente ha cambiado. Como resultado, cualquier contenido anticuado que sea encontrado en la caché debería ser invalidado y la llamada a [[yii\caching\Cache::get()|get()]] debería retornar falso.

Expand Down Expand Up @@ -191,7 +191,7 @@ Aquí abajo se muestra un sumario de las dependencias disponibles:
con el mismo nombre del grupo a la vez llamando a [[yii\caching\TagDependency::invalidate()]].


## Consultas en Caché <a name="query-caching"></a>
## Consultas en Caché <span id="query-caching"></span>

Las consultas en caché es una característica especial de caché construido sobre el almacenamiento de caché de datos. Se
proporciona para almacenar en caché el resultado de consultas a la base de datos.
Expand All @@ -213,7 +213,7 @@ El almacenamiento en caché de consultas se puede usar para [DAO](db-dao.md), as
> Nota: Algunos DBMS (ej. [MySQL](http://dev.mysql.com/doc/refman/5.1/en/query-cache.html)) también soporta el almacenamiento en caché desde el mismo servidor de la BD. Puedes optar por utilizar cualquiera de los mecanismos de memoria caché. El almacenamiento en caché de consultas previamente descrito tiene la ventaja que de que se puede especificar dependencias de caché de una forma flexible y son potencialmente mucho más eficientes.

### Configuraciones <a name="query-caching-configs"></a>
### Configuraciones <span id="query-caching-configs"></span>

Las consultas en caché tienen tres opciones configurables globales a través de [[yii\db\Connection]]:

Expand All @@ -224,7 +224,7 @@ Las consultas en caché tienen tres opciones configurables globales a través de
Por defecto es `'cache'`. El almacenamiento en caché de consultas se habilita sólo si hay un componente de la aplicación de caché válida.


### Usos <a name="query-caching-usages"></a>
### Usos <span id="query-caching-usages"></span>

Puedes usar [[yii\db\Connection::cache()]] si tienes multiples consultas SQL que necesitas a aprovechar el cacheo de consultas. El uso es de la siguiente manera,

Expand Down Expand Up @@ -287,7 +287,7 @@ $result = $db->cache(function ($db) {
```


### Limitaciones <a name="query-caching-limitations"></a>
### Limitaciones <span id="query-caching-limitations"></span>

El almacenamiento en caché de consultas no funciona con los resultados de consulta que contienen controladores de recursos.
Por ejemplo, cuando se utiliza el tipo de columna `BLOB` en algunos DBMS, el resultado de la consulta devolverá un recurso para manejar los datos de la columna.
Expand Down
14 changes: 7 additions & 7 deletions docs/guide-es/caching-fragment.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,14 +28,14 @@ Como en la [caché de datos](caching-data.md), un `$id` (clave) único es necesa
caché.


## Opciones de Caché <a name="caching-options"></a>
## Opciones de Caché <span id="caching-options"></span>

Puedes especificar opciones adicionales para la caché de fragmentos pasando el array de opciones como segundo
parametro del método [[yii\base\View::beginCache()|beginCache()]]. Entre bastidores, este array de opciones se utiliza
para configurar el widget [[yii\widgets\FragmentCache]] que es en realidad el que implementa la funcionalidad de la caché
de fragmentos.

### Duración <a name="duration"></a>
### Duración <span id="duration"></span>

Quizás la opción más utilizada en la caché de fragmentos es [[yii\widgets\FragmentCache::duration|duración]]. Ésta
especifica cuántos segundos el contenido puede permanecer como válido en la memoria caché. El siguiente código almacena
Expand All @@ -53,7 +53,7 @@ if ($this->beginCache($id, ['duration' => 3600])) {
Si la opción no está activada, se tomará el valor por defecto 60, lo que significa que el contenido almacenado en caché expirará en 60 segundos.


### Dependencias <a name="dependencies"></a>
### Dependencias <span id="dependencies"></span>

Como en la [caché de datos](caching-data.md#cache-dependencies), el fragmento de contenido que está siendo almacenado en caché
también puede tener dependencias. Por ejemplo, el contenido de un artículo que se muestre depende de si el mensaje se
Expand All @@ -78,7 +78,7 @@ if ($this->beginCache($id, ['dependency' => $dependency])) {
```


### Variaciones <a name="variations"></a>
### Variaciones <span id="variations"></span>

El contenido almacenado en caché puede variar de acuerdo a ciertos parámetros. Por ejemplo, para una aplicación Web que
soporte multiples idiomas, la misma pieza del código de la vista puede generar el contenido almacenado en caché
Expand All @@ -99,7 +99,7 @@ if ($this->beginCache($id, ['variations' => [Yii::$app->language]])) {
```


### Alternando el Almacenamiento en Caché <a name="toggling-caching"></a>
### Alternando el Almacenamiento en Caché <span id="toggling-caching"></span>

Puede que a veces quieras habilitar la caché de fragmentos únicamente cuando ciertas condiciones se cumplan. Por ejemplo,
para una página que muestra un formulario, tal vez quieras guardarlo en la caché cuando es inicialmente solicitado (a
Expand All @@ -117,7 +117,7 @@ if ($this->beginCache($id, ['enabled' => Yii::$app->request->isGet])) {
```


## Almacenamiento en Caché Anidada <a name="nested-caching"></a>
## Almacenamiento en Caché Anidada <span id="nested-caching"></span>

El almacenamiento en caché de fragmentos se puede anidar. Es decir, un fragmento de caché puede ser encerrado dentro de
otro fragmento que también se almacena en caché. Por ejemplo, los comentarios se almacenan en una caché de fragmento
Expand Down Expand Up @@ -151,7 +151,7 @@ dependencias de las cachés anidadas, de lo contrario los fragmentos internos qu
manteniendo en el fragmento externo.


## Contenido Dinámico <a name="dynamic-content"></a>
## Contenido Dinámico <span id="dynamic-content"></span>

Cuando se usa la caché de fragmentos, podrías encontrarte en la situación que un fragmento grande de contenido es
relavitamente estático excepto en uno u otro lugar. Por ejemplo, la cabeza de una página (header) puede que muestre el
Expand Down
10 changes: 5 additions & 5 deletions docs/guide-es/caching-http.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ consultas:
* [[yii\filters\HttpCache::cacheControlHeader|Cache-Control]]


## La Cabecera `Last-Modified` <a name="last-modified"></a>
## La Cabecera `Last-Modified` <span id="last-modified"></span>

La cabecera `Last-Modified` usa un sello de tiempo para indicar si la página ha sido modificada desde que el cliente la
almacena en la caché.
Expand Down Expand Up @@ -59,7 +59,7 @@ regenerar la página, y el navegador usará la versión caché del lado del clie
lado del servidor y la transmisión del contenido de la página son ambos omitidos.


## La Cabecera `ETag` <a name="etag"></a>
## La Cabecera `ETag` <span id="etag"></span>

La cabecera "Entity Tag" (o para abreviar `ETag`) usa un hash para representar el contenido de una página. Si la página
ha sido cambiada, el hash también cambiará. Al comparar el hash guardado en el lado del cliente con el hash generado en
Expand Down Expand Up @@ -113,7 +113,7 @@ expresión sencilla para invalidar la caché si la página ha sido modificada.
> Nota: En cumplimiento con [RFC 7232](http://tools.ietf.org/html/rfc7232#section-2.4),
`HttpCache` enviará ambas cabeceras `ETag` y `Last-Modified` si ambas están configuradas. Y si el clientes envía tanto la cabecera `If-None-Match` como la cabecera `If-Modified-Since`, solo la primera será respetada.

## La Cabecera `Cache-Control` <a name="cache-control"></a>
## La Cabecera `Cache-Control` <span id="cache-control"></span>

La cabecera `Cache-Control` especifica la directiva general de la caché para páginas. Puedes enviarla configurando la
propiedad [[yii\filters\HttpCache::cacheControlHeader]] con el valor de la cabecera. Por defecto, la siguiente cabecera
Expand All @@ -123,7 +123,7 @@ será enviada:
Cache-Control: public, max-age=3600
```

## Limitador de la Sesión de Caché <a name="session-cache-limiter"></a>
## Limitador de la Sesión de Caché <span id="session-cache-limiter"></span>

Cuando una página utiliza la sesión, PHP enviará automáticamente cabeceras HTTP relacionadas con la caché tal y como se
especifican en `session.cache_limiter` de la configuración INI de PHP. Estas cabeceras pueden interferir o deshabilitar
Expand All @@ -134,7 +134,7 @@ automáticamente el envío de estas cabeceras. Si deseas modificar este comporta
para una mejor explicación sobre esos valores.


## Implicaciones SEO <a name="seo-implications"></a>
## Implicaciones SEO <span id="seo-implications"></span>

Los robots de motores de búsqueda tienden a respetar las cabeceras de caché. Dado que algunos `crawlers` tienen limitado
el número de páginas que pueden rastrear por dominios dentro de un cierto período de tiempo, la introducción de cabeceras
Expand Down
10 changes: 5 additions & 5 deletions docs/guide-es/concept-aliases.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ en tu código. Un alias debe comenzar con un cáracter `@` para que así pueda s
Por ejemplo, el alias `@yii` representa la ruta de instalación de la librería Yii, mientras que `@web` representa la
URL base la aplicación que actualmente se está ejecutando.

Definiendo Alias <a name="defining-aliases"></a>
Definiendo Alias <span id="defining-aliases"></span>
----------------

Puedes llamar a [[Yii::setAlias()]] para definir un alias para una determinada ruta de archivo o URL. Por ejemplo,
Expand Down Expand Up @@ -48,7 +48,7 @@ return [
```


Resolución de Alias <a name="resolving-aliases"></a>
Resolución de Alias <span id="resolving-aliases"></span>
-------------------

Puedes llamar [[Yii::getAlias()]] para resolver un alias de raíz en la ruta o URL que representa. El mismo método puede
Expand Down Expand Up @@ -80,7 +80,7 @@ Yii::getAlias('@foo/bar/file.php'); // muestra: /path2/bar/file.php
Si `@foo/bar` no está definido como un alias de raíz, la última declaración mostraría `/path/to/foo/bar/file.php`.


Usando Alias <a name="using-aliases"></a>
Usando Alias <span id="using-aliases"></span>
------------

Los alias son utilizados en muchos lugares en Yii sin necesidad de llamar [[Yii::getAlias()]] para convertirlos en rutas/URLs.
Expand All @@ -98,7 +98,7 @@ $cache = new FileCache([
Por favor, presta atención a la documentación API para ver si una propiedad o el parámetro de un método soporta alias.


Alias Predefinidos <a name="predefined-aliases"></a>
Alias Predefinidos <span id="predefined-aliases"></span>
------------------

Yii predefine un conjunto de alias para aliviar la necesidad de hacer referencia a rutas de archivo o URLs que son
Expand All @@ -118,7 +118,7 @@ mientras que el resto de los alias están definidos en el constructor de la apli
[configuración](concept-configurations.md) de la aplicación.


Alias en Extensiones <a name="extension-aliases"></a>
Alias en Extensiones <span id="extension-aliases"></span>
--------------------

Un alias se define automaticamente por cada [extensión](structure-extensions.md) que ha sido instalada a través de Composer.
Expand Down
8 changes: 4 additions & 4 deletions docs/guide-es/concept-autoloading.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ El cargador se instala cuando incluyes el archivo `Yii.php`.
ten en cuenta que el contenido que describimos aquí también se aplica a la autocarga de interfaces y rasgos (Traits).


Usando el Autocargador de Yii <a name="using-yii-autoloader"></a>
Usando el Autocargador de Yii <span id="using-yii-autoloader"></span>
-----------------------------

Para utilizar el cargador automático de clases de Yii, deberías seguir dos reglas básicas cuando desarrolles y nombres tus
Expand Down Expand Up @@ -40,7 +40,7 @@ poner las clases `front-end` bajo el espacio de nombres `frontend` mientras que
`backend`. Esto permitirá que estas clases sean automaticamente cargadas por el autocargador de Yii.


Mapa de Clases <a name="class-map"></a>
Mapa de Clases <span id="class-map"></span>
--------------

El autocargador de clases de Yii soporta el *mapa de clases*, que mapea nombres de clases to sus correpondientes rutas de
Expand All @@ -59,7 +59,7 @@ clases en el proceso [bootstrapping](runtime-bootstrapping.md) de la aplicación
antes de que tus clases sean usadas.


Usando otros Autocargadores <a name="using-other-autoloaders"></a>
Usando otros Autocargadores <span id="using-other-autoloaders"></span>
---------------------------

Debido a que Yii incluye Composer como un gestor de dependencias y extensions, es recomendado que también instales el
Expand All @@ -85,7 +85,7 @@ ser autocargables.
incluirlo en tu [script de entrada](structure-entry-scripts.md).


Carga Automática de Clases de Extensiones <a name="autoloading-extension-classes"></a>
Carga Automática de Clases de Extensiones <span id="autoloading-extension-classes"></span>
-----------------------------------------

El autocargador de Yii es capaz de autocargar clases de [extensiones](structure-extensions.md). El único requirimiento es
Expand Down
16 changes: 8 additions & 8 deletions docs/guide-es/concept-behaviors.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ comportamiento puede responder a [eventos](concept-events.md) disparados por el
o adaptar a la ejecución normal del código del componente.


Definiendo comportamientos <a name="defining-behaviors"></a>
Definiendo comportamientos <span id="defining-behaviors"></span>
--------------------------

Para definir un comportamiento, se debe crear una clase que exiende [[yii\base\Behavior]], o se extiende una clase hija. Por ejemplo:
Expand Down Expand Up @@ -95,7 +95,7 @@ function ($event) {
```


Vinculando Comportamientos <a name="attaching-behaviors"></a>
Vinculando Comportamientos <span id="attaching-behaviors"></span>
--------------------------

Puedes vincular un comportamiento a un [[yii\base\Component|componente]] ya sea estática o dinámicamente. La primera forma
Expand Down Expand Up @@ -189,7 +189,7 @@ También puedes asociar comportamientos a traves de [configuraciones](concept-co
Para más detalles, por favor visita la sección [Configuraciones](concept-configurations.md#configuration-format).


Usando comportamientos <a name="using-behaviors"></a>
Usando comportamientos <span id="using-behaviors"></span>
----------------------

Para poder utilizar un comportamiento, primero tienes que unirlo a un [[yii\base\Component|componente]] según las instrucciones anteriores. Una vez que un comportamiento ha sido vinculado a un componente, su uso es sencillo.
Expand Down Expand Up @@ -230,7 +230,7 @@ $behaviors = $component->getBehaviors();
```


Desasociar Comportamientos <a name="detaching-behaviors"></a>
Desasociar Comportamientos <span id="detaching-behaviors"></span>
--------------------------

Para desasociar un comportamiento, puedes llamar el método [[yii\base\Component::detachBehavior()]] con el nombre con el
Expand All @@ -247,7 +247,7 @@ $component->detachBehaviors();
```


Utilizando `TimestampBehavior` <a name="using-timestamp-behavior"></a>
Utilizando `TimestampBehavior` <span id="using-timestamp-behavior"></span>
-----------------------------

Para terminar, vamos a echar un vistazo a [[yii\behaviors\TimestampBehavior]]. Este comportamiento soporta de forma
Expand Down Expand Up @@ -306,15 +306,15 @@ $user->touch('login_time');
```


Comparación con Traits <a name="comparison-with-traits"></a>
Comparación con Traits <span id="comparison-with-traits"></span>
----------------------

Mientras que los comportamientos son similares a [traits](http://www.php.net/traits) en cuanto que ambos "inyectan" sus
métodos y propiedades a la clase primaria, son diferentes en muchos aspectos. Tal y como se describe abajo, los dos
tienen sus ventajas y desventajas. Son más como complementos el uno al otro en lugar de alternativas.


### Razones para utilizar comportamientos <a name="pros-for-behaviors"></a>
### Razones para utilizar comportamientos <span id="pros-for-behaviors"></span>

Las clases de comportamientos, como todas las clases, soportan herencias. Traits, por otro lado, pueden ser
considerados como un copia-y-pega de PHP. Ellos no soportan la herencia de clases.
Expand All @@ -331,7 +331,7 @@ automáticamente resuelto respetando al que ha sido asociado primero.
El conflicto de nombres en traits requiere que manualmente sean resueltos cambiando el nombre de las propiedades o métodos afectados.


### Razones para utilizar los Traits <a name="pros-for-traits"></a>
### Razones para utilizar los Traits <span id="pros-for-traits"></span>

Los Traits son mucho más eficientes que los comportamientos debido a que los últimos son objetos que consumen tiempo y
memoria.
Expand Down
Loading

0 comments on commit 36bebbf

Please sign in to comment.