Skip to content

Commit b28e06f

Browse files
committed
Create docusaurus project
Change homepage and added docker compose install steps. Still a wip.
1 parent 3af9177 commit b28e06f

32 files changed

Lines changed: 13500 additions & 0 deletions

.eslintignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ node_modules
77
.env.*
88
!.env.example
99

10+
/doc
11+
1012
# Ignore files for PNPM, NPM and YARN
1113
pnpm-lock.yaml
1214
package-lock.json

doc/.gitignore

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Dependencies
2+
/node_modules
3+
4+
# Production
5+
/build
6+
7+
# Generated files
8+
.docusaurus
9+
.cache-loader
10+
11+
# Misc
12+
.DS_Store
13+
.env.local
14+
.env.development.local
15+
.env.test.local
16+
.env.production.local
17+
18+
npm-debug.log*
19+
yarn-debug.log*
20+
yarn-error.log*

doc/README.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# Website
2+
3+
This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
4+
5+
### Installation
6+
7+
```
8+
$ yarn
9+
```
10+
11+
### Local Development
12+
13+
```
14+
$ yarn start
15+
```
16+
17+
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
18+
19+
### Build
20+
21+
```
22+
$ yarn build
23+
```
24+
25+
This command generates static content into the `build` directory and can be served using any static contents hosting service.
26+
27+
### Deployment
28+
29+
Using SSH:
30+
31+
```
32+
$ USE_SSH=true yarn deploy
33+
```
34+
35+
Not using SSH:
36+
37+
```
38+
$ GIT_USER=<Your GitHub username> yarn deploy
39+
```
40+
41+
If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.

doc/babel.config.js

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
module.exports = {
2+
presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
3+
};
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"label": "Installation",
3+
"position": 2,
4+
"link": {
5+
"type": "generated-index",
6+
"description": "Choose how you would like to install Watcharr."
7+
}
8+
}
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
5+
# Docker Compose
6+
7+
## Installing
8+
9+
Installing Watcharr with a docker compose file is easy. You can copy the example below to get started:
10+
11+
```yaml title="docker-compose.yml"
12+
version: "3"
13+
14+
services:
15+
watcharr:
16+
# The :latest tag is used for simplicity, it is recommended
17+
# to use an actual version, then when updating check the releases for changelogs.
18+
image: ghcr.io/sbondco/watcharr:latest
19+
container_name: watcharr
20+
ports:
21+
- 3080:3080
22+
volumes:
23+
# Contains all of watcharr data (database & cache)
24+
- ./data:/data
25+
```
26+
27+
You can now start `Watcharr` like so:
28+
29+
```bash
30+
docker compose up -d
31+
```
32+
33+
If you didn't change the ports in the example, the server will be available at [http://localhost:3080/](http://localhost:3080/).
34+
35+
## Updating
36+
37+
:::danger Take care
38+
39+
We try taking care as to not release breaking changes, however it is still recommended that
40+
you lookover changelogs before updating!
41+
42+
Breaking changes are marked at the top of releases: https://github.com/sbondCo/Watcharr/releases
43+
44+
:::
45+
46+
Updating your server can be done in two steps:
47+
48+
1. Update the `image` version in your `docker-compose.yml` file.
49+
Skip this step if you are using the `latest` tag.
50+
51+
```yaml
52+
# eg. update v1.19.0 to v1.20.0 (or whatever version you are updating to)
53+
image: ghcr.io/sbondco/watcharr:v1.19.0
54+
```
55+
56+
2. Pull the new changes and re-create your container:
57+
58+
```bash
59+
docker compose pull && docker compose down && docker compose up -d
60+
```
61+
62+
And that is it!
Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
sidebar_position: 10
3+
---
4+
5+
# From Source
6+
7+
## Installing
8+
9+
pull code n stuf
10+
11+
## Updating
12+
13+
finish this page later

doc/docs/intro.md

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
5+
# Tutorial Intro
6+
7+
Let's discover **Docusaurus in less than 5 minutes**.
8+
9+
## Getting Started
10+
11+
Get started by **creating a new site**.
12+
13+
Or **try Docusaurus immediately** with **[docusaurus.new](https://docusaurus.new)**.
14+
15+
### What you'll need
16+
17+
- [Node.js](https://nodejs.org/en/download/) version 16.14 or above:
18+
- When installing Node.js, you are recommended to check all checkboxes related to dependencies.
19+
20+
## Generate a new site
21+
22+
Generate a new Docusaurus site using the **classic template**.
23+
24+
The classic template will automatically be added to your project after you run the command:
25+
26+
```bash
27+
npm init docusaurus@latest my-website classic
28+
```
29+
30+
You can type this command into Command Prompt, Powershell, Terminal, or any other integrated terminal of your code editor.
31+
32+
The command also installs all necessary dependencies you need to run Docusaurus.
33+
34+
## Start your site
35+
36+
Run the development server:
37+
38+
```bash
39+
cd my-website
40+
npm run start
41+
```
42+
43+
The `cd` command changes the directory you're working with. In order to work with your newly created Docusaurus site, you'll need to navigate the terminal there.
44+
45+
The `npm run start` command builds your website locally and serves it through a development server, ready for you to view at http://localhost:3000/.
46+
47+
Open `docs/intro.md` (this page) and edit some lines: the site **reloads automatically** and displays your changes.
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"label": "Tutorial - Extras",
3+
"position": 3,
4+
"link": {
5+
"type": "generated-index"
6+
}
7+
}
24.8 KB
Loading

0 commit comments

Comments
 (0)