Troubleshooting

Search modal does not open

  • Confirm search.json is generated and reachable at /search.json.
  • Confirm assets/js/vitepress-theme.js is loaded.
  • Verify vp_theme.sidebar_collections points to existing Jekyll collections.
  • Ensure each collection has documents with front matter.

Last updated does not appear

  • Ensure plugin is enabled:
plugins:
  - jekyll-vitepress-theme

Theme looks unstyled

  • Confirm these files are present and served:
    • assets/css/vitepress-core.css
    • assets/css/vitepress-components.css
    • assets/css/vitepress-overrides.css