# 与 VuePress 的区别

VitePress 和 VuePress 有不同的设计目标. 这两个项目共享相似的配置命名约定. VitePress 的目标是为编写文档提供最基本的功能. 其他特性被推到主题中. 另一方面, VuePress 拥有更多的开箱即用的特性, 或者由它的插件生态系统支持的特性.

如果您决定将您的项目移到 VitePress, 以下是您需要考虑的与VuePress v1.7.1的不同之处.

# General

• Missing
  • YAML and TOML are not supported formats for site config. Only javascript is supported for .vitepress/config.js
  • Plugins support, features are implemented in themes
  • permalink support
  • .vitepress/templates
  • Components in .vitepress/components are not auto registered as global components
• Differences
  • Public files that are directly copied to dist root moved from .vitepress/public/ is public/
  • styling .vitepress/styles/index.styl and .vitepress/styles/palette.styl is .vitepress/style.styl
  • App Level Enhancements API, app enhancements .vitepress/enhanceApp.js is .vitepress/theme/index.js.

# Markdown

• Missing
  • Support for toml in frontmatter
  • details block
  • markdown slots guide/using-vue.html#using-components).
  • ~ prefix to explicitly specify a url is a webpack module request

# Site Config

• Missing
  • temp
  • dest
  • theme from a dependency
  • permalink
  • port
  • shouldPrefetch
  • cache
  • extraWatchFiles
  • patterns
  • plugins
  • markdown.pageSuffix
  • markdown.slugify
  • markdown.plugins
  • markdown.extractHeaders
  • markdown.extendMarkdown to markdown.config
  • configureWebpack, chainWebpack, postcss, Stylus, scss, Sass, less configs
  • evergreen

# Default Theme Config

• Missing
  • smoothScroll
  • displayAllHeaders
  • activeHeaderLinks
  • sidebarDepth and initialOpenGroupIndex for sidebar groups
• Differences
  • searchMaxSuggestions is search.maxSuggestions
  • algolia is search.algolia
  • searchPlaceholder is search.placeholder

# Default Theme

• Missing
  • <code-group> and <code-block>

# Computed Globals

• Missing
  • $lang
  • $localePath

# Frontmatter Predefined Variables

• Missing
  • description
  • meta
  • metaTitle
  • lang
  • layout
  • permalink
  • canonicalUrl

# Frontmatter Default Theme Variables

• Missing
  • prev, next
  • search
  • tags
  • pageClass
  • layout

# siteData

• Missing
  • pages

# pageData

• Missing
  • key
  • path
  • regularPath

# Global Components

• Missing
  • <Badge>