@vuepress/plugin-register-components

register-components plugin for vuepress

Install

yarn add -D @vuepress/plugin-register-components@next
# OR npm install -D @vuepress/plugin-register-components@next

Usage

module.exports = {
  plugins: ['@vuepress/register-components']
}

Options

componentsDir

  • Type: Array | String
  • Default: []

All components in this directory will be registered as global components, naming of components will follow the components found in .vuepress/components.

module.exports = {
  plugins: [
    [
      'register-components',
      {
        componentsDir: somepath
      }
    ]
  ]
}

components

  • Type: { name: string, path: string }
  • Default: []

Register global components by explicit name and path.

module.exports = {
  plugins: [
    [
      'register-components',
      {
        components: [
          {
            name: 'V-Card',
            path: 'path/to/card.vue'
          }
        ]
      }
    ]
  ]
}

getComponentName

  • Type: (file: string) => string
  • Default: file => file.replace(/\/|\\/g, '-')

Customize component names for files under componentsDir.