Embed example manifests inline via shortcode (#960)

[jonasz-lasut]

Replaces the inconsistent mix of save-and-apply YAML, kubectl heredocs, and duplicated manifest files with a single mechanism: example manifests live as real .yaml files under
content//manifests/.yaml, embedded into prose by a new {{< manifest >}} shortcode and simultaneously published as fetchable URLs at https://docs.crossplane.io/<ver>/manifests/... so readers can run kubectl apply -f <url> directly.

I see room for improvement in the future by moving Function manifests to a separate directory and use the shared functions in all docs across all versions as this way we'll be able to update Function versions in one place only.

Fixes #960

Changes:

• Adds a Hugo module mount in config.yaml that re-exposes content/<ver>/manifests/**.yaml under static/, so each manifest publishes verbatim at its natural URL.

• Adds themes/geekboot/layouts/shortcodes/manifest.html. Required arg path= names the manifest relative to the calling page's version. The shortcode auto-derives the version segment from .Page.File.Path so authors never type version strings. Optional args: apply="false" suppresses the kubectl block; command= overrides the default verb (kubectl apply -f); label= wraps the rendered YAML in <div label="..."> so existing {{< hover label="..." >}} annotations keep working. Hostname is based on base URL so preview deploys still emit usable kubectl URLs.

[netlify]

✅ Deploy Preview for crossplane ready!

Name	Link
🔨 Latest commit	dd2ebb5
🔍 Latest deploy log	https://app.netlify.com/projects/crossplane/deploys/6a02882e96951500088f0341
😎 Deploy Preview	https://deploy-preview-1086--crossplane.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
Lighthouse	1 paths audited Performance: 93 (no change from production) Accessibility: 90 (🔴 down 2 from production) Best Practices: 92 (no change from production) SEO: 100 (no change from production) PWA: 70 (no change from production) View the detailed breakdown and full score reports

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[tr0njavolta]

Thanks for the contribution @jonasz-lasut! I was able to review and test:

• Core functionality
  • kubectl apply -f works
  • kubectl edit -f works
  • kubectl apply --dry-run=client passes for all manifests across all versions
  • Missing manifest file returns build error.
• Shortcode combinations
  • {{< manifest >}} inside {{< tabs >}} works
  • {{< manifest >}} inside {{< expand >}} works
  • apply="false" inside {{< hint >}} works
  • {{< hover >}} on manifests works

Couple things I noticed:

• Hover targeting a manifest inside a tab doesn't render the line highlighting but isn't a blocking error.
• Local hugo build absURL produces //localhost/1313/.... Doesn't affect production but breaks copy-paste testing during doc authoring. Manually updating to http://localhost/1313/... works.

I created a PR to your forked branch to add usage information to the docs code styling guide.. Once that's accepted or edited, we'll be good to approve and merge 🚀

[tr0njavolta]

Requesting a usage guide for the shortcode in https://docs.crossplane.io/contribute/code-style-guide/. Created a PR here

[jonasz-lasut]

Really appreciate the review @tr0njavolta
I've merged the PR that you've opened against my fork without changes, thank you for finding time to test all functionalities.

I'll take a look at fixing hover inside a tab and localhost baseUrl in the follow-up PR sometime next week :)

[jonasz-lasut]

Looks like your commit was missing a signoff, I've invited you as a collaborator on my fork so you should be able to push directly to the branch

[jbw976]

thank you so much for taking this on @jonasz-lasut, i think it's a lot easier/quicker to walk through the interactive guides now than the previous approach of copying the content to a file each time. This is very appreciated!! 🙇

I added two small comments of things I noticed, none of them are explicitly blocking - I'll add my approval on as well and we can merge tomorrow either way 😁

[jbw976]

one funny thing i noticed is that the manifest code blocks now seem to use a blue/green color for their line numbers, when before they were a grey color. Is something in the logic here affecting that? Compare the line number colors on these two:

Current: https://docs.crossplane.io/v2.2/guides/change-logs/#configure-permissions

NEW: https://deploy-preview-1086--crossplane.netlify.app/v2.2/guides/change-logs/#configure-permissions

[jbw976]

is it also worth mentioning the manifest-url function in this contributing guide page? i see it used quite a lot on some pages like https://deploy-preview-1086--crossplane.netlify.app/v2.2/get-started/get-started-with-composition/

[tr0njavolta]

Thanks for calling this out - added a mention in the contributing guide.