nuxt: migrate handbook to Nuxt with @nuxt/content#5065
Open
ZJvandeWeg wants to merge 3 commits into
Open
Conversation
Adds a three-column handbook layout (left nav / content / TOC) served by Nuxt, replacing 11ty for /handbook/** routes. Includes multi-level nav tree, Algolia search, scroll-spy TOC, breadcrumbs, and a remark plugin to resolve relative image/link paths under the trailing-slash URL scheme Nuxt uses. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
👷 Deploy Preview for flowforge-website processing.
|
Use git mv to transfer all 167 handbook markdown pages into the Nuxt content directory, picking up the four files that changed on main after the initial migration commit: - company/security/ai-development-and-customer-data.md (new AI tools section) - marketing/blog.md (AI tag, updated content calendar link) - marketing/messaging.md (new sales tech stack; expand Nunjucks template var site.messaging.shortDescription to its literal value for Nuxt) - sales/index.md (new sales tech stack section) Two 11ty-only .njk templates (features.njk, subscription-agreement-1.5.njk) are moved along with their directories; they will be removed when the 11ty handbook collection is cleaned up in the next commit. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- git mv src/handbook/images → nuxt/public/handbook/images so the 53
handbook images are tracked in git and served statically by Nuxt
- Update nuxt/.gitignore: narrow the public/ exclusion so only
public/handbook/images/ is tracked; all other 11ty-generated
public/ output remains gitignored
- Update clean:nuxt script to preserve public/handbook/ during build
cleans so committed images survive the rimraf step
- Remove handbook.json (11ty collection config) and LICENSE
- Remove two 11ty-only .njk templates that had no Nuxt equivalent
(engineering/product/features.njk, sales/subscription-agreement-1.5.njk)
- Drop handbookBreadcrumbs and rewriteHandbookLinks filters from
.eleventy.js (no longer needed)
- Remove createNav('handbook') call and update inline comments
- Strip /handbook/ from the docsFeatureBadges URL pattern
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
ZJvandeWeg
requested review from
MichaelBDavis,
PabloFilomeno83,
Yndira-E and
knolleary
as code owners
5 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a three-column handbook layout (left nav / content / TOC) served by Nuxt, replacing 11ty for /handbook/** routes. Includes multi-level nav tree, Algolia search, scroll-spy TOC, breadcrumbs, and a remark plugin to resolve relative image/link paths under the trailing-slash URL scheme Nuxt uses.
Related Issue(s)
Checklist