www_projectinca_archive/README.md

70 lines
1.5 KiB
Markdown
Raw Normal View History

2024-06-06 19:07:00 +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
2024-06-06 19:07:00 +00:00
This repository contains the code to deploy the INCA Docs website, a project by [ThreeFold](https://threefold.io).
2024-06-04 12:03:43 +00:00
## 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.
```
git clone https://git.ourworld.tf/tfgrid/www_projectinca
2024-06-04 15:33:35 +00:00
cd www_projectinca
2024-06-04 12:03:43 +00:00
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
2024-06-06 19:07:00 +00:00
**INCA Docs** is licensed under the Apache 2.0 license — see the [LICENSE](./LICENSE.md) file for details.
2024-06-04 12:03:43 +00:00
## References
2024-06-06 19:07:00 +00:00
This INCA Docs website is based on the amazing [AstroWind repo](https://github.com/onwidget/astrowind).
2024-06-04 12:03:43 +00:00
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.