Skip to content

Conversation

@welpo
Copy link
Contributor

@welpo welpo commented Apr 26, 2025

Summary

Adds documentation to help users solve a common issue with Zola deployments on Cloudflare Pages where preview deployments don't properly load stylesheets due to base URL configuration. Example: welpo/tabi#521

Documentation checklist

@hyperlint-ai
Copy link
Contributor

hyperlint-ai bot commented Apr 26, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.


PR Change Summary

Enhanced documentation for Zola deployments on Cloudflare Pages to address base URL configuration issues during preview deployments.

  • Added section on handling preview deployments for Zola sites
  • Provided a dynamic build command to set base URL based on the environment
  • Clarified the impact of hardcoded base URLs on asset loading

Modified Files

  • src/content/docs/pages/framework-guides/deploy-a-zola-site.mdx

How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

@ToriLindsay ToriLindsay requested review from kodster28 and removed request for ToriLindsay June 6, 2025 11:32
@ToriLindsay ToriLindsay assigned kodster28 and unassigned ToriLindsay Jun 6, 2025
@kodster28 kodster28 enabled auto-merge (squash) August 12, 2025 16:16
@kodster28 kodster28 merged commit dee6314 into cloudflare:production Aug 12, 2025
2 checks passed
@workers-devprod workers-devprod added the contribution [Holopin] Recognizes a docs contribution, big or small label Aug 12, 2025
@holopin-bot
Copy link

holopin-bot bot commented Aug 12, 2025

Congratulations @welpo, the maintainer of this repository has issued you a holobyte! Here it is: https://holopin.io/holobyte/cme8rb03m055107l8vj8m7mjn

This badge can only be claimed by you, so make sure that your GitHub account is linked to your Holopin account. You can manage those preferences here: https://holopin.io/account.
Or if you're new to Holopin, you can simply sign up with GitHub, which will do the trick!

thomasgauvin pushed a commit that referenced this pull request Aug 15, 2025
* add dynamic base URL config for Zola preview deployments

* use config.toml base_url

* Update src/content/docs/pages/framework-guides/deploy-a-zola-site.mdx

---------

Co-authored-by: Kody Jackson <[email protected]>
@welpo welpo deleted the patch-5 branch August 25, 2025 19:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

contribution [Holopin] Recognizes a docs contribution, big or small product:pages size/s

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants