A first draft for the proposed Skywoman website.
You will need Node.js and git installed as a prerequisite.
In your terminal, clone this repository and cd
into the repo:
git clone https://github.com/skywoman/skywoman.coop.git
cd skywoman.coop
Install the Node dependencies:
npm i
Start the local development server:
npm start
In your terminal you should now see the dev server start up, with hot reloading enabled:
> [email protected] start
> npm run docs:dev
> [email protected] docs:dev
> vitepress dev docs
vitepress v0.22.3
> Local: http://localhost:3000/
> Network: use `--host` to expose
Open your browser to https://localhost:3000/. When you save any changes in the docs/
directory, you should see those changes automatically propagated to the browser window.
Content can be added by creating new markdown files and/or directories in docs/
, which will be mapped to corresponding routes.
Currently, there is just one page, ./docs/index.md
, which is setup as a single landing page, with pods represented in the ./docs/pods.yml
file.
The site is made with VitePress, which transforms Markdown files to HTML and supports templating with Vue.js out-of-the-box. See the VitePress docs on "Using Vue in Markdown" for the specifics on Markdown interpolation.
Support for loading YAML, JSON and other data formats is provided by the Vite plugin, vite-plugin-content
.
See the documentation pages for VitePress and Vue.js for further information on how to customize the layout and configuration.
For now, the default VitePress theme is being overridden by ./theme/index.js
, but the default can be re-enabled or extended if we wish. See the VitePress docs on "Theming" for more information.