diff --git a/docs/guide-uk/README.md b/docs/guide-uk/README.md new file mode 100644 index 0000000..8b5a884 --- /dev/null +++ b/docs/guide-uk/README.md @@ -0,0 +1,26 @@ +Розширення Twitter Bootstrap для Yii 2 +====================================== + +З коробки Yii включає підтримку розмітки [Bootstrap 3](http://getbootstrap.com/) та компонентів фреймворку (також відомий як "Twitter Bootstrap"). +Bootstrap є чудовим, адаптивним фреймворком, який може значно прискорити процес розробки клієнтської частини сайту. + +Ядро Bootstrap представлене двома частинами: + +- Основи CSS, такі як система макету сітки, типографія, допоміжні класи і адаптивні утиліти. +- Готові до використання компоненти, такі як форми, меню, нумерація сторінок (pagination), модальні вікна, вкладки (tabs) і т.д. + +Початок роботи +-------------- + +* [Встановлення](installation.md) +* [Основи використання](basic-usage.md) + +Використання +------------ + +* [Віджети Yii](usage-widgets.md) + +Додаткові теми +-------------- + +* [Використання .less файлів в Bootstrap](topics-less.md) \ No newline at end of file diff --git a/docs/guide-uk/basic-usage.md b/docs/guide-uk/basic-usage.md new file mode 100644 index 0000000..ac06644 --- /dev/null +++ b/docs/guide-uk/basic-usage.md @@ -0,0 +1,16 @@ +Основи використання +=================== + +Yii не загортає основи bootstrap в код PHP, оскільки в цьому випадку, сам по собі HTML є дуже простим. +Ви можете знайти детальну інформацію про використання основ на [сайті документації bootstrap](http://getbootstrap.com/css/). +Проте Yii забезпечує зручний спосіб підключення ресурсів bootstrap до ваших сторінок за допомогою додання всього одного рядка до файлу +`AppAsset.php`, розташованого в каталозі `@app/assets`: + +```php +public $depends = [ + 'yii\web\YiiAsset', + 'yii\bootstrap\BootstrapAsset', // цей рядок +]; +``` + +Використання bootstrap через менеджер ресурсів Yii дозволяє мінімізувати свої ресурси і обʼєднати із вашими власними ресурсами коли це необхідно. \ No newline at end of file diff --git a/docs/guide-uk/installation.md b/docs/guide-uk/installation.md new file mode 100644 index 0000000..2a28810 --- /dev/null +++ b/docs/guide-uk/installation.md @@ -0,0 +1,20 @@ +Встановлення +============ + +## Отримання Composer пакету + +Кращим способом для встановлення даного розширення є встановлення через [composer](http://getcomposer.org/download/). + +Запустіть + +``` +php composer.phar require --prefer-dist yiisoft/yii2-bootstrap +``` + +або додайте + +``` +"yiisoft/yii2-bootstrap": "~2.0.0" +``` + +в потрібний розділ composer.json файлу. \ No newline at end of file diff --git a/docs/guide-uk/topics-less.md b/docs/guide-uk/topics-less.md new file mode 100644 index 0000000..c3ec265 --- /dev/null +++ b/docs/guide-uk/topics-less.md @@ -0,0 +1,17 @@ +Використання .less файлів в Bootstrap +===================================== + +Якщо ви хочете включити [CSS Bootstrap напряму до ваших less файлів](http://getbootstrap.com/getting-started/#customizing) +вам необхідно відключити завантаження оригінальних bootstrap css файлів. +Ви можете зробити це, встановивши CSS властивість [[yii\bootstrap\BootstrapAsset|BootstrapAsset]] порожньою. +Для цього вам необхідно налаштувати [компонент додатка](structure-application-components.md) `assetManager` наступним чином: + +```php + 'assetManager' => [ + 'bundles' => [ + 'yii\bootstrap\BootstrapAsset' => [ + 'css' => [], + ] + ] + ] +``` \ No newline at end of file diff --git a/docs/guide-uk/usage-widgets.md b/docs/guide-uk/usage-widgets.md new file mode 100644 index 0000000..c5faeb5 --- /dev/null +++ b/docs/guide-uk/usage-widgets.md @@ -0,0 +1,19 @@ +Віджети Yii +=========== + +Найбільш складні компоненти bootstrap загорнуті в Yii віджети, щоб забезпечити більш надійний синтаксис +та інтегрувати його з можливостями фреймворку. Всі віджети належать до простору імен `\yii\bootstrap`: + +- [[yii\bootstrap\ActiveForm|ActiveForm]] +- [[yii\bootstrap\Alert|Alert]] +- [[yii\bootstrap\Button|Button]] +- [[yii\bootstrap\ButtonDropdown|ButtonDropdown]] +- [[yii\bootstrap\ButtonGroup|ButtonGroup]] +- [[yii\bootstrap\Carousel|Carousel]] +- [[yii\bootstrap\Collapse|Collapse]] +- [[yii\bootstrap\Dropdown|Dropdown]] +- [[yii\bootstrap\Modal|Modal]] +- [[yii\bootstrap\Nav|Nav]] +- [[yii\bootstrap\NavBar|NavBar]] +- [[yii\bootstrap\Progress|Progress]] +- [[yii\bootstrap\Tabs|Tabs]] \ No newline at end of file