Skip to content

docs: replace 11ty shortcodes with Nuxt syntax - #8694

Merged
dimitrieh merged 1 commit into
mainfrom
docs/nuxt-callouts
Sep 29, 2026
Merged

dimitrieh merged 1 commit into
mainfrom
docs/nuxt-callouts

Conversation

@Yndira-E

Copy link
Copy Markdown
Contributor

Description

  • Replace legacy 11ty note and warning shortcodes with Nuxt MDC callouts.
  • Replace the Nunjucks HubSpot form include with the Nuxt HubSpotForm component.

Related Issue(s)

Checklist

  • I have read the contribution guidelines
  • Suitable unit/system level tests have been added and they pass
  • Documentation has been updated
    • Upgrade instructions
    • Configuration details
    • Concepts
  • Changes flowforge.yml?
    • Issue/PR raised on FlowFuse/helm to update ConfigMap Template
    • Issue/PR raised on FlowFuse/CloudProject to update values for Staging/Production
  • Link to Changelog Entry PR, or note why one is not needed.

Labels

  • Includes a DB migration? -> add the area:migration label

@Yndira-E

Copy link
Copy Markdown
Contributor Author

@dimitrieh you're working on the docs, not sure if this will clash with your work, but we need to render the form as soon as possible.

@dimitrieh

Copy link
Copy Markdown
Contributor

Yndira, no clash with my docs work: none of my open PRs touch these files. Looking good from my end!

The form is missing on the live page because the website's docs import silently strips any leftover Nunjucks tag (convertCallouts). This brings it back once merged, since the merge triggers a website rebuild. Two things to know:

  • The callouts render as Nuxt UI notes (icon, no "Note"/"Warning" title), the same as the handbook, rather than the current ff-callout boxes. Worth a look on the site once it's live.
  • After this, that conversion and the ff-callout styles are unused for the docs. Ideally the website build fails on a leftover {% rather than dropping it, so a missing form like this one gets caught.

@dimitrieh
dimitrieh merged commit 4541cc5 into main Sep 29, 2026
15 checks passed
@dimitrieh
dimitrieh deleted the docs/nuxt-callouts branch September 29, 2026 12:59
@dimitrieh

Copy link
Copy Markdown
Contributor

Follow-up on the website side: FlowFuse/website#5890

Correction to my comment above: the ff-callout styles were not unused, the website's own pages under /docs still had them. That PR moves those to ::note too, so /docs has one callout style, and a leftover {% now fails the build.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants