Add a safer output directory config option to replace deprecated setting

[caendesilva]

About

The hyde.site_output_path option was recently deprecated. This update adds an alternative which resolves the relative path within the service provider. This makes it safer to set the output directory to something within the project. If one wants to use an absolute path outside the project that must be done in a service provider, which has now been documented.

Warning
Hyde deletes all files in the output directory before compiling the site. Don't set this path to a directory that contains important files!

If you want to store your compiled website in a different directory than the default _pages, you can change the path using the following configuration option in config/hyde.php. The path is expected to be relative to your project root.

// filepath config/hyde.php
return [
    'output_directory' => 'docs',
];

Setting an absolute path

If you want to store the output website outside your project with an absolute path you may do so at your own risk using a service provider. This is not supported or recommended as it may cause unintentional file deletions.

// filepath Boot method of a service provider
StaticPageBuilder::$outputPath = '/var/www/my-project/';

[codecov]

Codecov Report

Merging #106 (e2ea08b) into master (e0636e5) will decrease coverage by 0.10%.
The diff coverage is 60.00%.

@@             Coverage Diff              @@
##             master     #106      +/-   ##
============================================
- Coverage     99.01%   98.91%   -0.11%     
- Complexity      742      743       +1     
============================================
  Files            95       95              
  Lines          1929     1932       +3     
============================================
+ Hits           1910     1911       +1     
- Misses           19       21       +2     

Impacted Files	Coverage Δ
packages/framework/src/HydeServiceProvider.php	93.75% <60.00%> (-6.25%)	⬇️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update e0636e5...e2ea08b. Read the comment docs.

[caendesilva]

Think it's okay that we lost some coverage since the deprecated method will be removed soon