add dev environment instructions

This commit is contained in:
simon 2023-03-20 10:35:43 +07:00
parent 9e959795be
commit 1b6f4f4baf
No known key found for this signature in database
GPG Key ID: 2C15AA5E89985DD4

View File

@ -1,3 +1,29 @@
# Tube Archivist Documentation # Tube Archivist Documentation
This is a work in progress, porting the old wiki to a more flexible documentation framework. This is a work in progress, porting the old wiki to a more flexible documentation framework.
## Development Environment
To just make simple changes, edit the markdown files within *mkdocs/docs* direclty.
To setup a local development server:
Install mkdocs with pip:
```
pip install mkdocs
```
From the AUR:
```
yay -S mkdocs
```
More details: [User Guide](https://www.mkdocs.org/user-guide/installation/)
Run the server from the *mkdocs* folder with:
```
mkdocs serve
```
And the site - with live reload enabled - should be available on [localhost:8000](http://localhost:8000/).