VuePress Build

⚠️ VuePress build is not maintained anymore. Please note we were using VuePress@1.9.1 at the time.

My opinion

VuePress was really easy to setup.

😄 Good

Really easy to setup & deploy
Default theme is nice
It's possible to use Vue components
Development mode is pleasant

😕 Bad

Documentation is not super easy
Lack of other official themes

😫 Ugly

🤷‍♂️

How does it work?

Here is the built website architecture:

.vuepress/config.yml
- Contains the whole VuePress configuration from title to sidebar config
readme.md
- The main page content

All the other pages (including translations) are markdown files that are carefully put under their folder (e.g. screenshot/disable-shadow.md). Assets are stored at the same level.

There is a second build phase where VuePress generates the static website.

I also added the @vuepress/medium-zoom plugin to add Medium zoom on images.

Try locally

🏗 Install

yarn install

🚀 Usage

This will build the defaults.yml file and run a VuePress server on http://localhost:8080/. Sources of the website are available in the docs folder.

yarn start

🚧 Run unit tests

yarn test

1.4 KiB Raw Blame History