2024-06-04 12:03:43 +00:00
|
|
|
<h1> INCA Docs </h1>
|
2024-06-04 11:58:48 +00:00
|
|
|
|
2024-06-04 12:03:43 +00:00
|
|
|
<h2>Table of Contents</h2>
|
|
|
|
|
|
|
|
- [Introduction](#introduction)
|
|
|
|
- [Prerequisites](#prerequisites)
|
|
|
|
- [Website Preview](#website-preview)
|
2024-06-04 12:56:19 +00:00
|
|
|
- [Run with Make](#run-with-make)
|
2024-06-04 12:03:43 +00:00
|
|
|
- [License](#license)
|
|
|
|
- [References](#references)
|
2024-06-04 12:10:16 +00:00
|
|
|
- [Contribute](#contribute)
|
2024-06-04 12:03:43 +00:00
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
|
|
|
This repository contains the code to deploy the INCA Docs website, a project by [ThreeFold](https://threefold.io).
|
|
|
|
|
|
|
|
## Prerequisites
|
|
|
|
|
|
|
|
You need [npm](https://www.npmjs.com/) to run this website.
|
|
|
|
|
|
|
|
- Install `npm`
|
|
|
|
```
|
|
|
|
sudo apt update
|
|
|
|
sudo apt install nodejs
|
|
|
|
npm -v
|
|
|
|
```
|
|
|
|
|
|
|
|
## Website Preview
|
|
|
|
|
|
|
|
You can preview the website with a few lines.
|
|
|
|
|
|
|
|
```
|
2024-06-04 12:05:42 +00:00
|
|
|
git clone https://git.ourworld.tf/tfgrid/www_projectinca
|
2024-06-04 12:03:43 +00:00
|
|
|
cd inca_docs
|
|
|
|
npm install
|
|
|
|
npm run dev
|
|
|
|
```
|
|
|
|
|
|
|
|
For more information, read the original [AstroWind docs](./website_docs/README.md).
|
|
|
|
|
2024-06-04 12:56:19 +00:00
|
|
|
## Run with Make
|
|
|
|
|
|
|
|
To run the website locally with Make, simply run:
|
|
|
|
|
|
|
|
```
|
|
|
|
make run
|
|
|
|
```
|
|
|
|
|
2024-06-04 12:03:43 +00:00
|
|
|
## License
|
|
|
|
|
|
|
|
**INCA Docs** is licensed under the Apache 2.0 license — see the [LICENSE](./LICENSE.md) file for details.
|
|
|
|
|
|
|
|
## References
|
|
|
|
|
|
|
|
This INCA Docs website is based on the amazing [AstroWind repo](https://github.com/onwidget/astrowind).
|
|
|
|
|
|
|
|
We changed the license from MIT to Apache 2.0 to suit this specific project.
|
2024-06-04 12:10:16 +00:00
|
|
|
|
|
|
|
## Contribute
|
|
|
|
|
|
|
|
To contribute to this repository:
|
|
|
|
|
|
|
|
- Make a new branch with `development_` as a prefix (e.g. `development_update`)
|
|
|
|
- Make changes locally on your code editor
|
|
|
|
- Push changes to the new branch
|
2024-06-04 12:11:34 +00:00
|
|
|
- Make a pull request to `development` branch
|
|
|
|
|
|
|
|
The code owners will merge `development` branch to `main` branch.
|