Merge pull request #56 from pana1990/update-guide

Update guide-es [skip ci]

docs/guide-es/README.md

@@ -20,6 +20,8 @@ Uso
 ---
 
 * [Yii widgets](usage-widgets.md)
+* [Html helper](helper-html.md)
+* [Asset Bundles](asset-bundles.md)
 
 Temas Adicionales
 -----------------

docs/guide-es/asset-bundles.md

@@ -0,0 +1,17 @@
+Asset Bundles
+=============
+
+Bootstrap es una completa solución front-end, que incluye CSS, JavaScript, fuentes y mucho más.
+Con el fin de permitir un control más flexible sobre los componentes de Bootstrap, esta extensión proporciona
+varios asset bundles.
+Ellos son:
+
+- [[yii\bootstrap\BootstrapAsset|BootstrapAsset]] - contiene unicamente los ficheros CSS principales.
+- [[yii\bootstrap\BootstrapPluginAsset|BootstrapPluginAsset]] - depende de [[yii\bootstrap\BootstrapAsset]], contiene ficheros javascript.
+- [[yii\bootstrap\BootstrapThemeAsset|BootstrapThemeAsset]] - depende de [[yii\bootstrap\BootstrapAsset]], contiene el tema CSS por defecto de Bootstrap.
+
+Particularmente las aplicaciones pueden necesitar requerir diferentes usos de bundle (o combinación de bundle).
+Si necesitas unicamente estilos CSS, [[yii\bootstrap\BootstrapAsset]] será suficiente para ti. Sin embargo, si
+quieres usar el JavaScript de Bootstrap, necesitas registrar [[yii\bootstrap\BootstrapPluginAsset]].
+
+> Consejo: la mayoría de los widgets registran automaticamente [[yii\bootstrap\BootstrapPluginAsset]].

docs/guide-es/helper-html.md

@@ -0,0 +1,29 @@
+Html helper
+===========
+
+Bootstrap introduce muchas construcciones y esqueletos consistentes de HTML, que permiten crear diferentes efectos visuales.
+Unicamente lo más complejo está cubierto por los widgets proporcionados en esta extensión. El resto debería ser
+compuesto manualmente usando HTML directamente.
+Sin embargo, algunas marcas especiales de Bootstrap son cubiertas por el helper [[\yii\bootstrap\Html]].
+[[\yii\bootstrap\Html]] es una versión mejorada de la regular [[\yii\helpers\Html]] dedicada a las necesidades de Bootstrap.
+Proporciona varios métodos útiles:
+
+ - `icon()` - permite renderizar iconos de Glyphicon
+ - `staticControl()` - permite renderizar formularios "static controls"
+
+[[\yii\bootstrap\Html]] hereda todas las funcionalidades disponibles en [[\yii\helpers\Html]] y puede usarse como sustituto,
+así que no es necesario incluir ambos dentro de los archivos de tus vistas.
+Por ejemplo:
+
+```php
+<?php
+use yii\bootstrap\Html;
+?>
+<?= Button::widget([
+    'label' => Html::icon('approve') . Html::encode('Save & apply'),
+    'encodeLabel' => false,
+    'options' => ['class' => 'btn-primary'],
+]); ?>
+```
+
+> Atención: no confundas [[\yii\bootstrap\Html]] con [[\yii\helpers\Html]], ten cuidado que clases estás usando dentro de tus vistas.

docs/guide-es/usage-widgets.md

@@ -18,3 +18,41 @@ al namespace `\yii\bootstrap`:
 - [[yii\bootstrap\NavBar|NavBar]]
 - [[yii\bootstrap\Progress|Progress]]
 - [[yii\bootstrap\Tabs|Tabs]]
+
+
+## Personalización de las clases css para los widget <span id="customizing-css-classes"></span>
+
+Los widgets permiten una rápida composición del HTML para los componentes de bootstrap que requieren las clases
+CSS de bootstrap.
+Las clases por defecto para un componente en particular serán añadidas automáticamente por los widgets, y las clases
+opcionales que quieres personalizar son frecuentemente soportadas a través de las propiedades de los widgets.
+
+Por ejemplo, puedas usar [[yii\bootstrap\Button::options]] para personalizar la apariencia de un botón.
+La clase 'btn' que se requiere para un botón será añadida automáticamente, por lo que no necesitas preocuparte
+por ello.
+Todo lo que necesitas es especificar una clase de botón en particular:
+
+```php
+echo Button::widget([
+    'label' => 'Action',
+    'options' => ['class' => 'btn-primary'], // produce la clase "btn btn-primary"
+]);
+```
+
+Sin embargo, a veces puede que tengas que remplazar las clases por defecto por las alternativas.
+Por ejemplo, el widget [[yii\bootstrap\ButtonGroup]] utiliza por defecto la clase 'btn-group' para el contenido del div, pero necesitas usar 'btn-group-vertical' en lugar de alinear los botones verticalmente.
+El uso directo de la opción 'class' simplemente añade 'btn-group-vertical' a 'btn-group, el cual producirá un resultado incorrecto.
+Con el fin de sobrescribir las clases por defecto de un widget, necesitas especificar la opción 'class' como un
+array que contiene la definición de la clase personalizada bajo la clave 'widget':
+
+```php
+echo ButtonGroup::widget([
+    'options' => [
+        'class' => ['widget' => 'btn-group-vertical'] // remplaza 'btn-group' con 'btn-group-vertical'
+    ],
+    'buttons' => [
+        ['label' => 'A'],
+        ['label' => 'B'],
+    ]
+]);
+```