|
2 | 2 |
|
3 | 3 | The user manual / documentation of OpenQDA |
4 | 4 |
|
5 | | -[](https://github.com/openqda/user-docs/actions/workflows/deploy.yml) |
| 5 | +[](https://github.com/openqda/user-docs/actions/workflows/deploy.yml) |
6 | 6 |  |
| 7 | +[](https://www.repostatus.org/#active) |
| 8 | + |
| 9 | +[](https://doi.org/10.5281/zenodo.11518216) |
| 10 | + |
7 | 11 |
|
8 | 12 | ## Website |
9 | 13 |
|
10 | 14 | The documentation is available under https://openqda.github.io/user-docs/ |
11 | 15 |
|
12 | | -It's built using [Docusaurus](https://docusaurus.io/), a modern static website generator. |
| 16 | +It's built using [vitepress](https://vitepress.dev), a modern static website generator for documentations. |
13 | 17 |
|
14 | 18 | ### Installation |
15 | 19 |
|
16 | 20 | ``` |
17 | | -$ yarn |
| 21 | +$ npm install |
18 | 22 | ``` |
19 | 23 |
|
20 | 24 | ### Local Development |
21 | 25 |
|
22 | 26 | ``` |
23 | | -$ yarn start |
| 27 | +$ npm run docs:dev |
24 | 28 | ``` |
25 | 29 |
|
26 | 30 | This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. |
27 | 31 |
|
28 | 32 | ### Build |
29 | 33 |
|
30 | 34 | ``` |
31 | | -$ yarn build |
| 35 | +$ npm run docs:build |
| 36 | +$ npm run docs:preview # optional to locally peview your build output |
32 | 37 | ``` |
33 | 38 |
|
34 | | -This command generates static content into the `build` directory and can be served using any static contents hosting service. |
35 | 39 |
|
36 | 40 | ### Deployment |
| 41 | +We use GitHub actions to automatically deploy updates to GitHub pages. |
| 42 | +Any merges to `main` will trigger a new build to be deployed. |
| 43 | +Pull requests, however will not trigger builds. |
37 | 44 |
|
38 | | -Using SSH: |
39 | | - |
40 | | -``` |
41 | | -$ USE_SSH=true yarn deploy |
42 | | -``` |
| 45 | +### Contributing |
| 46 | +We welcome your contribution and appreciate your support! |
| 47 | +Please read our contribution guidelines in order to make your contribution a success. |
43 | 48 |
|
44 | | -Not using SSH: |
45 | | - |
46 | | -``` |
47 | | -$ GIT_USER=<Your GitHub username> yarn deploy |
48 | | -``` |
| 49 | +## License |
49 | 50 |
|
50 | | -If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch. |
| 51 | +See [license file](./LICENSE) |
0 commit comments