Skip to content

Refactor RouteArgument attribute placement in views documentation. #285

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
rustamwin wants to merge 2 commits into from
Closed

Refactor RouteArgument attribute placement in views documentation. #285

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b2a1014
Refactor `RouteArgument` attribute placement in views documentation.
rustamwin Dec 26, 2025
07db8b7
Update translation
rustamwin Dec 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 9 additions & 5 deletions _translations/po/es/guide_start_creating-project.md.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-12-24 13:00+0000\n"
"POT-Creation-Date: 2025-12-26 09:52+0000\n"
"PO-Revision-Date: 2025-09-04 11:19+0500\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
Expand All @@ -33,7 +33,7 @@ msgstr ""
msgid ""
"> [!NOTE]\n"
"> If you want to use another web server,\n"
"> see [\"Configuring web servers\"](../../../cookbook/en/configuring-webservers/general.md).\n"
"> see [\"Configuring web servers\"](../../cookbook/configuring-webservers/general.md).\n"
msgstr ""

#. type: Plain text
Expand All @@ -54,13 +54,17 @@ msgstr ""

#. type: Plain text
#: ../src/guide/start/creating-project.md
msgid "Docker users can run the following command:"
msgstr ""
#, fuzzy
#| msgid "Events are raised like the following:"
msgid "Docker users can run the following commands:"
msgstr "Los eventos se lanzan de la siguiente forma:"

#. type: Fenced code block (sh)
#: ../src/guide/start/creating-project.md
#, no-wrap
msgid "docker run --rm -it -v \"$(pwd):/app\" composer/composer create-project yiisoft/app your_project\n"
msgid ""
"docker run --rm -it -v \"$(pwd):/app\" composer/composer create-project yiisoft/app your_project\n"
"sudo chown -R $(id -u):$(id -g) your_project\n"
msgstr ""

#. type: Plain text
Expand Down
20 changes: 8 additions & 12 deletions _translations/po/es/guide_start_databases.md.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-12-24 13:00+0000\n"
"POT-Creation-Date: 2025-12-26 09:52+0000\n"
"PO-Revision-Date: 2025-09-04 11:19+0500\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
Expand Down Expand Up @@ -165,18 +165,13 @@ msgstr ""

#. type: Plain text
#: ../src/guide/start/databases.md
msgid "Let's use latest versions to be released. Change your `minimum-stability` to `dev` in `composer.json` first."
msgstr ""

#. type: Plain text
#: ../src/guide/start/databases.md
msgid "Then we need a package to be installed:"
msgid "First we need a package to be installed:"
msgstr ""

#. type: Fenced code block (sh)
#: ../src/guide/start/databases.md
#, no-wrap
msgid "make composer require yiisoft/db-pgsql dev-master\n"
msgid "make composer require yiisoft/db-pgsql\n"
msgstr ""

#. type: Plain text
Expand Down Expand Up @@ -260,7 +255,7 @@ msgstr ""
#. type: Fenced code block (sh)
#: ../src/guide/start/databases.md
#, no-wrap
msgid "composer require yiisoft/db-migration dev-master\n"
msgid "make composer require yiisoft/db-migration\n"
msgstr ""

#. type: Plain text
Expand Down Expand Up @@ -296,9 +291,6 @@ msgid ""
"use Yiisoft\\Db\\Migration\\MigrationBuilder;\n"
"use Yiisoft\\Db\\Migration\\RevertibleMigrationInterface;\n"
"\n"
"/**\n"
" * Class M251102141707Page\n"
" */\n"
"final class M251102141707Page implements RevertibleMigrationInterface\n"
"{\n"
" public function up(MigrationBuilder $b): void\n"
Expand Down Expand Up @@ -350,6 +342,8 @@ msgstr ""
msgid ""
"<?php\n"
"\n"
"declare(strict_types=1);\n"
"\n"
"namespace App\\Web\\Page;\n"
"\n"
"use DateTimeImmutable;\n"
Expand Down Expand Up @@ -419,6 +413,8 @@ msgstr ""
msgid ""
"<?php\n"
"\n"
"declare(strict_types=1);\n"
"\n"
"namespace App\\Web\\Page;\n"
"\n"
"use DateTimeImmutable;\n"
Expand Down
16 changes: 10 additions & 6 deletions _translations/po/es/guide_start_hello.md.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-12-24 13:00+0000\n"
"POT-Creation-Date: 2025-12-26 09:52+0000\n"
"PO-Revision-Date: 2025-09-04 11:19+0500\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
Expand Down Expand Up @@ -95,8 +95,10 @@ msgid ""
" private ResponseFactoryInterface $responseFactory,\n"
" ) {}\n"
"\n"
" #[RouteArgument('message')]\n"
" public function __invoke(string $message = 'Hello!'): ResponseInterface\n"
" public function __invoke(\n"
" #[RouteArgument('message')]\n"
" string $message = 'Hello!'\n"
" ): ResponseInterface\n"
" {\n"
" $response = $this->responseFactory->createResponse();\n"
" $response->getBody()->write('The message is: ' . Html::encode($message));\n"
Expand Down Expand Up @@ -226,7 +228,7 @@ msgid "To use the view, you need to change `src/Web/Echo/Action.php`:"
msgstr ""

