Updated the testimonials

.github/workflows/build.yml

@@ -58,13 +58,16 @@ jobs:
       run: npm install
 
     - name: Build frontend assets
-      run: npm run prod
+      run: npm run build
 
     - name: Download the latest community files
       run: php hyde download-community-files
 
+    - name: Download the latest documentation files
+      run: php hyde docs:download
+
     - name: Run the Hyde Builder
-      run: php hyde build --pretty-urls --run-prettier --no-interaction
+      run: php hyde build --pretty-urls --no-interaction
 
     - name: Create .nojekyll
       run: touch docs/.nojekyll
@@ -76,7 +79,7 @@ jobs:
       run: cp docs/media/favicon.ico docs/favicon.ico
 
     - name: Create docs redirect
-      run: echo '<meta http-equiv="refresh" content="0;url=/docs/1.x" />' > docs/docs/index.html
+      run: echo '<meta http-equiv="refresh" content="0;url=/docs/2.x" />' > docs/docs/index.html
 
     - name: Commit changes
       uses: EndBug/add-and-commit@v9 

.github/workflows/deploy-preview.yml

@@ -60,7 +60,7 @@ jobs:
       run: npm install
 
     - name: Build frontend assets
-      run: npm run prod
+      run: npm run build
 
     - name: Output debug information
       run: |
@@ -71,7 +71,7 @@ jobs:
       run: php hyde build --pretty-urls --no-interaction
 
     - name: Create docs redirect
-      run: echo '<meta http-equiv="refresh" content="0;url=/docs/1.x" />' > _site/docs/index.html
+      run: echo '<meta http-equiv="refresh" content="0;url=/docs/2.x" />' > _site/docs/index.html
 
     - name: Package the static site
       run: zip -r site.zip _site

.github/workflows/test-pull-request.yml

@@ -39,7 +39,7 @@ jobs:
       run: php hyde build --pretty-urls --no-interaction
 
     - name: Create docs redirect
-      run: echo '<meta http-equiv="refresh" content="0;url=/docs/1.x" />' > _site/docs/index.html
+      run: echo '<meta http-equiv="refresh" content="0;url=/docs/2.x" />' > _site/docs/index.html
 
     - name: Run tests
       run: php bin/build-tests.php

_docs/advanced-features/hyde-pages.md → _docs/1.x/advanced-features/hyde-pages.md

@@ -114,9 +114,7 @@ abstract class HydePage
 
 >warning <p class="p-2" style="padding-right: 1rem"><strong>Heads up!</strong> The following methods are defined in the <code>HydePage</code> class, and are thus available to all page classes. Since the HydePage class is abstract, you cannot instantiate it directly, and many of the static methods are also only callable from the child classes.</p>
 
-[Blade]: {{ Hyde\Markdown\Models\Markdown::fromFile(DocumentationPage::sourcePath('_data/partials/hyde-pages-api/hyde-page-methods'))->toHtml($page::class) }}
 
-[Blade]: {{ Hyde\Markdown\Models\Markdown::fromFile(DocumentationPage::sourcePath('_data/partials/hyde-pages-api/interacts-with-front-matter-methods'))->toHtml($page::class) }}
 
 ## BaseMarkdownPage
 
@@ -144,7 +142,6 @@ abstract class BaseMarkdownPage extends HydePage
 
 ### Methods
 
-[Blade]: {{ Hyde\Markdown\Models\Markdown::fromFile(DocumentationPage::sourcePath('_data/partials/hyde-pages-api/base-markdown-page-methods'))->toHtml($page::class) }}
 
 ## InMemoryPage
 
@@ -187,7 +184,6 @@ class InMemoryPage extends HydePage
 
 ### Methods
 
-[Blade]: {{ Hyde\Markdown\Models\Markdown::fromFile(DocumentationPage::sourcePath('_data/partials/hyde-pages-api/in-memory-page-methods'))->toHtml($page::class) }}
 
 ## BladePage
 
@@ -215,7 +211,6 @@ class BladePage extends HydePage
 
 ### Methods
 
-[Blade]: {{ Hyde\Markdown\Models\Markdown::fromFile(DocumentationPage::sourcePath('_data/partials/hyde-pages-api/blade-page-methods'))->toHtml($page::class) }}
 
 ## MarkdownPage
 
@@ -277,7 +272,6 @@ class MarkdownPost extends BaseMarkdownPage
 
 ### Methods
 
-[Blade]: {{ Hyde\Markdown\Models\Markdown::fromFile(DocumentationPage::sourcePath('_data/partials/hyde-pages-api/markdown-post-methods'))->toHtml($page::class) }}
 
 ## DocumentationPage
 
