docs/README.md

51 lines
1.4 KiB
Markdown
Raw Normal View History

2023-03-20 03:14:15 +00:00
# Tube Archivist Documentation
2023-03-23 10:24:11 +00:00
## [docs.tubearchivist.com](https://docs.tubearchivist.com/)
2023-03-20 03:35:43 +00:00
2023-03-23 10:24:11 +00:00
This is the git repo of the official documentation for Tube Archivist - Your self hosted YouTube media server.
Additional links:
- The Project: [tubearchivist/tubearchivist](https://github.com/tubearchivist/tubearchivist)
- The Website: [tubearchivist.com](https://www.tubearchivist.com/)
- The Discord: [tubearchivist.com/discord](https://www.tubearchivist.com/discord)
## Make Changes
Please help improve these documentations. To make changes, fork this repo and make your changes. When you are ready, open a Pull Request. When merged, this will rebuild the live documentations within a few seconds.
2023-03-20 03:35:43 +00:00
## 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:
```
pip3 install mkdocs mkdocs-material
2023-03-20 03:35:43 +00:00
```
From the AUR:
```
yay -S mkdocs mkdocs-material
2023-03-20 03:35:43 +00:00
```
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/).
2023-03-21 02:13:00 +00:00
## Production environment
Build the Docker image:
```
docker build -t bbilly1/tubearchivist-docs .
```
Run the image:
```
docker run -p 80:80 bbilly1/tubearchivist-docs
```