Fix GitHub Pages workflow

.editorconfig

@@ -12,3 +12,6 @@ trim_trailing_whitespace = true
 
 [*.md]
 trim_trailing_whitespace = false
+
+[*.yml]
+indent_size = 2

.github/workflows/jekyll-gh-pages.yml

@@ -1,28 +1,21 @@
-# Sample workflow for building and deploying a Jekyll site to GitHub Pages
 name: Deploy Jekyll with GitHub Pages dependencies preinstalled
 
 on:
-  # Runs on pushes targeting the default branch
+  pull_request: # TEMPORARY !!!
   push:
     branches: ["master"]
-
-  # Allows you to run this workflow manually from the Actions tab
   workflow_dispatch:
 
-# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
 permissions:
   contents: read
   pages: write
   id-token: write
 
-# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
-# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
 concurrency:
   group: "pages"
   cancel-in-progress: false
 
 jobs:
-  # Build job
   build:
     runs-on: ubuntu-latest
     steps:
@@ -38,7 +31,6 @@ jobs:
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
 
-  # Deployment job
   deploy:
     environment:
       name: github-pages

_config.yml

@@ -1,5 +1,3 @@
 defaults:
-    - scope:
-          path: ""
-      values:
-          render_with_liquid: false
+  - scope:
+      path: ""

_translations/guide/po/es/start_workflow.md.po

@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2025-10-19 11:32+0000\n"
+"POT-Creation-Date: 2025-12-20 13:19+0000\n"
 "PO-Revision-Date: 2025-09-04 11:19+0500\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -40,7 +40,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/start/workflow.md
-msgid "The installed application has only the homepage, which displays when you access the URL `http://localhost/`.  It shares a common layout that you can reuse on further pages."
+msgid "The installed application contains only one page, accessible at `http://localhost/`.  It shares a common layout that you can reuse on further pages."
 msgstr ""
 
 #. type: Plain text
@@ -133,9 +133,24 @@ msgstr ""
 msgid "The following diagram shows how an application handles a request."
 msgstr ""
 
-#. type: Plain text
+#. type: Fenced code block (mermaid)
 #: ../../guide/en/start/workflow.md
-msgid "![Request Lifecycle](img/request-lifecycle.svg)"
+#, no-wrap
+msgid ""
+"flowchart LR\n"
+"  user[User's client] --> index\n"
+"  index[index.php] --> DI[Initialize Dependency Container]\n"
+"  config[configs] -.-> DI\n"
+"  DI --> RequestFactory[RequestFactory]\n"
+"  RequestFactory -->|Request| app[Application]\n"
+"  app -->|Request| middleware[Middleware]\n"
+"  middleware -->|Request| router[Router]\n"
+"  router -->|Request| action[Action Handler]\n"
+"  action -->|Response| emitter[SapiEmitter]\n"
+"  router -->|Response| emitter\n"
+"  middleware -->|Response| emitter\n"
+"  app -->|Response| emitter\n"
+"  emitter --> user\n"
 msgstr ""
 
 #. type: Bullet: '1. '

_translations/guide/po/id/start_workflow.md.po

@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2025-10-19 11:32+0000\n"
+"POT-Creation-Date: 2025-12-20 13:19+0000\n"
 "PO-Revision-Date: 2025-09-04 11:19+0500\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -39,7 +39,7 @@ msgstr ""
 
 #. type: Plain text
 #: ../../guide/en/start/workflow.md
-msgid "The installed application has only the homepage, which displays when you access the URL `http://localhost/`.  It shares a common layout that you can reuse on further pages."
+msgid "The installed application contains only one page, accessible at `http://localhost/`.  It shares a common layout that you can reuse on further pages."
 msgstr ""
 
 #. type: Plain text
@@ -132,9 +132,24 @@ msgstr ""
 msgid "The following diagram shows how an application handles a request."
 msgstr ""
 
-#. type: Plain text
+#. type: Fenced code block (mermaid)
 #: ../../guide/en/start/workflow.md
-msgid "![Request Lifecycle](img/request-lifecycle.svg)"
+#, no-wrap
+msgid ""
+"flowchart LR\n"
+"  user[User's client] --> index\n"
+"  index[index.php] --> DI[Initialize Dependency Container]\n"
+"  config[configs] -.-> DI\n"
+"  DI --> RequestFactory[RequestFactory]\n"
+"  RequestFactory -->|Request| app[Application]\n"
+"  app -->|Request| middleware[Middleware]\n"
+"  middleware -->|Request| router[Router]\n"
+"  router -->|Request| action[Action Handler]\n"
+"  action -->|Response| emitter[SapiEmitter]\n"
+"  router -->|Response| emitter\n"
+"  middleware -->|Response| emitter\n"
+"  app -->|Response| emitter\n"
+"  emitter --> user\n"
 msgstr ""
 
 #. type: Bullet: '1. '

_translations/guide/po/ru/start_workflow.md.po

@@ -6,7 +6,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2025-10-19 11:32+0000\n"
+"POT-Creation-Date: 2025-12-20 13:19+0000\n"
 "PO-Revision-Date: 2025-09-04 11:19+0500\n"
 "Last-Translator: Automatically generated\n"
 "Language-Team: none\n"
