Installation

Install from vue cli

vue add vuepress

Prompt commands

custom configuration file ? (y/N)

Allow you to custom default vuepress configuration. By default No

input docs directory (docs)

type your docs directory, relative to root project folder. By default /docs

Title for the site

Title for documentation by default project name locate inside package.json

Docs will be deploy to GitHub or GitLab ? (y/N)

you can lazy configure vuepress to deploy doc for github or gitlab. By default No

Choose repo type

Choose a git platform between github or gitlab

WARNING

if you choose gitlab, a gitlab-ci.yml will be create in root project folder

Select url type to deploy your project

Select type to display docs

Insert repo name (default project name)

repository name

Add project components

by default you could add component in .vuepress/components folder to use inside markdown page. Often you need to expose components from your vue project (generally locate at src/components). Now you can assign directly your components to vuepress with prompts command. Congrats! your components are enabled inside vuepress

do it

# page

<myprojectcomponent />

Run Commands

after install you can see two new scripts command.

  • docs:dev launch dev server to serve docs with hotreload
  • docs:build build your doc inside output directory
yarn docs:dev

//or

yarn docs:build

See more configuration options config vuepress

vuepress website