Allow site output directory to be customized

[caendesilva]

Introduces a new config option:

/*
|--------------------------------------------------------------------------
| Site Output Directory (Experimental 🧪)
|--------------------------------------------------------------------------
|
| If you want to store your compiled website in a different directory than
| the default `_pages`, you can change the path here. The Hyde::path()
| helper ensures the path is relative to your Hyde project. While
| you can set the path to an absolute path outside the project,
| this is not officially supported and may be unstable.
|
*/

'siteOutputPath' => 'C:\xampp\htdocs',

Which is then registered in the HydeServiceProvider.

$this->storeCompiledSiteIn(config(
    'hyde.siteOutputPath', Hyde::path('_site')
));

The registered property value is stored in the StaticPageBuilder.

protected function storeCompiledSiteIn(string $directory): void
{
    StaticPageBuilder::$outputPath = $directory;
}

And the path can be accessed fluently through the helpers

Hyde::getSiteOutputPath() // Absolute base path
Hyde::getSiteOutputPath('foo.html') // File within the base path

Hyde::getRelativeSiteOutputPath() // Base path relative to the Hyde project
Hyde::getRelativeSiteOutputPath('foo.html') // Relative filepath to same

Will fix #351

[caendesilva]

While not officially supported, for me it works wonders to use absolute paths leading to outside the project root.

// config/hyde.php
'siteOutputPath' => 'C:\xampp\htdocs',

All done! Finished in 1.73 seconds. (1,733.34ms)
Congratulations! 🎉 Your static site has been built!
Your new homepage is stored here -> file://C:/xampp/htdocs/index.html

Edit: I did not think this would work, but it actually can prettify external files using Prettier as well.

Prettifying code! This may take a second.
C:\xampp\htdocs\404.html 271ms
C:\xampp\htdocs\blade.html 235ms
C:\xampp\htdocs\docs\headings.html 35ms
C:\xampp\htdocs\docs\index.html 33ms