Mirrors/macos-defaults
2
0
Fork 0
mirror of https://github.com/yannbertrand/macos-defaults synced 2024-12-15 06:02:40 +00:00
Code Issues Projects Releases Packages Wiki Activity
macos-defaults/build/vuepress
History
snyk-bot 797ac73dcc
⬆️ Upgrade yaml from 1.10.0 to 1.10.2 
Snyk has created this PR to upgrade yaml from 1.10.0 to 1.10.2.

See this package in npm:


See this project in Snyk:
https://app.snyk.io/org/yannbertrand/project/eff73e73-6826-4597-a8ef-92a0e5e9976a?utm_source=github&utm_medium=upgrade-pr
2021-04-10 09:06:00 +02:00
..
__mocks__ 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
__snapshots__ 💄 Add Netlify image width & height 2020-11-07 12:16:05 +01:00
templates 💄 Add Netlify image width & height 2020-11-07 12:16:05 +01:00
build.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
netlify.toml 🌐 Add config internationalization support 2020-09-26 20:24:54 +02:00
package.json ⬆️ Upgrade yaml from 1.10.0 to 1.10.2 2021-04-10 09:06:00 +02:00
readme.md 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
write-categories.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
write-categories.test.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
write-config.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
write-config.test.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
write-homepage.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
write-homepage.test.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
write-pages.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
write-pages.test.js 🚨 Run Prettier 2020-11-27 14:39:16 +01:00
yarn.lock ⬆️ Upgrade yaml from 1.10.0 to 1.10.2 2021-04-10 09:06:00 +02:00

readme.md

VuePress Build

VuePress build status

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