Add guide on classic frontend

guide/en/README.md

@@ -1,6 +1,6 @@
 # The definitive guide to Yii 3.0
 
 We release this guide under the [Terms of Yii Documentation](https://www.yiiframework.com/license#docs).
 
 Introduction +
 ------------
@@ -46,7 +46,7 @@
 Handling requests +
 -----------------
 
 * [Routing and URL generation](runtime/routing.md) +
 * [Request](runtime/request.md) +
 * [Response](runtime/response.md) +
 * [Sessions](runtime/sessions.md) +
@@ -58,20 +58,18 @@
 -----
 
 * [Views](views/view.md) -
-* [Widgets](views/widget.md) -
-* [Assets](views/asset.md) -
-* [Working with client scripts](views/client-scripts.md) -
-* [Theming](views/theming.md) -
 * [Template engines](views/template-engines.md) -
 * [View injections](views/view-injections.md) +
-
+* [Scripts, styles and metatags](views/script-style-meta.md)
+* [Assets](views/asset.md) -
+* [Widgets](views/widget.md) -
 
 Working with databases +-
 ----------------------
 
 * [Database access objects](db-dao.md): Connecting to a database, basic queries, transactions, and schema manipulation
 * [Query builder](db-query-builder.md): Querying the database using a simple abstraction layer
 * [Active record](db-active-record.md): The Active Record ORM, retrieving and manipulating records, and defining relations
 * [Migrations](databases/db-migrations.md): +
 
 Getting data from users -
@@ -113,7 +111,7 @@
 * [HTTP caching](caching/http.md) -
 
 
 REST APIs -
 -----------
 
 * [Quick start](rest/quick-start.md)

guide/en/views/asset.md

@@ -0,0 +1,5 @@
+# Assets
+
+> [!NOTE]
+> [← Scripts, styles and metatags](script-style-meta.md) |
+> [Widgets →](widget.md)

guide/en/views/script-style-meta.md

@@ -0,0 +1,5 @@
+# Scripts, styles and metatags
+
+> [!NOTE]
+> [← View injections](view-injections.md) |
+> [Assets →](asset.md)

guide/en/views/template-engines.md

@@ -0,0 +1,69 @@
+# Template engines
+
+Yii views support multiple template engines as well as custom engines. By default, Yii uses the PHP engine.
+Additionally, [Twig](https://twig.symfony.com/) is available.
+
+## PHP
+
+PHP engine is available by default. The following is the basic template syntax:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+use Yiisoft\Html\Html;
+
+/**
+ * @var App\Blog\Post[] $posts 
+ */
+?>
+
+Posts:
+
+<dl>
+<?php foreach ($posts as $post): ?>
+    <dt>Title: <?= Html::encode($post->getTitle()) ?></dt>
+    <dd>Description: <?= Html::encode($post->getDescription()) ?></dd>
+<?php endforeach; ?>
+</dl>
+```
+
+At the very top of the template, you can define "uses" for classes to use and declare the type of variables 
+so the IDE understands them. The rest is the PHP code.
+
+> [!WARNING]
+> `<?=` or `echo` doesn't automatically encode variables for safe use with HTML and you should take care of it by using
+> `Html::encode()`.
+
+If you need a sub-view, you can use it like this:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+/** 
+ * @var Yiisoft\View\View $this
+ * @var App\Blog\Post[] $posts 
+ */
+?>
+
+Title
+
+<?= $this->render('blog/posts', ['posts' => $posts]) ?>
+```
+
+### See also
+
+- [yiisoft/view docs](https://github.com/yiisoft/view/blob/master/docs/guide/en/README.md).
+- 
+
+## Twig
+
+To use Twig, you need to install the [yiisoft/yii-twig](https://github.com/yiisoft/yii-twig).
+
+
+> [!NOTE]
+> [← Views](view.md) |
+> [View injections →](view-injections.md)

guide/en/views/view-injections.md

@@ -1,9 +1,16 @@
 # View injections
 
 The view injections are designed to provide a standardized way to pass parameters to the common layer
-of views in an application. Implementing this interface allows developers to manage the data that will be available
+of views in an application. It allows developers to manage the data that will be available
 across various views, ensuring flexibility and reusability of code.
 
+The view injections could be used if you require `yiisoft/yii-view-renderer` package:
+
+
+```sh
+composer require yiisoft/yii-view-renderer
+```
+
 ## Configuration
 
 In config `params.php`:
@@ -57,10 +64,10 @@
     ],
 ```
 
 ## Using Separate Injections for Different Layouts
 
 If your application has multiple layouts, you can create separate parameter injections for each layout. This approach
 allows you to tailor the parameters injected into each layout according to its specific needs, enhancing the flexibility
 and maintainability of your application.
 
 Create your custom ViewInjection for a specific layout:
@@ -81,7 +88,7 @@
 }
 ```
 
 Add your new injection to `params.php` under specific layout name. In the following example, it is `@layout/cart`:
 
 ```php
 'yiisoft/yii-view' => [
@@ -101,3 +108,7 @@
         ],
     ],
 ```
+
+> [!NOTE]
+> [← Template engines](template-engines.md) |
+> [Scripts, styles and metatags →](script-style-meta.md)

guide/en/views/view.md

@@ -0,0 +1,55 @@
+# Views
+
+Yii3 views could be used by requiring the `yiisoft/view` package:
+
+```sh
+composer require yiisoft/view
+```
+
+The package provides template rendering abstraction supporting layout-view-subview hierarchy, custom renderers
+with PHP-based as default, and more.
+
+Usage is the following:
+
+```php
+```
+
+If you're building a web application, you should require the `yiisoft/yii-view-renderer` package as well:
+
+```sh
+composer require yiisoft/yii-view-renderer
+```
+
+It provides some extra web-specific functionality and adds compatibility with PSR-7 interfaces and could be used like
+the following:
+
+```php
+<?php
+
+declare(strict_types=1);
+
+namespace App\Controller\HomePage;
+
+use Psr\Http\Message\ResponseInterface;
+use Yiisoft\Yii\View\Renderer\ViewRenderer;
+
+final readonly class Action
+{
+    public function __construct(
+        private ViewRenderer $viewRenderer,
+    ) {}
+
+    public function __invoke(): ResponseInterface
+    {
+        return $this->viewRenderer->render(__DIR__ . '/template', [
+            'name' => 'Sergei',
+            'surname' => 'Predvoditelev',
+        ]);
+    }
+}
+```
+
+In both cases a template file should be supplied. The template syntax depends on the template engine used.
+
+> [!NOTE]
+> [Template engines →](template-engines.md)

guide/en/views/widget.md

@@ -0,0 +1,5 @@
+# Widgets
+
+
+> [!NOTE]
+> [← Assets](asset.md)