mirror of
https://github.com/yannbertrand/macos-defaults
synced 2024-12-17 06:53:10 +00:00
1.4 KiB
1.4 KiB
VuePress Build
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