@@ -305,7 +299,6 @@ class DocumentationPage extends BaseMarkdownPage
 
 ### Methods
 
-[Blade]: {{ Hyde\Markdown\Models\Markdown::fromFile(DocumentationPage::sourcePath('_data/partials/hyde-pages-api/documentation-page-methods'))->toHtml($page::class) }}
 
 ## HtmlPage
 
@@ -333,4 +326,3 @@ class HtmlPage extends HydePage
 
 ### Methods
 
-[Blade]: {{ Hyde\Markdown\Models\Markdown::fromFile(DocumentationPage::sourcePath('_data/partials/hyde-pages-api/html-page-methods'))->toHtml($page::class) }}

_docs/digging-deeper/updating-hyde.md → _docs/1.x/digging-deeper/updating-hyde.md

@@ -47,7 +47,7 @@ following the upgrade guide for each version. After following the upgrade guide,
 Updating a minor or patch version is easy using Composer. Just run the following command:
 
 ```bash
-composer update hyde/* --with-dependencies
+composer update "hyde/*" --with-dependencies
 ```
 
 Note that if you have hardcoded a version constraint in your `composer.json` file, you may need to update it manually.

_docs/extensions/extensions.md → _docs/1.x/extensions/extensions.md

@@ -40,5 +40,5 @@ Torchlight is an amazing API for syntax highlighting, and is supported natively
 ## Contribute
 
 Have an idea for an extension or integration? Let me know! I'd love to hear from you. Get in touch on