#. type: Fenced code block (php)
#: ../src/guide/start/hello.md ../src/guide/views/view.md
#: ../src/guide/start/hello.md
#, no-wrap
msgid ""
"<?php\n"
Expand All @@ -245,8 +247,10 @@ msgid ""
" private ViewRenderer $viewRenderer,\n"
" ) {}\n"
"\n"
" #[RouteArgument('message')]\n"
" public function __invoke(string $message = 'Hello!'): ResponseInterface\n"
" public function __invoke(\n"
" #[RouteArgument('message')]\n"
" string $message = 'Hello!'\n"
" ): ResponseInterface\n"
" {\n"
" return $this->viewRenderer->render(__DIR__ . '/template', [\n"
" 'message' => $message,\n"
Expand Down
8 changes: 5 additions & 3 deletions _translations/po/es/guide_views_template-engines.md.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-12-24 13:00+0000\n"
"POT-Creation-Date: 2025-12-26 09:52+0000\n"
"PO-Revision-Date: 2025-12-24 08:02+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
Expand Down Expand Up @@ -259,10 +259,12 @@ msgstr ""
#: ../src/guide/views/template-engines.md
#, no-wrap
msgid ""
"use Yiisoft\\Container\\Reference;\n"
"\n"
"// In configuration\n"
"'yiisoft/view' => [\n"
" 'renderers' => [\n"
" 'md' => App\\View\\MarkdownRenderer::class,\n"
" 'md' => Reference::to(App\\View\\MarkdownRenderer::class),\n"
" ],\n"
"],\n"
msgstr ""
Expand All @@ -286,7 +288,7 @@ msgid ""
"\n"
"Welcome, {{username}}!\n"
"\n"
"This is a markdown template with **bold** and *italic* text.\n"
"This is a Markdown template with **bold** and *italic* text.\n"
"\n"
"- Feature 1\n"
"- Feature 2\n"
Expand Down
61 changes: 30 additions & 31 deletions _translations/po/es/guide_views_view.md.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-12-24 13:00+0000\n"
"POT-Creation-Date: 2025-12-26 09:52+0000\n"
"PO-Revision-Date: 2025-12-24 08:02+0000\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
Expand Down Expand Up @@ -44,36 +44,6 @@ msgid ""
"<p>The message is: <?= Html::encode($message) ?></p>\n"
msgstr ""

#. type: Fenced code block (php)
#: ../src/guide/start/hello.md ../src/guide/views/view.md
#, no-wrap
msgid ""
"<?php\n"
"\n"
"declare(strict_types=1);\n"
"\n"
"namespace App\\Web\\Echo;\n"
"\n"
"use Psr\\Http\\Message\\ResponseInterface;\n"
"use Yiisoft\\Router\\HydratorAttribute\\RouteArgument;\n"
"use Yiisoft\\Yii\\View\\Renderer\\ViewRenderer;\n"
"\n"
"final readonly class Action\n"
"{\n"
" public function __construct(\n"
" private ViewRenderer $viewRenderer,\n"
" ) {}\n"
"\n"
" #[RouteArgument('message')]\n"
" public function __invoke(string $message = 'Hello!'): ResponseInterface\n"
" {\n"
" return $this->viewRenderer->render(__DIR__ . '/template', [\n"
" 'message' => $message,\n"
" ]);\n"
" }\n"
"}\n"
msgstr ""

#. type: Title ##
#: ../src/guide/views/asset.md ../src/guide/views/view.md
#: ../src/guide/views/widget.md
Expand Down Expand Up @@ -139,6 +109,35 @@ msgstr ""
msgid "Here `$message` is a view data that is passed when you render a template with the help of `ViewRenderer`. For example, `src/Web/Echo/Action.php`:"
msgstr ""

#. type: Fenced code block (php)
#: ../src/guide/views/view.md
#, no-wrap
msgid ""
"<?php\n"
"\n"
"declare(strict_types=1);\n"
"\n"
"namespace App\\Web\\Echo;\n"
"\n"
"use Psr\\Http\\Message\\ResponseInterface;\n"
"use Yiisoft\\Router\\HydratorAttribute\\RouteArgument;\n"
"use Yiisoft\\Yii\\View\\Renderer\\ViewRenderer;\n"
"\n"
"final readonly class Action\n"
"{\n"
" public function __construct(\n"
" private ViewRenderer $viewRenderer,\n"
" ) {}\n"
"\n"
" public function __invoke(#[RouteArgument('message')] string $message = 'Hello!'): ResponseInterface\n"
" {\n"
" return $this->viewRenderer->render(__DIR__ . '/template', [\n"
" 'message' => $message,\n"
" ]);\n"
" }\n"
"}\n"
msgstr ""

