feat: VitePress documentation site with SAP Fiori styling#15
Merged
jung-thomas merged 12 commits intomainfrom Apr 22, 2026
Merged
feat: VitePress documentation site with SAP Fiori styling#15jung-thomas merged 12 commits intomainfrom
jung-thomas merged 12 commits intomainfrom
Conversation
- Add version badge to FioriShellbar (MAJOR) - CI uses npm run build not npx vitepress build (MAJOR) - Fix --vp-c-bg-soft mapping to --sapContent_ForegroundColor - Use --sapFontFamily variable with fallback - Add og-image.svg to public/ and og:image meta - Add Overview (homepage) to Getting Started sidebar
…ive import - Add .vitepress/config.mts: full site config with nav, nested sidebar, archive sidebar loaded from archive-sidebar.json, local search, theme, base path, and vue/vite settings - Add index.md with FioriHome layout frontmatter (placeholder for Task 4) - Extend copy-content.js with escapeArchiveContent() to sanitize pseudo-HTML tags in archive docs (<uuid>, <id>, <query>, etc.) that would break Vue's template compiler; escapes non-HTML5 tags outside fenced code blocks
…s bridge All @import statements consolidated at top of style.css (CSS spec compliance, eliminates Vite ordering warnings). Dark mode overrides scoped to html.dark. VitePress variable bridge maps --sap* custom properties to --vp-c-* tokens.
The previous approach registered FioriHome as a global Vue component, but VitePress's custom Layout() override doesn't resolve frontmatter layout values to registered components. Detect layout === 'FioriHome' directly in Layout() and render the component with shellbar above it.
- C1: add copy-content.js to build script so npm run build works standalone - I1: expand isCustomElement HTML5 set to full spec (matches copy-content.js) - I2: handle up to 3 spaces of indentation for fenced code block detection - I3: add explicit contents:read permission in GitHub Actions workflow
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.
Summary
docs-site/with SAP Fundamental Styles (sap_horizonlight/dark themes)docs/superpowers/as a "Design Archive" sidebar section/docs/at build time (single source of truth)Architecture
Notable design decisions
{{ }}template syntax, pseudo-HTML<placeholder>tags)isCustomElementwith regex guard: Only lowercase tags hit the custom element path; PascalCase Vue components are unaffectedguide/,developer/,archive/dirs are in.gitignoreand regenerated every buildTest plan
npm run buildcompletes without errors (42s, 110 archive pages)