docs(infra): Upgrade Docsy and Hugo #378
Draft
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Fixes: #377
Upgrade Docsy to 0.7.1 as a Go module.
Upgrade Hugo to 0.110.0, which is the minimum version required by Docsy. I didn't upgrade to the latest Hugo because Docsy hasn't been tested with it yet.
Note: --minify in the build command causes failure
There is an awful lot of custom CSS, and this is causing issues with the landing page. The latest version of Docsy uses a newer version of Bootstrap than when this site was ported to Hugo/Docsy 3+ years ago. I'm not a front end developer so CSS at this level is really not in my skillset.
What's broken:
The landing page was implemented as a template (partials/index.html). Looks like this was done to be able to iterate through and render the data in
data
folder. The index template is all CSS styling rather than Docsy's blocks shortcodes because you can't use shortcodes in templates.The landing page has some sections that are supposed to display data in card format (and it's broken). Docsy has a new Card shortcode, but we can't call that in the index.html template. Bootstrap 5 also has a card component, so I'm wondering if the spinnaker.io's custom CSS (assets/scss) is overriding the Bootstrap styles.
The landing page jumbrotron image is supposed to look like:
but instead what happens is the text appears for an instant and then is gone - poof! Also I can almost see the "Spinnaker" site title, so again I think this is a CSS issue. I don't know why there is so much custom styling overriding the core theme components' styling.