#. type: Plain text
#: ../src/guide/views/view.md
msgid "First argument of the `render()` method is a path to the template file. In the `yiisoft/app`, template files are typically stored alongside their actions. The result is ready to be rendered to the browser so we return it immediately."
Expand Down
10 changes: 6 additions & 4 deletions _translations/po/id/guide_start_creating-project.md.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-12-24 13:00+0000\n"
"POT-Creation-Date: 2025-12-26 09:52+0000\n"
"PO-Revision-Date: 2025-09-04 11:19+0500\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
Expand All @@ -32,7 +32,7 @@ msgstr ""
msgid ""
"> [!NOTE]\n"
"> If you want to use another web server,\n"
"> see [\"Configuring web servers\"](../../../cookbook/en/configuring-webservers/general.md).\n"
"> see [\"Configuring web servers\"](../../cookbook/configuring-webservers/general.md).\n"
msgstr ""

#. type: Plain text
Expand All @@ -53,13 +53,15 @@ msgstr ""

#. type: Plain text
#: ../src/guide/start/creating-project.md
msgid "Docker users can run the following command:"
msgid "Docker users can run the following commands:"
msgstr ""

#. type: Fenced code block (sh)
#: ../src/guide/start/creating-project.md
#, no-wrap
msgid "docker run --rm -it -v \"$(pwd):/app\" composer/composer create-project yiisoft/app your_project\n"
msgid ""
"docker run --rm -it -v \"$(pwd):/app\" composer/composer create-project yiisoft/app your_project\n"
"sudo chown -R $(id -u):$(id -g) your_project\n"
msgstr ""

#. type: Plain text
Expand Down
20 changes: 8 additions & 12 deletions _translations/po/id/guide_start_databases.md.po
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2025-12-24 13:00+0000\n"
"POT-Creation-Date: 2025-12-26 09:52+0000\n"
"PO-Revision-Date: 2025-09-04 11:19+0500\n"
"Last-Translator: Automatically generated\n"
"Language-Team: none\n"
Expand Down Expand Up @@ -164,19 +164,14 @@ msgstr ""

#. type: Plain text
#: ../src/guide/start/databases.md
msgid "Let's use latest versions to be released. Change your `minimum-stability` to `dev` in `composer.json` first."
msgstr ""

#. type: Plain text
#: ../src/guide/start/databases.md
msgid "Then we need a package to be installed:"
msgid "First we need a package to be installed:"
msgstr ""

#. type: Fenced code block (sh)
#: ../src/guide/start/databases.md
#, fuzzy, no-wrap
#| msgid "composer require yiisoft/cache\n"
msgid "make composer require yiisoft/db-pgsql dev-master\n"
msgid "make composer require yiisoft/db-pgsql\n"
msgstr "composer require yiisoft/cache\n"

#. type: Plain text
Expand Down Expand Up @@ -261,7 +256,7 @@ msgstr ""
#: ../src/guide/start/databases.md
#, fuzzy, no-wrap
#| msgid "composer require yiisoft/cache\n"
msgid "composer require yiisoft/db-migration dev-master\n"
msgid "make composer require yiisoft/db-migration\n"
msgstr "composer require yiisoft/cache\n"

#. type: Plain text
Expand Down Expand Up @@ -297,9 +292,6 @@ msgid ""
"use Yiisoft\\Db\\Migration\\MigrationBuilder;\n"
"use Yiisoft\\Db\\Migration\\RevertibleMigrationInterface;\n"
"\n"
"/**\n"
" * Class M251102141707Page\n"
" */\n"
"final class M251102141707Page implements RevertibleMigrationInterface\n"
"{\n"
" public function up(MigrationBuilder $b): void\n"
Expand Down Expand Up @@ -351,6 +343,8 @@ msgstr ""
msgid ""
"<?php\n"
"\n"
"declare(strict_types=1);\n"
"\n"
"namespace App\\Web\\Page;\n"
"\n"
"use DateTimeImmutable;\n"
Expand Down Expand Up @@ -420,6 +414,8 @@ msgstr ""
msgid ""
"<?php\n"
"\n"
"declare(strict_types=1);\n"
"\n"
"namespace App\\Web\\Page;\n"
"\n"
"use DateTimeImmutable;\n"
Expand Down
Loading