Set correct source directory for jekyll gh-action page and add {{ site.ur l}} to fix links and styling

[danadoherty639]

Summary

The jekyll gh-pages action "sources" its documentation from the root "/" of the repository however respec-puppet holds its documentation under a sub-directory /docs. This points the action to the correct directory to build the documention from with more advanced configuration options under /docs/config.yml. This PR also fixes the issue with the broken links by using Jekyll's global variable site.url configured in /docs/config.yaml. The default css theming is expected to be served from the default root directory and ours is respec-puppet and the site.url is used to fixed this and serve the css from the correct location.

Related Issues (if any)

Mention any related issues or pull requests.

Checklist

• Manually verified. https://puppetlabs.github.io/rspec-puppet/

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 86.80%. Comparing base (2c8b9cf) to head (5bc8f9e).
Report is 2 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #123   +/-   ##
=======================================
  Coverage   86.80%   86.80%           
=======================================
  Files          35       35           
  Lines        2092     2092           
=======================================
  Hits         1816     1816           
  Misses        276      276           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ekohl]

I'd consistently use baseurl instead of including the whole domain

Suggested change

	<p>Then continue on to the <a href="{{site.url}}/tutorial">tutorial!</a></p>
	<p>Then continue on to the <a href="{{site.baseurl}}/tutorial">tutorial!</a></p>

[danadoherty639]

its better to use site.url across these pages, otherwise it has difficulty loading in the CSS, even when Ive tried to concat the jekyll variables, the CSS still fails to loads.

This code produces the below output href="{{site.url}}/{{site.baseurl}}/assets/css/styles.css">

From the description of site.baseurl you would think its something we need as it mentions using this if your site is served from a sub directory, i find this slightly confusing as we are serving our documentation from ./docs but we would only need baseurl if our project site was https://puppetlabs.github.io/rspec-puppet/docs and ./docs being the subdomain but as thats not the case we do not need baseurl as its not served from subdomain

[danadoherty639]

Any reason you need to use {{ site.url }} instead of {{ site.baseurl }}?

Ive tested this with baseurl but if I remember, it broke the css, I will test this out again this morning before opening the PR