docs/README.md

32 lines
849 B
Markdown

# docs
It is a documentation repository for the projects of [InsanusMokrassar](https://github.com/InsanusMokrassar).
## Running locally
### Install poetry
For the ease of dependencies management, this repository uses [Poetry](https://python-poetry.org), a Python project & dependencies manager.
In case you wish to interact with these docs locally, make sure to [install](https://python-poetry.org/docs/#installation) it first.
### Install dependencies
```bash
poetry install --no-root
```
### Build and run
In `Fleet` you may use [these configs](https://github.com/InsanusMokrassar/docs/blob/master/.fleet/run.json) to work with the repo.
To build or run it in vanilla terminal, use the following commands:
```bash
poetry run mkdocs build # Just build the site
```
```bash
poetry run mkdocs serve # Run a local server with the site
```