VuePress documentation for RIS.
This repo contains all the documentation for RIS, and is built automatically from nothing more than markdown files in the tree.
The docs can be edited directly within Gitlab or by cloning the repo, changing the files locally and checking them back in.
Gitlab has a handy built in editor that understands most of the markdown that is in the markdown files. There are a few exceptions that are particular to VuePress (which this docs system is based on):
| Gitlab markdown | Vuepress markdown |
|---|---|
collapsible sections are rendered with <details><summary></summary><content></content></details> |
collapsible sections rendered same as gitlab OR by ::: details summaryText contentText ::: |
| Embedded vue components are ignored | Embedded vue components (like <RestRepl />) are recognized and rendered |
| cell | cell |
| cell | cell |
| cell | cell |
| cell | cell |
To use this with a different set of docs:
- Clone the repo
- Replace all subfolders of
/docs(EXCEPT/docs/.vuepress) with your own docs - run
npm installonce - run
npm run docs:devto test your docs - run
npm run docs:buildto build your (static) site - upload your build to any web server
For the most part, this should all just work out of the box, but there may be a few settings you will want to tweak in the /docs/.vuepress/config.js file. You will probably also want to replace references to RIS in a few places with your own.