Fix docs build with Hugo v0.128+ by replacing deprecated resources.ToCSS

[ShivamJha2436]

What this PR does:

Updates the Contour documentation site to work with Hugo v0.128+ by replacing the deprecated resources.ToCSS function with toCSS. This ensures that contributors using modern Hugo versions can build the docs without errors.

Why this is needed:

With Hugo v0.128 and above, resources.ToCSS was removed. Anyone trying to build the docs with these versions would encounter the following error:

ERROR deprecated: resources.ToCSS was deprecated in Hugo v0.128.0 and subsequently removed. Use css.Sass instead.

Notes:

• This change is fully backward compatible
• No functionality or content of the docs has been altered

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 81.85%. Comparing base (27752f6) to head (0bba81c).
⚠️ Report is 13 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #7270      +/-   ##
==========================================
+ Coverage   81.05%   81.85%   +0.79%     
==========================================
  Files         130      130              
  Lines       19669    15747    -3922     
==========================================
- Hits        15943    12889    -3054     
+ Misses       3442     2574     -868     
  Partials      284      284              

see 125 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[tsaarni]

Hi @ShivamJha2436, thank you for your contribution!

It looks like the netlify build succeeded even though we’re still using quite an old version defined here:

contour/netlify.toml

Line 7 in 31ba99f

HUGO_VERSION = "0.119.0"

Would you mind updating that as well?

[ShivamJha2436]

Hi @ShivamJha2436, thank you for your contribution!

It looks like the netlify build succeeded even though we’re still using quite an old version defined here:

contour/netlify.toml

Line 7 in 31ba99f

HUGO_VERSION = "0.119.0"

Would you mind updating that as well?

After updating to Hugo 0.152.0 with css.Sass, Netlify build fails due to GLIBC errors. We either need to update Netlify’s build image to Ubuntu 22.04+ or revert to the old toCSS pipeline; otherwise, the build won’t work.

[tsaarni]

Website build failed https://app.netlify.com/projects/projectcontour/deploys/68f7daa245e8a1000805ba77#L95

10:10:46 PM: $ hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL
10:10:46 PM: hugo: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_2.33' not found (required by hugo) hugo: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_2.32' not found (required by hugo)
hugo: /lib/x86_64-linux-gnu/libc.so.6: version GLIBC_2.34' not found (required by hugo) hugo: /lib/x86_64-linux-gnu/libstdc++.so.6: version GLIBCXX_3.4.29' not found (required by hugo)

I think this is because the OS image that netlify uses is old and new hugo binary would require bump to newer distro. Unfortunately I don't have access to our netlify portal to update that 😞 Lets try to revert the hugo version back to original and lets see if the old version handles the css.Sass call.

[tsaarni]

After updating to Hugo 0.152.0 with css.Sass, Netlify build fails due to GLIBC errors. We either need to update Netlify’s build image to Ubuntu 22.04+ or revert to the old toCSS pipeline; otherwise, the build won’t work.

Oops, sorry I missed your message when responding.

[ShivamJha2436]

Hey @tsaarni, could you please approve the workflows when you get a chance?
I’ve tested the changes locally and everything looks good, so I think this PR should be good to go once the checks run successfully.

[tsaarni]

Hi @ShivamJha2436,
I’ve now updated the OS image to Ubuntu 24.04 at Netlify. Could you please add the latest Hugo to the PR again? Sorry for the back-and-forth with the versions 😊

[ShivamJha2436]

Thanks, @tsaarni! I’ve bumped Hugo to the latest version.

[tsaarni]

That did the trick 🎉 Thanks @ShivamJha2436 for your contribution, really appreciate it.