Properly set baseURL for the User Guide

[chalin]

• Fixes the User-guide Hugo-config param baseURL, setting it to the full site URL, as recommended by Hugo folks; see https://discourse.gohugo.io/t/permalink-not-permalinking/42613.
• In preparation for Breadcrumb links should be encoded as local path not external URLs #1337 (comment)

[fekete-robert]

We usually use different hugo environments, and set the baseurl to / in the default one, which works for local builds, and set it to the full url in the production environment, which is used for the prod deployment. (And also set the GA id and similar only in prod.)

[emckean]

Oh, maybe we can add that as a best-practice tip in the docs?

[chalin]

For the projects I work on, including the setup for the User Guide: the base config for production. We pass in a different baseURL for preview builds:

docsy/userguide/package.json

Line 9 in eaba498

"build:preview": "npm run _hugo-dev -- --minify --baseURL \"${DEPLOY_PRIME_URL:-/}\"",

Dev builds are handled like this:

docsy/userguide/package.json

Line 7 in eaba498

"_hugo-dev": "npm run _hugo -- -e dev -DFE",