-[GitHub](https://github.com/hydephp/hyde) or send me a DM on [Twitter](https://twitter.com/EmmaDSCodes).
+[GitHub](https://github.com/hydephp/hyde) or send me a DM on [Twitter](https://twitter.com/CodeWithCaen).
 You may also want to look at the [Extension API](extensions-api) documentation to learn how to create extensions.

_docs/2.x/advanced-features/advanced-features.md

@@ -0,0 +1,26 @@
+---
+navigation:
+    label: Introduction
+    priority: 40
+---
+
+# Advanced Features in HydePHP
+
+## Preface
+
+HydePHP is a simple, yet powerful, static site generator. It is designed to be easy to use and easy to extend.
+
+This section of the documentation will cover some of the more advanced (but optional) features of the framework.
+
+## Prerequisites
+
+To fully understand the features described in these chapters, it may be beneficial to first skim through the
+[Architecture Concepts](architecture-concepts) chapters, or at the very least, the [Core Concepts](core-concepts) page.
+
+You are also expected to have a basic understanding of PHP, and object-oriented programming principles.
+
+Having some familiarity with Laravel will also be beneficial, as HydePHP is built on top of the Laravel framework.
+
+## Table of Contents
+
+[Blade]: <ul>@foreach(glob(DocumentationPage::path('advanced-features/*.md')) as $file) <li> <a href="{{ basename($file, '.md') }}.html"> {{ Hyde::makeTitle(basename($file, '.md')) }} </a> </li> @endforeach</ul>

_docs/2.x/advanced-features/build-tasks.md

@@ -0,0 +1,191 @@
+# Custom Build Tasks
+
+## Introduction
+
+The Build Task API offers a simple way to hook into the build process.
+The build tasks are very powerful and allow for limitless customizability.
+
+The built-in Hyde features like sitemap generation and RSS feeds are created using tasks like these.
+Maybe you want to create your own, to for example upload the site to FTP or copy the files to a public directory?
+You can also overload the built-in tasks to customize them to your needs.
+
+## Good to know before you start
+
+### Types of tasks
+
+There are two types, PreBuildTasks and PostBuildTasks. As the names suggest, PreBuildTasks are executed before the site is built, and PostBuildTasks are executed after the site is built.
+
+To choose which type of task you want to create, you extend either the `PreBuildTask` or `PostBuildTask` class.
+Both of these have the exact same helpers and API available, so the only difference between them is when they are executed. The classes are otherwise identical.
+
+### About these examples
+
+For most of these examples we will focus on the PostBuildTasks as they are the most common.
+
+For all these examples we assume you put the file in the `App/Actions` directory, but you can put them anywhere.
+
+### Interacting with output
+
+In a way, build tasks are like micro-commands, as they can interact directly with the build commands I/O. Please take a look at the [Laravel Console Documentation](https://laravel.com/docs/10.x/artisan#command-io) for the full list of available methods.
+
+In addition, there are some extra helpers available in the base BuildTask class that allow you to fluently format output to the console, which you will see in the examples below.
+
+## Creating Build Tasks
+
+### Minimal example
+
+Here is a minimal example to give you an idea of what we are working with.
+
+```php
+class SimpleBuildTask extends PostBuildTask
+{
+    public function handle(): void
+    {
+        //
+    }
+}
+```
+
+As you can see, at their core, build tasks are simple classes containing a `handle()` method,
+which as I'm sure you have guessed, is the method that is executed when the task is run by the build command.
+
+If you want the task to run before the build, you would extend the `PreBuildTask` class instead.
+
+#### Automatic output
+
+When running the build command, you will see the following output added after the build is complete.
+
+<pre>
+ <span style="color: gold">Generic build task...</span> <span style="color: gray">Done in 0.26ms</span>
+</pre>
+
+As you can see, some extra output including execution time tracking is added for us. We can of course customize all of this if we want, as you will learn a bit further down.
+
+### Full example
+
+Here is a full example, with all the namespaces included, as well as the most common fluent output helpers.
+
+```php
+<?php
+
+namespace App\Actions;
+
+use Hyde\Framework\Features\BuildTasks\PostBuildTask;
+
+class ExampleTask extends PostBuildTask
+{
+    public static string $message = 'Say hello';
+
+    public function handle(): void
+    {
+        $this->info('Hello World!');
+    }
+
+    public function printFinishMessage(): void
+    {
+        $this->line('Goodbye World!');
+    }
+}
+```
+
+You can see a full API reference further below. But in short, the `$message` property is the message that runs before the task is executed, and the `printFinishMessage()` method is the message that runs after the task is executed.
+
+Running this task will produce the following output:
+
+<pre>
+<small style="color: gray">$ php hyde build</small>
+  <span style="color: gold">Say hello...</span> <span style="color: green">Hello World!</span>
+  Goodbye World!
+</pre>
+
+As you can see, there is no execution time tracking here, since we overrode the `printFinishMessage()` method that normally prints this. You can of course call the `withExecutionTime()` method to add this back in. See more in the API reference below.
+
+## Registering the Tasks
+
+There are a few ways to register these tasks so Hyde can find them.
+
+They are shown here in order of presumed convenience, but you are free to choose whichever you prefer. The latter options are more suited for extension developers.
+
+### Autodiscovery registration
+
+The easiest way to register build tasks is to not do it -- just let Hyde do it for you!
+
+Any classes that end in `BuildTask.php` that are stored in `app/Actions`  will be autoloaded and registered to run automatically.
+
+For example: `app/Actions/ExampleBuildTask.php`.
+
+### Config file registration
+
+If you want, you can also register build tasks of any namespace in the convenient `build_tasks` array which is in the main configuration file, `config/hyde.php`.
+
+```php
+// filepath config/hyde.php
+'build_tasks' => [
+    \App\Actions\SimpleTask::class,
+    \MyPackage\Tasks\MyBuildTask::class,
+],
+```
+
+### Programmatic registration
+
+>info This option assumes you are familiar with Laravel's service container and service providers.
+
+If you are developing an extension, you can either instruct users register your tasks with the config option above,
+or you can register the extensions programmatically, I recommend you do this in the `boot` method of a service provider.
+
+The build tasks are registered in an internal array of the `BuildService` class, which is bound as a singleton in the underlying Laravel service container.
+To actually register your task, provide the fully qualified class name of the task to the `BuildTaskService::registerTask()` method.
+
+Here is an example of how to do this using a service provider. Though you could technically do it anywhere using the `app()` helper,
+just as long as it's done early enough in the application lifecycle, so it's registered before the build command is executed.
+
+```php
+class MyServiceProvider extends ServiceProvider
+{
+    public function boot(): void
+    {
+        $this->app->make(\Hyde\Framework\Services\BuildTaskService::class)
+            ->registerTask(\MyPackage\Tasks\MyBuildTask::class);
+    }
+}
+```
+
+## Error Handling
+
+If an exception is thrown in a build task, the build command will catch it and display the error message to the user.
+
+## Helper Methods
+
+### Output helpers
+
+When a build task is called by the site build command, it gets access to the Laravel and Symfony console output helpers through the `$output` property.
+
+```php
+public function handle(): void
+{
+    /** @var \Illuminate\Console\OutputStyle $output */
+
+    $this->output->info('Hello World!');
+    $this->output->error('Something went wrong!');
+    $this->output->writeln('This is a line of text');
+}
+```
+
+### Skipping tasks
+
+>info This feature was added in HydePHP v1.6.0
+
+If you for some reason need to skip the task during its execution, you can call the `skip()` method.
+
+```php
+public function handle(): void
+{
+    if ($this->someCondition() !== true) {
+        $this->skip('Some condition was not met');
+
+        // The task will not be executed past this point
+    }
+}
+```
+
+This will then halt the execution of the task, and display a notice with the message you provided to the console.