Justme.dev

Appearance

Justme.dev

WatchersStarsForksCSSTypescriptVueView on Github

This site's source code is also available on GitHub. I needed a static site generator. VitePress is specifically designed for static documentation websites. Built on top of Vue, a modern build tool for frontend development.

This VitePress site is hosted from GitHub.io pages at justme.dev.

Requirements ​

Node version manager ​

bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install
nvm use

Python & pip ​

bash
sudo apt install python3
python3 -m pip install --upgrade pip
pip install -r requirements.txt

Install dependencies ​

bash
npm install

How to use ​

Generate content ​

Downloads readme files from GitHub repositories.

bash
npm run docs:generate

Development ​

bash
npm run docs:dev

Build ​

bash
npm run docs:build

Preview build ​

bash
npm run docs:preview

Deploy ​

Commit to the main branch to trigger deployment.

Notes ​

  • Create request files in the requests folder.
  • Run the npm run docs:generate command to generate the markdown files locally.
  • When pushing to main GitHub action does generate, build and deploy.
  • The generated markdown will be saved in a sub folder defined by request type using the same name as the request file and the suffix .md.