From cb12595439c3f801e7f18970771445760bf5d4f7 Mon Sep 17 00:00:00 2001 From: Dimitrie Hoekstra Date: Thu, 27 Aug 2026 12:21:45 +0200 Subject: [PATCH 1/2] handbook: point Edit this page at Studio The handbook tells everyone that Edit this page opens Nuxt Studio and needs no git knowledge, but the link opened GitHub's file editor. Point it at the Studio route instead, carrying the current path in ?redirect= the way Studio's own shortcut does, so a signed-in visitor gets the editor on the page they are reading and everyone else signs in and comes back to it. GitHub stays available as a second link. The route comes from the module's runtime config rather than a repeated literal. Docs pages keep their GitHub link: that markdown lives in FlowFuse/flowfuse, which Studio is not configured for. The Node-RED and hardware guides keep theirs too, since they are still 11ty pages and carry no Nuxt app for Studio to mount on. Also corrects two handbook references to src/handbook/, which moved to nuxt/content/handbook/ during the migration. --- nuxt/content/handbook/company/guides/git.md | 2 +- nuxt/content/handbook/index.md | 2 +- nuxt/pages/handbook/[...slug].vue | 11 ++++++++++- 3 files changed, 12 insertions(+), 3 deletions(-) diff --git a/nuxt/content/handbook/company/guides/git.md b/nuxt/content/handbook/company/guides/git.md index 51d357a02d..92580b5e5e 100644 --- a/nuxt/content/handbook/company/guides/git.md +++ b/nuxt/content/handbook/company/guides/git.md @@ -28,7 +28,7 @@ If you are comfortable with Git and the command line, you can contribute directl 1. Check out the latest `main` branch. 2. Create a new branch with a descriptive `kebab-case` name. -3. Edit files under `src/handbook/` (the source of truth for handbook content). +3. Edit files under `nuxt/content/handbook/` (the source of truth for handbook content). 4. Commit your changes and push the branch. 5. Open a Pull Request on GitHub and assign a reviewer. 6. Once approved, the reviewer merges the PR. diff --git a/nuxt/content/handbook/index.md b/nuxt/content/handbook/index.md index a296bba9ae..67e147580b 100644 --- a/nuxt/content/handbook/index.md +++ b/nuxt/content/handbook/index.md @@ -38,7 +38,7 @@ shared in this handbook. The handbook can be edited by anyone at FlowFuse using **Nuxt Studio**, our CMS. Click **"Edit this page"** on any handbook page to open the editor, make your changes, and submit them for review. No Git knowledge required. -Engineers and others comfortable with Git can also contribute directly via pull-request on [GitHub](https://github.com/FlowFuse/website/tree/main/src/handbook). +Engineers and others comfortable with Git can also contribute directly via pull-request on [GitHub](https://github.com/FlowFuse/website/tree/main/nuxt/content/handbook). The handbook is here for the whole company to help maintain. **Contributions are welcome and strongly encouraged**. diff --git a/nuxt/pages/handbook/[...slug].vue b/nuxt/pages/handbook/[...slug].vue index a9272a9a8e..b2a2588966 100644 --- a/nuxt/pages/handbook/[...slug].vue +++ b/nuxt/pages/handbook/[...slug].vue @@ -49,6 +49,13 @@ const githubEditUrl = computed(() => { return `https://github.com/FlowFuse/website/edit/main/nuxt/content/${stem}.md` }) +// Studio mounts its editor on whichever page you are viewing once you have a session, so +// this link only has to carry you through sign-in and back. `?redirect=` is the parameter +// Studio's own keyboard shortcut uses. Docs pages keep their GitHub link, since that +// markdown lives in FlowFuse/flowfuse and Studio is configured for this repository. +const studioRoute = useRuntimeConfig().public.studio?.route || '/_studio' +const studioEditUrl = computed(() => `${studioRoute}?redirect=${encodeURIComponent(route.path)}`) + const breadcrumbItems = computed(() => { // findPageBreadcrumb excludes the current page unless told otherwise - `current: true` // includes it so it can be the last, unlinked crumb below. @@ -109,7 +116,9 @@ defineOgImage('Default', {
- Edit this page + Edit this page + + GitHub
From 4502b69b671326f3b58440a80f504608b848ba0b Mon Sep 17 00:00:00 2001 From: Dimitrie Hoekstra Date: Thu, 27 Aug 2026 12:49:02 +0200 Subject: [PATCH 2/2] handbook: render the edit links client-side hyperlink, the link checker in the shared build workflow, reads /_studio as a broken link because that route has no prerendered file, and the tool takes no ignore list. pages/docs/[...slug].vue already keeps its edit link out of the static HTML this way. --- nuxt/pages/handbook/[...slug].vue | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/nuxt/pages/handbook/[...slug].vue b/nuxt/pages/handbook/[...slug].vue index b2a2588966..518747287e 100644 --- a/nuxt/pages/handbook/[...slug].vue +++ b/nuxt/pages/handbook/[...slug].vue @@ -115,11 +115,17 @@ defineOgImage('Default', {
-
- Edit this page - - GitHub -
+ + +
+ Edit this page + + GitHub +
+