@@ -41,7 +41,7 @@ msgstr "Определение псевдонимов <span id=\"defining-aliase
 
 #. type: Plain text
 #: ../../guide/en/start/workflow.md
-msgid "The installed application has only the homepage, which displays when you access the URL `http://localhost/`.  It shares a common layout that you can reuse on further pages."
+msgid "The installed application contains only one page, accessible at `http://localhost/`.  It shares a common layout that you can reuse on further pages."
 msgstr ""
 
 #. type: Plain text
@@ -135,9 +135,24 @@ msgstr "Полезные ссылки <span id=\"references\"></span>"
 msgid "The following diagram shows how an application handles a request."
 msgstr ""
 
-#. type: Plain text
+#. type: Fenced code block (mermaid)
 #: ../../guide/en/start/workflow.md
-msgid "![Request Lifecycle](img/request-lifecycle.svg)"
+#, no-wrap
+msgid ""
+"flowchart LR\n"
+"  user[User's client] --> index\n"
+"  index[index.php] --> DI[Initialize Dependency Container]\n"
+"  config[configs] -.-> DI\n"
+"  DI --> RequestFactory[RequestFactory]\n"
+"  RequestFactory -->|Request| app[Application]\n"
+"  app -->|Request| middleware[Middleware]\n"
+"  middleware -->|Request| router[Router]\n"
+"  router -->|Request| action[Action Handler]\n"
+"  action -->|Response| emitter[SapiEmitter]\n"
+"  router -->|Response| emitter\n"
+"  middleware -->|Response| emitter\n"
+"  app -->|Response| emitter\n"
+"  emitter --> user\n"
 msgstr ""
 
 #. type: Bullet: '1. '

_translations/guide/pot/start_workflow.md.pot

@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2025-10-19 11:32+0000\n"
+"POT-Creation-Date: 2025-12-20 13:19+0000\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -47,9 +47,8 @@ msgstr ""
 #. type: Plain text
 #: ../../guide/en/start/workflow.md
 msgid ""
-"The installed application has only the homepage, which displays when you "
-"access the URL `http://localhost/`.  It shares a common layout that you can "
-"reuse on further pages."
+"The installed application contains only one page, accessible at `http://"
+"localhost/`.  It shares a common layout that you can reuse on further pages."
 msgstr ""
 
 #. type: Plain text
@@ -165,9 +164,24 @@ msgstr ""
 msgid "The following diagram shows how an application handles a request."
 msgstr ""
 
-#. type: Plain text
+#. type: Fenced code block (mermaid)
 #: ../../guide/en/start/workflow.md
-msgid "![Request Lifecycle](img/request-lifecycle.svg)"
+#, no-wrap
+msgid ""
+"flowchart LR\n"
+"  user[User's client] --> index\n"
+"  index[index.php] --> DI[Initialize Dependency Container]\n"
+"  config[configs] -.-> DI\n"
+"  DI --> RequestFactory[RequestFactory]\n"
+"  RequestFactory -->|Request| app[Application]\n"
+"  app -->|Request| middleware[Middleware]\n"
+"  middleware -->|Request| router[Router]\n"
+"  router -->|Request| action[Action Handler]\n"
+"  action -->|Response| emitter[SapiEmitter]\n"
+"  router -->|Response| emitter\n"
+"  middleware -->|Response| emitter\n"
+"  app -->|Response| emitter\n"
+"  emitter --> user\n"
 msgstr ""
 
 #. type: Bullet: '1. '

guide/en/views/template-engines.md

@@ -1,11 +1,11 @@
 # Template engines
 
 Yii3 supports multiple template engines through a flexible renderer system. By default, PHP is used as the
 template engine, but you can easily add support for other engines like Twig or create your own custom renderers.
 
 PHP templates were described in the "[View](view.md)" guide section. 
 
 ## Twig Template Engine
 
 Twig is a modern template engine that provides a more designer-friendly syntax. To use Twig in your Yii3 application,
 you need to install the Twig extension.
@@ -42,7 +42,7 @@
 </div>
 ```
 
 ### Twig Features
 
 **Automatic Escaping**: Twig automatically escapes variables for HTML context:
 
@@ -56,6 +56,7 @@
 
 **Filters and Functions**: Twig provides many built-in filters and functions:
 
+{% raw %}
 ```twig
 {# Date formatting #}
 <time>{{ post.createdAt|date('Y-m-d H:i') }}</time>
@@ -66,6 +67,7 @@
 {# URL generation #}
 <a href="{{ path('user.profile', {'id': user.id}) }}">Profile</a>
 ```
+{% endraw %}
 
 **Template Inheritance**: Twig supports template inheritance:
 
@@ -96,7 +98,7 @@
 {% endblock %}
 ```
 
 ### Rendering Twig Templates
 
 Use Twig templates the same way as PHP templates:
 
@@ -111,7 +113,7 @@
 }
 ```
 
 ## Custom Template Engines
 
 You can create custom template engines by implementing the `TemplateRendererInterface`:
 
@@ -170,13 +172,13 @@
 - Feature 3
 ```
 
 ## Choosing the Right Template Engine
 
 **Use PHP templates when:**
 - You need maximum flexibility and performance
 - Your team is comfortable with PHP
 - You want to leverage existing PHP knowledge
 - You need complex logic in templates (though this should be minimized)
 
 **Use Twig templates when:**
 - You want stricter separation between logic and presentation
@@ -189,10 +191,10 @@
 - You're working with specialized content formats
 - You need integration with external template systems
 
 ## Best Practices
 
 1. **Keep templates simple**: Move complex logic to controllers or services
 2. **Always escape output**: Prevent XSS attacks by properly escaping variables
 3. **Use meaningful names**: Name your templates and variables clearly
 4. **Organize templates**: Group related templates in subdirectories
 5. **Document variables**: Always add type hints for better IDE support

guide/es/start/workflow.md

@@ -10,9 +10,9 @@ you need.
 
 ## Functionality <span id="functionality"></span>
 
-The installed application has only the homepage, which displays when you
-access the URL `http://localhost/`.  It shares a common layout that you can
-reuse on further pages.
+The installed application contains only one page, accessible at
+`http://localhost/`.  It shares a common layout that you can reuse on
+further pages.
 
 <!--
 You should also see a toolbar at the bottom of the browser window.
@@ -86,7 +86,22 @@ documentation](https://github.com/yiisoft/app/blob/master/README.md).
 
 The following diagram shows how an application handles a request.
 
-![Request Lifecycle](img/request-lifecycle.svg)
+```mermaid
+flowchart LR
+  user[User's client] --> index
+  index[index.php] --> DI[Initialize Dependency Container]
+  config[configs] -.-> DI
+  DI --> RequestFactory[RequestFactory]
+  RequestFactory -->|Request| app[Application]
+  app -->|Request| middleware[Middleware]
+  middleware -->|Request| router[Router]
+  router -->|Request| action[Action Handler]
+  action -->|Response| emitter[SapiEmitter]
+  router -->|Response| emitter
+  middleware -->|Response| emitter
+  app -->|Response| emitter
+  emitter --> user
+```
 
 1. A user makes a request to the [entry
    script](../structure/entry-script.md) `public/index.php`.

guide/id/start/workflow.md

@@ -10,9 +10,9 @@ you need.
 
 ## Functionality <span id="functionality"></span>
 
-The installed application has only the homepage, which displays when you
-access the URL `http://localhost/`.  It shares a common layout that you can
-reuse on further pages.
+The installed application contains only one page, accessible at
+`http://localhost/`.  It shares a common layout that you can reuse on
+further pages.
 
 <!--
 You should also see a toolbar at the bottom of the browser window.
@@ -86,7 +86,22 @@ documentation](https://github.com/yiisoft/app/blob/master/README.md).
 
 The following diagram shows how an application handles a request.
 
-![Request Lifecycle](img/request-lifecycle.svg)
+```mermaid
+flowchart LR
+  user[User's client] --> index
+  index[index.php] --> DI[Initialize Dependency Container]
+  config[configs] -.-> DI
+  DI --> RequestFactory[RequestFactory]
+  RequestFactory -->|Request| app[Application]
+  app -->|Request| middleware[Middleware]
+  middleware -->|Request| router[Router]
+  router -->|Request| action[Action Handler]
+  action -->|Response| emitter[SapiEmitter]
+  router -->|Response| emitter
+  middleware -->|Response| emitter
+  app -->|Response| emitter
+  emitter --> user
+```
 
 1. A user makes a request to the [entry
    script](../structure/entry-script.md) `public/index.php`.

guide/ru/start/workflow.md

@@ -10,9 +10,9 @@ you need.
 
 ## Functionality <span id="functionality"></span>
 
-The installed application has only the homepage, which displays when you
-access the URL `http://localhost/`.  It shares a common layout that you can
-reuse on further pages.
+The installed application contains only one page, accessible at
+`http://localhost/`.  It shares a common layout that you can reuse on
+further pages.
 
 <!--
 You should also see a toolbar at the bottom of the browser window.
@@ -86,7 +86,22 @@ documentation](https://github.com/yiisoft/app/blob/master/README.md).
 
 The following diagram shows how an application handles a request.
 
-![Request Lifecycle](img/request-lifecycle.svg)
+```mermaid
+flowchart LR
+  user[User's client] --> index
+  index[index.php] --> DI[Initialize Dependency Container]
+  config[configs] -.-> DI
+  DI --> RequestFactory[RequestFactory]
+  RequestFactory -->|Request| app[Application]
+  app -->|Request| middleware[Middleware]
+  middleware -->|Request| router[Router]
+  router -->|Request| action[Action Handler]
+  action -->|Response| emitter[SapiEmitter]
+  router -->|Response| emitter
+  middleware -->|Response| emitter
+  app -->|Response| emitter
+  emitter --> user
+```
 
 1. A user makes a request to the [entry
    script](../structure/entry-script.md) `public/index.php`.