feat: improve indexing

Author: innocenzi

src/Web/Blog/BlogIndexer.php

@@ -9,6 +9,8 @@
 use Tempest\Support\Arr\ImmutableArray;
 
 use function Tempest\Support\arr;
+use function Tempest\Support\Arr\get_by_key;
+use function Tempest\Support\Arr\wrap;
 use function Tempest\uri;
 
 final readonly class BlogIndexer
@@ -29,20 +31,27 @@ public function __invoke(): ImmutableArray
                     throw new \RuntimeException(sprintf('Blog entry [%s] is missing a frontmatter.', $path));
                 }
 
-                ['title' => $title, 'author' => $author, 'description' => $description] = $markdown->getFrontMatter();
+                $frontmatter = $markdown->getFrontMatter();
+                $title = get_by_key($frontmatter, 'title');
+                $author = get_by_key($frontmatter, 'author');
+                $description = get_by_key($frontmatter, 'description');
+                $keywords = get_by_key($frontmatter, 'keywords');
+                $tags = get_by_key($frontmatter, 'tag');
 
                 $main = new Command(
                     type: Type::URI,
                     title: $title,
                     uri: uri([BlogController::class, 'show'], slug: $matches['slug']),
                     hierarchy: [
                         'Blog',
-                        $author,
+                        Author::tryFrom($author)?->getName() ?? 'Tempest',
                         $title,
                     ],
                     fields: [
-                        'author' => $author,
-                        'description' => $description,
+                        $author,
+                        $description,
+                        ...wrap($keywords),
+                        ...wrap($tags),
                     ],
                 );
 

src/Web/Documentation/DocumentationIndexer.php

@@ -14,6 +14,7 @@
 
 use function Tempest\Support\arr;
 use function Tempest\Support\Arr\get_by_key;
+use function Tempest\Support\Arr\wrap;
 use function Tempest\Support\Str\to_kebab_case;
 use function Tempest\Support\Str\to_sentence_case;
 use function Tempest\uri;
@@ -45,6 +46,7 @@ public function __invoke(Version $version): ImmutableArray
                 $category = $path->beforeLast('/')->afterLast('/')->replaceRegex('/\d+-/', '');
                 $chapter = $path->basename('.md')->replaceRegex('/\d+-/', '');
                 $title = get_by_key($markdown->getFrontMatter(), 'title');
+                $keywords = get_by_key($markdown->getFrontMatter(), 'keywords');
 
                 $main = new Command(
                     type: Type::URI,
@@ -55,6 +57,9 @@ public function __invoke(Version $version): ImmutableArray
                         to_sentence_case($category),
                         $title,
                     ],
+                    fields: [
+                        ...wrap($keywords),
+                    ],
                 );
 
                 /** @var Heading[] */

src/Web/Documentation/content/main/5-extra-topics/01-contributing.md

@@ -1,5 +1,6 @@
 ---
 title: Contributing
+keywords: "How do I"
 ---
 
 Welcome aboard! We're excited that you are interested in contributing to the Tempest framework. We value all contributions to the project and have assembled the following resources to help you get started. Thanks for being a contributor!