docs: add page title to code blocks

Author: stlgaits

docs/admin-ui/getting-started.md

@@ -35,9 +35,8 @@ You can install the optional [BootstrapAdminUi package](../bootstrap-admin-ui/ge
 
 *Usage with Sylius Resource package*
 
+{% code title="src/Entity/Speaker.php" lineNumbers="true" %}
 ```php
-// src/Entity/Speaker.php
-
 namespace App\Entity;
 
 use Sylius\Resource\Metadata\AsResource;
@@ -52,6 +51,7 @@ class Speaker implements ResourceInterface
 }
 
 ```
+{% endcode %}
 
 ### Dashboard
 

docs/cookbook/admin_panel/page_titles.md

@@ -24,9 +24,8 @@ We're going to reuse this hook and its template in our config file and add a `he
 
 {% tabs %}
 {% tab title="YAML" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.yaml" lineNumbers="true" %}
 ```yaml
-# config/packages/sylius_bootstrap_admin_ui.yaml
 # ...
 sylius_twig_hooks:
     hooks:
@@ -41,9 +40,8 @@ sylius_twig_hooks:
 {% endtab %}
 
 {% tab title="PHP" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.php" lineNumbers="true" %}
 ```php
-// config/packages/sylius_bootstrap_admin_ui.php
 use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
 return static function (ContainerConfigurator $containerConfigurator): void {
@@ -77,9 +75,8 @@ Note that you can also use [Symfony Expression Language](https://symfony.com/doc
 
 {% tabs %}
 {% tab title="YAML" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.yaml" lineNumbers="true" %}
 ```yaml
-# config/packages/sylius_bootstrap_admin_ui.yaml
 # ...
 sylius_twig_hooks:
     hooks:
@@ -94,9 +91,8 @@ sylius_twig_hooks:
 {% endtab %}
 
 {% tab title="PHP" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.php" lineNumbers="true" %}
 ```php
-// config/packages/sylius_bootstrap_admin_ui.php
 use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
 return static function (ContainerConfigurator $containerConfigurator): void {
@@ -145,9 +141,8 @@ Here's an example to define a "users" icon on a speaker list.
 
 {% tabs %}
 {% tab title="YAML" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.yaml" lineNumbers="true" %}
 ```yaml
-# config/packages/sylius_bootstrap_admin_ui.yaml
 # ...
 sylius_twig_hooks:
     hooks:
@@ -163,9 +158,8 @@ sylius_twig_hooks:
 {% endtab %}
 
 {% tab title="PHP" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.php" lineNumbers="true" %}
 ```php
-// config/packages/sylius_bootstrap_admin_ui.php
 use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
 return static function (ContainerConfigurator $containerConfigurator): void {
@@ -199,9 +193,8 @@ You can also define a default icon for every "index" pages.
 
 {% tabs %}
 {% tab title="YAML" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.yaml" lineNumbers="true" %}
 ```yaml
-# config/packages/sylius_bootstrap_admin_ui.yaml
 # ...
 sylius_twig_hooks:
     hooks:
@@ -215,9 +208,8 @@ sylius_twig_hooks:
 {% endtab %}
 
 {% tab title="PHP" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.php" lineNumbers="true" %}
 ```php
-// config/packages/sylius_bootstrap_admin_ui.php
 use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
 return static function (ContainerConfigurator $containerConfigurator): void {
@@ -255,9 +247,8 @@ Here's an example to define a subheader on a speaker list.
 
 {% tabs %}
 {% tab title="YAML" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.yaml" lineNumbers="true" %}
 ```yaml
-# config/packages/sylius_bootstrap_admin_ui.yaml
 # ...
 sylius_twig_hooks:
     hooks:
@@ -273,9 +264,8 @@ sylius_twig_hooks:
 {% endtab %}
 
 {% tab title="PHP" %}
-{% code lineNumbers="true" %}
+{% code title="config/packages/sylius_bootstrap_admin_ui.php" lineNumbers="true" %}
 ```php
-// config/packages/sylius_bootstrap_admin_ui.php
 use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
 
 return static function (ContainerConfigurator $containerConfigurator): void {

docs/cookbook/admin_panel/security.md

@@ -29,8 +29,8 @@ Learn more on how to [create a User](https://symfony.com/doc/current/security.ht
 
 Here is an example of a user provider configuration:
 
+{% code title="config/packages/security.yaml" lineNumbers="true" %}
 ```yaml
-# config/packages/security.yaml
 security:
     # https://symfony.com/doc/current/security.html#registering-the-user-hashing-passwords
     password_hashers:
@@ -43,6 +43,7 @@ security:
                 class: App\Entity\User
                 property: email
 ```
+{% endcode %}
 
 {% hint style="info" %}
 Learn more on how to [create a user provider on the Symfony documentation](https://symfony.com/doc/current/security.html#the-user)
@@ -52,8 +53,8 @@ Learn more on how to [create a user provider on the Symfony documentation](https
 
 Here is an example of how to configure a firewall for your admin routes:
 
+{% code title="config/packages/security.yaml" %}
 ```yaml
-# config/packages/security.yaml
 security:
     firewalls:
         # ...
@@ -71,6 +72,7 @@ security:
                 path: sylius_admin_ui_logout
                 target: sylius_admin_ui_login
 ```
+{% endcode %}
 
 {% hint style="info" %}
 Learn more on how to [configure the firewall on the Symfony documentation](https://symfony.com/doc/current/security.html#the-firewall)
@@ -80,15 +82,16 @@ Learn more on how to [configure the firewall on the Symfony documentation](https
 
 Only admin users will have access to "/admin" routes.
 
+{% code title="config/packages/security.yaml" %}
 ```yaml
-# config/packages/security.yaml
 security:
     access_control:
         - { path: ^/admin/login, roles: PUBLIC_ACCESS }
         - { path: ^/admin/logout, roles: PUBLIC_ACCESS }
         - { path: ^/admin, roles: ROLE_ADMIN }
         - { path: ^/, roles: PUBLIC_ACCESS }
 ```
+{% endcode %}
 
 {% hint style="info" %}
 Learn more on how to [configure Access Control Authorization on the Symfony documentation](https://symfony.com/doc/current/security.html#access-control-authorization)

docs/cookbook/ddd_architecture/basic_operations.md

@@ -35,8 +35,8 @@ src
 
 In the Application folder, we already have this `CreateBookCommand`:
 
+{% code title="src/Bookstore/Application/Command/CreateBookCommand.php" lineNumbers="true" %}
 ```php
-// src/Bookstore/Application/Command/CreateBookCommand.php
 
 declare(strict_types=1);
 
@@ -65,15 +65,16 @@ final readonly class CreateBookCommand implements CommandInterface
     }
 }
 ```
+{% endcode %}
 
 The idea is to reuse this command to create the book in the storage for your "create" operation.
 
 ### Create the CreateBookProcessor
 
 First, we need to add the `CreateBookProcessor` in which we're going to call our `CreateBookCommand`.
 
+{% code title="src/BookStore/Infrastructure/Sylius/State/Processor/CreateBookProcessor.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Infrastructure/Sylius/State/Processor/CreateBookProcessor.php
 
 declare(strict_types=1);
 
@@ -126,13 +127,14 @@ final readonly class CreateBookProcessor implements ProcessorInterface
     }
 }
 ```
+{% endcode %}
 
 ### Adding the processor on the Book Resource
 
 Then, we add the `Create` operation on our `BookResource`.
 
+{% code title="src/BookStore/Infrastructure/Sylius/Resource/BookResource.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Infrastructure/Sylius/Resource/BookResource.php
 
 // ...
 use App\BookStore\Infrastructure\Sylius\State\Processor\CreateBookProcessor;
@@ -156,6 +158,7 @@ final class BookResource implements ResourceInterface
     // ...
 }
 ```
+{% endcode %}
 
 ## Book edition
 
@@ -167,8 +170,8 @@ final class BookResource implements ResourceInterface
 
 Now, we want to be able to edit an existing book. In the Application folder, we already have this `UpdateBookCommand`:
 
+{% code title="src/Bookstore/Application/Command/UpdateBookCommand.php" lineNumbers="true" %}
 ```php
-// src/Bookstore/Application/Command/UpdateBookCommand.php
 
 declare(strict_types=1);
 
@@ -199,11 +202,12 @@ final readonly class UpdateBookCommand implements CommandInterface
     }
 }
 ```
+{% endcode %}
 
 In the same folder, we also have this existing `FindBookQuery`:
 
+{% code title="src/BookStore/Application/Query/FindBookQuery.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Application/Query/FindBookQuery.php
 
 declare(strict_types=1);
 
@@ -224,15 +228,16 @@ final readonly class FindBookQuery implements QueryInterface
     }
 }
 ```
+{% endcode %}
 
 The idea is to reuse these query and command to update the book in the storage for your "update" operation.
 
 ### Create the BookItemProvider
 
 First, we need to create the `BookItemProvider` in order to fetch the right book.
 
+{% code title="src/BookStore/Infrastructure/Sylius/State/Provider/BookItemProvider.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Infrastructure/Sylius/State/Provider/BookItemProvider.php
 
 declare(strict_types=1);
 
@@ -272,13 +277,14 @@ final readonly class BookItemProvider implements ProviderInterface
     }
 }
 ```
+{% endcode %}
 
 ### Create the UpdateBookProcessor
 
 We also need to create the `UpdateBookProcessor` where we're going to call our `UpdateBookCommand`.
 
+{% code title="src/BookStore/Infrastructure/Sylius/State/Processor/UpdateBookProcessor.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Infrastructure/Sylius/State/Processor/UpdateBookProcessor.php
 
 declare(strict_types=1);
 
@@ -327,14 +333,14 @@ final readonly class UpdateBookProcessor implements ProcessorInterface
     }
 }
 ```
+{% endcode %}
 
 ### Adding the provider & processor on the Book Resource
 
 Now, we add the "update" operation on the `BookResource`.
 
+{% code title="src/BookStore/Infrastructure/Sylius/Resource/BookResource.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Infrastructure/Sylius/Resource/BookResource.php
-
 // ...
 use App\BookStore\Infrastructure\Sylius\State\Processor\UpdateBookProcessor;
 use App\BookStore\Infrastructure\Sylius\State\Provider\BookItemProvider;
@@ -359,6 +365,7 @@ final class BookResource implements ResourceInterface
     // ...
 }
 ```
+{% endcode %}
 
 ## Book removal
 
@@ -370,8 +377,8 @@ final class BookResource implements ResourceInterface
 
 Now that we can update an existing book, we also want to be able to delete it. In the Application folder, we already have this `DeleteBookCommand`:
 
+{% code title="src/BookStore/Application/Command/DeleteBookCommand.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Application/Command/DeleteBookCommand.php
 
 declare(strict_types=1);
 
@@ -391,13 +398,14 @@ final readonly class DeleteBookCommand implements CommandInterface
     }
 }
 ```
+{% endcode %}
 
 ### Create the DeleteBookProcessor
 
 We need to create the `DeleteBookProcessor`.
 
+{% code title="src/BookStore/Infrastructure/Sylius/State/Processor/DeleteBookProcessor.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Infrastructure/Sylius/State/Processor/DeleteBookProcessor.php
 
 declare(strict_types=1);
 
@@ -431,14 +439,14 @@ final readonly class DeleteBookProcessor implements ProcessorInterface
     }
 }
 ```
+{% endcode %}
 
 ### Adding the processor on the Book Resource
 
 And then we create the "delete" operation on the BookResource.
 
+{% code title="src/BookStore/Infrastructure/Sylius/Resource/BookResource.php" lineNumbers="true" %}
 ```php
-// src/BookStore/Infrastructure/Sylius/Resource/BookResource.php
-
 // ...
 use App\BookStore\Infrastructure\Sylius\State\Processor\DeleteBookProcessor;
 use App\BookStore\Infrastructure\Sylius\State\Provider\BookItemProvider;
@@ -460,3 +468,4 @@ final class BookResource implements ResourceInterface
     // ...
 }
 ```
+{% endcode %}